# camera-relay: a Linux virtual webcam with live picture adjustments

> The webcam relay from my XPS 14 guide was just on or off. Now it's camera-relay, a small Rust app with a tray icon, live colour sliders, cropping, clean-up plugins and a profile per app.

Guide · Published 2026-11-05 · Updated 2026-11-05  
Web page: https://blog.jacq.cc/guides/camera-relay-linux-virtual-webcam/

The relay from my [XPS 14 webcam guide](https://blog.jacq.cc/guides/xps-14-panther-lake-webcam-linux/) got the camera working, but it could only do one thing: turn on or off.
Changing the colour meant editing a YAML file and restarting it, and the picture was grainy in office light. So I turned it into an app: [camera-relay](https://github.com/rj-xy/camera-relay).

[Image: A drawing: a webcam with a glowing red eye, joined by a green cable to a settings window with colour bars, a crop box and three sliders, and a crossed-out on / off only tag]

:::note[Status, November 2026]
Version 0.1.0, released 5 November 2026. Built on my Dell XPS 14 with Kubuntu 26.04 and KDE Plasma 6.6. Open source, MIT licence.
:::

## What changed

It still does the same job underneath: it reads the real camera through libcamera, and offers a fixed 1280×720 picture to PipeWire as **Built-in Camera**. Everything the old relay had to work around is still in there.

| | Old relay | camera-relay |
| --- | --- | --- |
| On and off | KDE menu entry, `camera-relay toggle` | Tray icon (click), the settings window, or the same commands |
| Colour | Edit `ov08x40.yaml`, restart | Sliders: brightness, contrast, saturation, hue, gamma. Live, even mid-call |
| Framing | Whole picture only | Crop by dragging a box, 16:9, 4:3 or 1:1, flip and rotate |
| Grain | Nothing to do about it | **Clean up** plugin |
| Settings per app | No | Profiles: one per app or room |
| Start on login | No | Off, the app, or the app with the camera on |
| Cameras | The ov08x40 only | libcamera or any V4L2 webcam |
| Made of | A shell script and a systemd unit | One Rust binary (GStreamer, GTK4, a `ksni` tray icon) |

## What you need

| Part | Notes |
| --- | --- |
| Linux, x86_64, with PipeWire | Ubuntu 24.04 or newer and its flavours, Debian 13, Fedora 41, Arch, openSUSE Tumbleweed. Not ARM, and not Ubuntu 22.04 or Debian 12 (GTK is too old) |
| A camera | libcamera or V4L2. On the XPS 14, do Step 2 of the [old guide](https://blog.jacq.cc/guides/xps-14-panther-lake-webcam-linux/#step-2-the-cvs-driver-and-the-camera-packages) first, so the kernel finds the sensor |
| A tray (optional) | Built into KDE Plasma. On GNOME, the AppIndicator extension. Without one, use the settings window |

## Step 1: Install

```bash
curl -fsSL https://github.com/rj-xy/camera-relay/releases/latest/download/install.sh | bash
```

It puts `camera-relay` in `~/.local/bin` and adds **Camera Relay** to the app menu. It checks for the GTK and GStreamer packages it needs and offers to install the missing ones with `sudo`. Nothing else needs root.

If the old relay from the XPS guide is installed, the installer finds it and offers to remove its service and script. It leaves the WirePlumber rule, because the new app still needs it on the XPS.

Start it from the app menu, or run `camera-relay`. Then open a call or [webcamtests.com](https://webcamtests.com) and pick **Built-in Camera**.

## Step 2: On the XPS 14

The defaults are for this laptop: capture at 2560×1440 (the [binned mode crashes](https://blog.jacq.cc/guides/xps-14-panther-lake-webcam-linux/#step-3-why-pipewires-own-camera-crashes)) with the ov08x40 colour tuning. Two files from the old guide are still needed. If the old relay was installed, they're already in place. If not:

```bash
curl -fsSL --create-dirs -o ~/.config/camera-relay/ov08x40.yaml \
  https://blog.jacq.cc/xps-14-webcam/ov08x40.yaml
curl -fsSL --create-dirs -o ~/.config/wireplumber/wireplumber.conf.d/51-camera-relay.conf \
  https://blog.jacq.cc/xps-14-webcam/51-camera-relay.conf
systemctl --user restart wireplumber
```

The WirePlumber rule hides PipeWire's own libcamera camera (the one that crashes) and the 32 raw `ipu7` devices. Brave and Edge also still need their PipeWire camera option: [old guide, Step 6](https://blog.jacq.cc/guides/xps-14-panther-lake-webcam-linux/#step-6-get-the-browsers-to-use-it).

For any other camera, edit `~/.config/camera-relay/config.toml`, then quit and start the app again:

```toml
[camera]
source = "libcamera"     # or "v4l2" for a plain USB webcam
device = ""              # empty: the first camera; or a libcamera name, or /dev/video0 for v4l2
capture_width = 0        # 0: the camera picks its size
capture_height = 0
tuning_file = ""         # the default file is for the ov08x40 only
```

`source = "test"` shows a test pattern, so you can try the app without a camera. All the screenshots here are of that.

## Step 3: Fix the picture

**Settings…** in the tray menu, or `camera-relay settings`, opens the window. The switch at the top left turns the camera on or off, and the preview on the right shows what the call sees.

[Image: The camera-relay settings window: the Picture tab with sliders for brightness, contrast, saturation, hue and gamma on the left, and a live preview of a colour-bar test pattern on the right]

The **Picture** tab has brightness, contrast, saturation, hue and gamma. They change the picture straight away, with no restart and no flicker, so I can fix it in the middle of a call. **Reset** puts everything back to neutral.

The old `ov08x40.yaml` tuning still does the colour cast. The sliders go on top of it.

## Step 4: Crop

On the **Framing** tab, pick the shape (16:9, 4:3 or 1:1), click **Select area** and drag a box on the preview. Drag inside it to move it, or a corner to resize it.

[Image: The Framing tab: aspect ratio 16:9 (1280×720), Select area chosen, and a white crop box with corner handles over the test pattern, the outside dimmed]

[Image: The same window after the crop: the preview shows only the area inside the box, filling the frame]

The crop happens before the scaling, so a small area keeps its detail. **Whole picture** undoes it. The same tab flips and rotates the picture.

Each shape still gives one fixed size (1280×720, 960×720 or 720×720). Brave and Edge skip a camera that only lists size ranges, which was the big lesson from the old relay.

## Step 5: Clean up the grain

The **Plugins** tab has two built in:

- **Clean up**: takes the grain out of a dark picture. Parts that don't move are averaged over a few frames, and movement shows straight away
- **Soften**: a gentle blur on the brightness only, for smoother skin. Colour stays sharp

[Image: The Plugins tab: Clean up switched on with Strength at 0.50, Soften switched on with Amount at 0.60, and a note to add more in the plugins folder]

Turning a plugin on or off restarts the camera for about a second. The sliders don't.

A plugin is a folder in `~/.config/camera-relay/plugins/` with a `plugin.toml`: a GStreamer pipeline and the sliders to show for it. The repo has an example that makes the picture look like old film: [docs/plugins.md](https://github.com/rj-xy/camera-relay/blob/main/docs/plugins.md).

## Step 6: Profiles, tray and command line

A profile keeps its own picture, crop and plugins: one for Teams, one for the dim office, and so on. **+** next to the profile picker makes a new one as a copy of the current one.

The tray icon is a webcam with a grey eye when it's off, and a red eye when it's on. Left click turns it on or off. Right click has **Camera on**, **Profile ▸**, **Settings…** and **Quit**.

Everything works from the command line too, so it can go on a keyboard shortcut:

```bash
camera-relay toggle                  # on or off (starts the app if it isn't running)
camera-relay profile teams           # switch profile; a new name copies the current one
camera-relay set brightness 0.1      # one setting, live, and saved
camera-relay set plugins cleanup     # plugins, in order
camera-relay status                  # on or off, the profile and its settings
camera-relay autostart camera        # start on login with the camera on (off, app, camera)
```

Settings are plain TOML in `~/.config/camera-relay/`, saved on every change. Logs: `journalctl -t camera-relay -f`.

## Update and uninstall

```bash
camera-relay update     # the latest release, checked against its SHA-256; restart the app after
```

To remove it:

```bash
camera-relay autostart off
rm ~/.local/bin/camera-relay ~/.local/share/applications/camera-relay.desktop
rm -r ~/.config/camera-relay    # your settings and profiles, if you want them gone too
```

## Sources

- [camera-relay on GitHub](https://github.com/rj-xy/camera-relay): the code, the [architecture](https://github.com/rj-xy/camera-relay/blob/main/docs/architecture.md) and [why Rust](https://github.com/rj-xy/camera-relay/blob/main/docs/language-choice.md)
- [Release 0.1.0](https://github.com/rj-xy/camera-relay/releases/tag/v0.1.0)
- [The webcam on a Dell XPS 14 (Panther Lake) under Kubuntu 26.04](https://blog.jacq.cc/guides/xps-14-panther-lake-webcam-linux/): the bring-up and the first, on or off relay

## Change history

- 2026-11-05: First published.

Licence: CC BY 4.0 (https://creativecommons.org/licenses/by/4.0/). Credit "HomeLab Series (blog.jacq.cc)" with a link to https://blog.jacq.cc/guides/camera-relay-linux-virtual-webcam/. Code downloads: MIT. Details: https://blog.jacq.cc/licence/
