sodcalculator

10 Tech How-To

Setup Motion Detection Webcam Ubuntu

Guide 10-48408 · Updated · Step by step

To set up motion detection with a webcam on Ubuntu, you install the Motion software, configure its configuration file to point to your webcam, and start the service. This guide walks you through the entire process, from installing the necessary packages to tuning sensitivity and viewing the captured footage.

What is Motion and How Does It Work?

Motion is a free, open-source program that monitors video signals from cameras and detects when something changes in the frame. It works by comparing consecutive frames from your webcam. When a certain number of pixels differ beyond a set threshold, it triggers an event—typically saving a snapshot or recording a video clip. It can also send notifications or run custom commands. Motion is highly configurable and runs as a daemon, making it ideal for a dedicated security or monitoring setup on a Linux machine.

Prerequisites and Choosing Your Webcam

Before you start, ensure your webcam is recognized by Ubuntu. Most USB webcams use the UVC (USB Video Class) standard and work out of the box. Connect your webcam and run the following command to verify it’s detected:

lsusb

Look for a line containing “UVC” or the camera’s brand. You can also check the video device node with:

ls /dev/video*

Typically, the first camera is /dev/video0. If you have multiple cameras, they’ll appear as video0, video1, etc. For motion detection, any UVC-compatible webcam will work, but a camera that supports fixed focus and manual exposure will give more consistent results than one with auto-exposure, which can cause false triggers due to brightness changes.

Step-by-Step Installation and Configuration

Here’s the full setup process on a current Ubuntu LTS release (22.04/24.04):

  1. Install Motion – Open a terminal and run:
    sudo apt update
    sudo apt install motion
  2. Edit the configuration file – The main config file is /etc/motion/motion.conf. You’ll need to edit it with sudo. Key settings to change:
    • daemon on – run in the background (optional, but typical for a service).
    • videodevice /dev/video0 – set to your camera’s device node.
    • width and height – set to your camera’s native resolution (e.g., 1280×720). Check with v4l2-ctl --list-formats-ext if unsure.
    • framerate – a value between 2 and 5 is fine for motion detection; higher uses more CPU.
    • target_dir – where to save images/videos (e.g., /home/youruser/motion). Make sure the directory exists and is writable by the motion user.
    • threshold – the number of changed pixels that triggers an event. Default is 1500; lower values are more sensitive.
    • movie_output on – to record video clips instead of just snapshots.
    • stream_port 8081 – enables the live webcam stream (optional).
  3. Start Motion – After saving your changes, start the service:
    sudo systemctl enable motion
    sudo systemctl start motion
  4. Test it – Move in front of the camera. You should see new files appear in your target directory. If you enabled the stream, open http://localhost:8081 in a browser to see the live view.

Common Problems and How to Fix Them

Here are the most frequent issues and their solutions:

  • No video or black screen – Check that the correct videodevice is set. Try /dev/video1 if video0 doesn’t work. Also, ensure the camera isn’t in use by another app (like Cheese).
  • Motion doesn’t start – Check the log file at /var/log/motion/motion.log. Often it’s a permission issue on the target directory. Run sudo chown -R motion:motion /path/to/target_dir.
  • False triggers from light changes – Increase the threshold value, or disable the camera’s auto-exposure if possible using v4l2-ctl -c exposure_auto=1 (manual mode).
  • CPU usage is high – Reduce the framerate and capture resolution. Motion detection doesn’t need 30 fps.
  • No network stream – Ensure stream_localhost on is set to off if you want to access it from other devices, and open the port in your firewall (if enabled).

Motion vs. Other Options (ZoneMinder, SecuritySpy)

Motion is a lightweight, single-camera solution. For more advanced needs, consider:

  • ZoneMinder – A full-featured surveillance system supporting multiple cameras, motion zones, and a web UI. It’s heavier on resources and has a steeper learning curve.
  • SecuritySpy – This is macOS-only, so not applicable on Ubuntu.
  • Frigate – An open-source NVR that uses AI object detection (via a Coral TPU or CPU) to reduce false positives. It’s more complex to set up but very powerful.

For a simple home webcam, Motion is the best balance of simplicity and functionality.

Costs and Hardware Considerations

The software is completely free. The main cost is the webcam itself. Any USB webcam works, but if you’re using it outdoors or for security, consider a camera with a longer cable or a PoE (Power over Ethernet) setup—though that requires a different approach (like using a Raspberry Pi with a camera module). For indoor use, a basic 720p or 1080p webcam is sufficient. Keep in mind that motion detection on a CPU uses power; a dedicated low-power device like a Raspberry Pi can run 24/7 more efficiently than a desktop PC.

Privacy and Security Considerations

If you’re setting up a webcam for motion detection, think about privacy:

  • Use a strong password if you enable the web stream. Motion supports basic authentication via stream_auth_method and stream_authentication.
  • Don’t expose the stream to the internet without a VPN or SSH tunnel. Instead, access it locally or through a secure reverse proxy.
  • Be aware of local laws regarding surveillance. In many places, recording video of public areas or without consent is restricted. Keep the camera pointed at your own property.
  • When you’re done, stop the service and disable the camera if you don’t want it recording.

Frequently Asked Questions

Can I use my laptop’s built-in webcam?

Yes, it works the same way. Just make sure it’s not being used by another application. You may need to set videodevice /dev/video0 (or video1, etc.).

How do I make motion detection more sensitive?

Lower the threshold value in motion.conf. For example, set it to 500 to trigger on smaller changes. Also, increase the framerate to catch faster motion, but be aware of CPU usage.

Can I get an email notification when motion is detected?

Yes. Motion can run an external command on an event. You can use a script that sends an email via sendmail or a service like IFTTT. The on_event_start directive in motion.conf is where you specify the command.

How do I record video continuously, not just on motion?

Set movie_output on and movie_max_motion to a high value, but that still only records when motion is detected. For continuous recording, you’d need to use a different tool like VLC or ffmpeg to record the stream, or set motion_detection off and use the timelapse feature, but that’s not true continuous video.

Why is my motion detection triggering constantly?

This is usually due to a high threshold (too sensitive) or a camera with auto-exposure that changes brightness. Try increasing the threshold, or set a static exposure using v4l2-ctl. Also, make sure there are no moving objects in the background (like a fan).

Can I use a wireless IP camera with Motion?

Yes, Motion supports network cameras via the netcam_url directive. You’ll need to know the camera’s RTSP or HTTP stream URL. This is a great way to add multiple cameras without USB cables.

Related

General steps for current mainstream versions; menus can differ by device and version. See the disclaimer or report an error.

More in this bed

The whole Tech How-To bed →