Synopsis #
Many USB webcams reach FreeBSD applications through webcamd. The USB device must attach, webcamd must recognize it, the cuse kernel module must be loaded, a /dev/video* node must be created, and the login must have access. A browser permission prompt is a later layer.
Test the camera with a local viewer before diagnosing a meeting site. Close the viewer before testing the browser because some devices or formats cannot be used concurrently.
Confirm USB attachment #
Connect the camera and list USB devices and recent kernel messages:
$ usbconfig list
$ dmesg | tail -100
For an external camera, compare output before and after attachment. For an internal laptop camera, check firmware privacy settings and any physical shutter. If the camera does not appear as a USB device, webcamd configuration cannot create it.
If another driver or process claims the device, record that attachment before changing anything.
Install the diagnostic tools #
Install webcamd and the small pwcview viewer:
# pkg install webcamd pwcview
Enable webcamd and arrange for cuse to load at startup:
# sysrc webcamd_enable=YES
# sysrc kld_list+=cuse
Load cuse for the current boot:
# kldload cuse
$ kldstat | grep cuse
Adding the same module name to kld_list more than once is unnecessary. Inspect the saved value with sysrc kld_list when a module already loads at boot.
Identify the camera through webcamd #
List the devices recognized by webcamd:
# webcamd -l
Use the exact name and serial information from this output for persistent selection. A USB bus and address such as ugen1.3 can change after reboot or after moving the camera to another port.
Set the documented webcamd_0_flags with a unique name and, where available, serial number. This schematic value must be replaced with the exact options shown by webcamd -l:
# sysrc webcamd_0_flags="-N Camera-name -S Camera-serial"
When the device has no useful serial number, the name may be the best available match. If several identical cameras are present without serial numbers, persistent selection requires additional operational care.
Grant the intended login access #
The package creates a webcamd group. Add the desktop login, substituting its real name:
# pw groupmod webcamd -m loginname
End the graphical login session and log in again, then confirm membership:
$ id
Do not replace the group policy with world-writable video devices. A camera is a privacy-sensitive input device.
Start and verify the service #
Restart webcamd and inspect the resulting nodes:
# service webcamd restart
# service webcamd status
$ ls -l /dev/video*
If no /dev/video* node appears, check:
cuseis loaded.webcamd -lstill reports the intended device.- The saved flags match its current name or serial.
- Service output and system logs contain no claim or format error.
- Another process has not claimed the device.
Use the USB device permission guide if the node exists but its owner and group do not match the package policy.
Test outside the browser #
Run the documented local viewer as the desktop login:
$ pwcview -f 30 -s vga
A local image establishes that USB attachment, webcamd, cuse, the video node, permissions, and one supported format work together. It does not prove that every resolution or browser capture format works.
Close pwcview, then open the browser and select the same camera. If the browser cannot see it, inspect:
- the browser’s operating-system device access;
- the browser’s saved camera choice;
- site-specific camera permission;
- whether another application still holds the device;
- browser terminal output.
The browser guide treats provider compatibility and protected capabilities as separate requirements.
When the local camera path is stable and the goal is event recording rather than conferencing, continue with Motion and webcamd .
Recheck after topology changes #
Moving an external camera to another USB port can change its bus address. Re-run webcamd -l after moving it, adding another identical camera, or changing a dock. Prefer a unique name and serial match over a transient -d ugen argument.
After a FreeBSD or webcamd update, test the local viewer before the next required meeting. Keep the webcam model, USB identifiers, webcamd package version, saved flags, and service output with any correction report.