# Webcams on Omarchy
USB webcams work on Omarchy 4.0.4. Built-in MIPI cameras behind Intel IPU6 or IPU7 are the hard part: what Omarchy installs, what breaks, and the fix order.
> **Short answer:** USB and UVC webcams work out of the box on Omarchy 4.0.4. Built-in MIPI cameras are where it goes wrong. Omarchy installs intel-ipu7-camera only when the ACPI id OVTI08F4 is present, so IPU6 laptops get nothing at all. Check the HAL plugin with ldd first, then the sensor's ACPI status, then the kernel bind lines in dmesg.
- Applies to Omarchy: 4.0.0 and later
- Status: info
- Last verified: 2026-09-16
- Canonical: https://omarchylinux.org/hardware/webcam/
_Unofficial community page. Not affiliated with 37signals or the Omacom Foundation. Omarchy is a registered trademark of 37signals LLC._

## Status on 4.0.4

Split webcams into two groups and the picture gets clear fast.

USB and UVC cameras are fine. They bind to `uvcvideo`, they get a real `/dev/video` node, and the screen recorder's picker lists them. Omarchy does nothing special for them and nothing special is needed.

Built-in MIPI cameras on recent Intel laptops are the problem. These sit behind an Intel Image Processing Unit (IPU6 or IPU7) and need a kernel bridge, a sensor driver, a proprietary camera HAL, and a relay daemon that fakes a normal `/dev/video` node so browsers can read it. Any one of those four can be missing or mismatched, and on Omarchy several of them regularly are. The component tracker counts 36 issues here, 25 of them still open, and the bulk are Intel MIPI cameras.

Apple hardware is a third case. T2 Macs get their camera through `linux-t2` and `uvcvideo`. Pre-T2 Macs with the Broadcom 1570 FaceTime HD part get nothing out of the box (#11373); the AUR `facetimehd` driver works there, and PR #11381 proposes an installer leaf for it but is still open. See [T2 Macs](/hardware/t2-mac/) and [Apple Silicon](/hardware/apple-silicon-asahi/).

Checked against the v4.0.4 source tree. On 3.x the same `ipu7-camera.sh` detection existed, so the shape of the problem has not changed across Quattro.

## What Omarchy does automatically

Less than you would guess. The entire automatic camera setup in v4.0.4 is `install/hardware/intel/ipu7-camera.sh`, run from `install/hardware/all.sh`:

```sh
if grep -q "OVTI08F4" /sys/bus/acpi/devices/*/hid 2>/dev/null; then
  omarchy-pkg-add intel-ipu7-camera
fi
```

That is it. One ACPI id, one package. `intel-ipu7-camera` also sits in `install/omarchy-other.packages` so the ISO carries it. The package itself brings the DKMS modules (`ipu7-drivers`, plus `vision-drivers` on kernels before 7.2 and, since 1.0.6, an `intel-cvs` module on 7.2 and later), the CamHAL plugin `/usr/lib/libcamhal/plugins/ipu75xa.so`, `camera-init.service`, `v4l2-relayd@ipu7.service`, a v4l2loopback node that usually lands at `/dev/video50`, a udev rule that hides the raw ISYS nodes, a WirePlumber drop-in that turns the libcamera monitor off, and a `systemd` system-sleep hook that restarts the camera on resume. The plugin is built for Panther Lake only; Lunar Lake's `ipu7x` plugin is not in the package (#12178).

There is no libcamera install path, no `pipewire-libcamera`, and no IPU6 leaf.

The rest of the webcam surface is capture tooling, not enablement:

- `omarchy-hw-webcam` returns true when `omarchy-capture-webcam-list` prints anything. The menu entry for recording with a webcam is gated on it, so if you have no camera the option simply does not appear.
- `omarchy-capture-webcam-list` runs `v4l2-ctl --list-devices` and keeps only nodes whose Device Caps advertise Video Capture. This is what stops IPU laptops offering their raw Bayer `/dev/video0` as a camera (#5722, shipped in 4.0.0).
- `omarchy-capture-screenrecording-with-webcam` picks the device, then hands off to the recorder.
- The overlay is an `mpv` window titled `WebcamOverlay`, positioned by rules in `default/hypr/apps/webcam-overlay.lua` and resized with `Super + Alt + [` and `]`. The manual covers it in [Screenshots & Recording](https://omarchy.org/manual/screenshots-recording/).

## Known problems

| Issue | Models | Status | Fixed in |
| --- | --- | --- | --- |
| [#10948](https://github.com/omacom/omarchy/issues/10948) kernel 7.2 routes the sensor through the CVS device, and the package's DKMS `intel_cvs` registers no V4L2 subdev to answer it, so `ov08x40` never reaches the media graph | Dell XPS 14 DA14260, XPS 16 DA16260 | closed | 4.0.4 (`intel-ipu7-camera` 1.0.6) |
| [#10837](https://github.com/omacom/omarchy/issues/10837) jsoncpp 1.9.8 soname bump leaves `ipu75xa.so` unable to load | any IPU7 laptop | open, package rebuilt | `intel-ipu7-camera` 1.0.5-2 and later (stable still shipped 1.0.5-1 on 2026-09-12; 1.0.6 carries the rebuild) |
| [#12178](https://github.com/omacom/omarchy/issues/12178) package is installed by detection but built for Panther Lake only, so the `ipu7x` plugin Lunar Lake needs does not exist | Dell Pro 13/14 Premium, XPS 13 9350, other Core Ultra 200V | open | not yet |
| [#9879](https://github.com/omacom/omarchy/issues/9879) IPU6 machines get no camera setup at all | Dell XPS 13 Plus 9315, Alder/Raptor/Meteor Lake laptops | open | not yet |
| [#7697](https://github.com/omacom/omarchy/issues/7697) the OVTI08F4 test also matches Meteor Lake IPU6 boards, installing the wrong HAL | HP Spectre x360 14 (Core Ultra 7 155H) | open | not yet |
| [#5676](https://github.com/omacom/omarchy/issues/5676) IPU6 on Raptor Lake needs a sensor driver patch plus libcamera and WirePlumber configuration nobody installs for you | Samsung Galaxy Book3 Ultra, Tiger Lake, Alder Lake, Raptor Lake | open | not yet |
| [#6000](https://github.com/omacom/omarchy/issues/6000) `OVTI08F4` reads ACPI status 0 because it is a disabled table slot; the live sensor is a Sony IMX471 at `TBE20A0` with no in-tree driver before kernel 7.3 | Lenovo ThinkPad X1 Carbon Gen 14 | open | not yet |
| [#7776](https://github.com/omacom/omarchy/issues/7776) same signature: `OVTI08F4` at status 0, `TBE20A0` enabled, and `intel-ipu7-camera` installed anyway with a black `/dev/video50` | Lenovo ThinkPad X1 Carbon Gen 14 | open | not yet |
| [#8641](https://github.com/omacom/omarchy/issues/8641) Windows Hello IR sensor (Himax HM1092) has no Linux driver anywhere | Dell XPS 14 DA14260 | open | not yet |
| [#10624](https://github.com/omacom/omarchy/issues/10624) sensor bind is lost on resume and `camera-init` cannot restore it | Dell XPS 16 DA16260 | open | not yet |
| [#6222](https://github.com/omacom/omarchy/issues/6222) sleep hook uses a fixed transient unit name, so suspend-then-hibernate skips the resume restart | IPU7 laptops | open | not yet |
| [#8843](https://github.com/omacom/omarchy/issues/8843) libcamera and `qcam` see the camera, Chromium never does | Microsoft Surface Pro | open | not yet |
| [#11850](https://github.com/omacom/omarchy/issues/11850) recording overlay is orphaned when the camera opens but sends no frames, and holds the device open | any machine whose camera opens without streaming | open | not yet |
| [#11373](https://github.com/omacom/omarchy/issues/11373) no driver path for the pre-T2 Broadcom 1570 FaceTime HD camera | MacBook Pro 2013 to 2015 | open | not yet |
| [#3883](https://github.com/omacom/omarchy/issues/3883) built-in webcam not detected alongside keyboard and resume problems | MacBook Pro 13-inch 2020 (T2) | open | not yet |

Two closures worth knowing about. #5722, the raw Bayer node in the picker, was fixed in 4.0.0. #6233, a dead camera on an Acer Nitro, was closed by DHH as out of Omarchy's reach because the same camera failed on Ubuntu too. That is the general rule: if it does not work on any distro, it is a kernel or vendor gap and Omarchy cannot patch around it.

## Fixes that work

Work through this in order. Most people stop at step three.

1. Confirm what you actually have. `omarchy-capture-webcam-list` prints only real capture devices. If it lists nothing, the camera never reached userspace. If it lists a node and the picture is still black, the node is a relay with nothing feeding it.
2. Identify the IPU generation, not the sensor. `lspci | grep -i multimedia` and `lsmod | grep intel_ipu`. If `intel_ipu6` is bound but `intel-ipu7-camera` is installed, you are in #7697 and the installed HAL is for the wrong chip.
3. Check the HAL plugin for a missing library. `ldd /usr/lib/libcamhal/plugins/ipu75xa.so | grep -i json`. If it says `libjsoncpp.so.26 => not found` you have #10837, and the fix is `intel-ipu7-camera` 1.0.5-2 or newer (1.0.6-2 is what #12178 shows on a 4.0.4 stable machine). disy-mk pointed out this reproduces with no camera hardware at all, and nathankramm's faster version is `gst-inspect-1.0 icamerasrc 2>&1 | grep 'CamHAL\[ERR\]'`, which names the missing library in about a second. Do this before blaming a kernel upgrade. On the XPS machines in #10837 the jsoncpp bump and a kernel bump landed in the same transaction, and people spent days downgrading the wrong one.
4. If you are on kernel 7.2.x with a Panther Lake XPS, update to 4.0.4 and make sure `intel-ipu7-camera` is 1.0.6 or newer. The CVS bridge fix landed via omarchy-pkgs #418 and [4.0.4](/releases/v4.0.4/) lists it as "Fix webcam issues on XPS systems in the 7.2.x kernel". If you had installed the community SVP7500 fix pack before that, 1.0.6 ships its own `intel_cvs` module under the same name and overrides yours (#12178).
5. Check whether firmware ever enabled the sensor: `cat /sys/bus/acpi/devices/OVTI08F4:00/status`. A `0` means that node is disabled at ACPI level and `ov08x40` will never bind, so the package Omarchy installed has nothing to drive. On the ThinkPad X1 Carbon Gen 14 (#6000, #7776) that is expected: the real camera is a Sony IMX471 at `TBE20A0`, which reads `15`, and its driver only reaches stock Arch kernels at 7.3. #6000 has a working interim route with `imx471-dkms-git` and a libcamera setup, and it keeps `intel-ipu7-camera` installed while retargeting its relay. No BIOS option flips this.
6. Look for the bind in the kernel log: `journalctl -k -b | grep -i 'bind ov08x40'`. Seeing `All sensor registration completed` means the kernel half is healthy and the problem is in the HAL or the relay. Not seeing it after a resume is #10624, and today a reboot is the only reliable recovery.
7. Browser sees nothing while `qcam` works. On the Surface Pro in #8843 the camera is a PipeWire node, and the Camera portal request from Chromium dies in `xdg-desktop-portal-gtk` with `Unhandled parent window type`, since `xdg-desktop-portal-hyprland` has no Camera portal of its own. Still open, no fix shipped.
8. A frozen black overlay left after a recording is #11850. `pkill -9 mpv` removes it and releases the device.

If your camera is IPU6, there is currently no supported path in Omarchy. Both #9879 and #5676 contain working community recipes, but they are libcamera packages, DKMS drivers, and user units you install yourself, and PR #7773, which would stop the wrong package being installed on Meteor Lake, is still open.

## Report it

Camera reports need more than the usual dump, because the failure can sit in any of four layers. Run `omarchy debug --no-sudo --print` for the system section, then add:

- The IPU PCI id from `lspci -nn | grep -i multimedia` and which of `intel_ipu6` or `intel_ipu7` is bound.
- Sensor ACPI id and status, for example `cat /sys/bus/acpi/devices/OVTI08F4:00/status`.
- `journalctl -k -b | grep -iE 'ov08x40|ipu|cvs'`, including whether the bind line appears.
- `media-ctl -p /dev/media0` showing whether a sensor entity exists.
- `ldd` output for the HAL plugin, plus the exact versions of `intel-ipu7-camera`, `jsoncpp` and your kernel.

Search the tracker for your sensor id before filing, since most of these threads already have your machine in them. Then add your model to [hardware submissions](/hardware/submit/). Details on `omarchy debug` are in [the command reference](/reference/commands/omarchy-debug/).

## Related

- [Webcam not detected](/fix/webcam-not-detected/)
- [Suspend will not resume](/fix/suspend-wont-resume-s2idle/) and [suspend and sleep](/hardware/suspend-sleep/)
- [Dell XPS 14 (2026)](/hardware/dell-xps-14-2026/), [ThinkPad X1 Carbon](/hardware/lenovo-thinkpad-x1-carbon/), [Microsoft Surface](/hardware/microsoft-surface/)
- [T2 Macs](/hardware/t2-mac/) and [Intel MacBook Pro](/hardware/apple-macbook-pro-intel/)
- [Release 4.0.4](/releases/v4.0.4/) and [what is still broken](/releases/still-broken/)

## Sources

- [install/hardware/intel/ipu7-camera.sh at v4.0.4](https://github.com/omacom/omarchy/blob/v4.0.4/install/hardware/intel/ipu7-camera.sh)
- [bin/omarchy-capture-webcam-list at v4.0.4](https://github.com/omacom/omarchy/blob/v4.0.4/bin/omarchy-capture-webcam-list)
- [Issue #10837: RC jsoncpp 1.9.8 soname bump breaks intel-ipu7-camera 1.0.5](https://github.com/omacom/omarchy/issues/10837)
- [Issue #10948: [Regression] linux-ptl 7.2.3: IPU7 / OV08X40 sensor missing from media graph on Dell XPS 14 DA14260](https://github.com/omacom/omarchy/issues/10948)
- [Issue #12178: Lunar Lake: intel-ipu7-camera is installed by detection but built for Panther Lake only](https://github.com/omacom/omarchy/issues/12178)
- [Issue #9879: IPU6 MIPI cameras (ov01a10 / OVTI01A0) get no setup](https://github.com/omacom/omarchy/issues/9879)
- [Issue #7697: ipu7-camera.sh misdetects Meteor Lake (IPU6) hardware as IPU7, breaking the webcam](https://github.com/omacom/omarchy/issues/7697)
- [Issue #6000: Camera (IPU7-PTL / OV08X40) on ThinkPad X1 Carbon Gen 14: ACPI status=0, sensor invisible to Linux](https://github.com/omacom/omarchy/issues/6000)
- [Issue #8641: XPS 14 (Panther Lake): Windows Hello IR camera (Himax HM1092) has no Linux driver](https://github.com/omacom/omarchy/issues/8641)
- [Issue #10624: IPU7 camera: ov08x40 sensor bind is lost on suspend/resume and camera-init can't restore it](https://github.com/omacom/omarchy/issues/10624)
- [Issue #8843: Browser cannot access built-in camera even when libcamera, pipewire-libcamera, and qcam all work](https://github.com/omacom/omarchy/issues/8843)
- [Issue #11850: screenrecording --with-webcam: overlay mpv is orphaned when the camera never delivers a frame](https://github.com/omacom/omarchy/issues/11850)
- [Issue #11373: No driver path for the pre-T2 FaceTime HD camera (Broadcom 1570)](https://github.com/omacom/omarchy/issues/11373)
- [omarchy-pkgs #418: Fix Intel IPU7 camera on Linux 7.2 by adopting the CVS V4L2 bridge](https://github.com/omacom/omarchy-pkgs/pull/418)
- [Omarchy manual: Screenshots & Recording](https://omarchy.org/manual/screenshots-recording/)