Linux setup
Get your system ready.
Screenix detects missing dependencies on first launch. Use this guide for manual setup or troubleshooting.
X11 and Wayland supported
On Wayland, Screenix uses PipeWire and xdg-desktop-portal for screen capture. Choose your distribution below for the exact packages and troubleshooting steps.
X11
sudo apt update && sudo apt install ffmpeg xdotool x11-utilsWayland
sudo apt update && sudo apt install ffmpeg pipewire wireplumber xdg-desktop-portal xdg-desktop-portal-gnome grim gnome-screenshotPackages
| Package | Session | Purpose |
|---|---|---|
ffmpeg | Both | Video encoding and screen capture |
xdotool | X11 | Keyboard and mouse control |
x11-utils | X11 | Monitor detection (xrandr) |
pipewire | Wayland | Low-latency screen capture |
wireplumber | Wayland | PipeWire session manager |
xdg-desktop-portal | Wayland | Screen capture portal |
xdg-desktop-portal-gnome | Wayland | GNOME portal backend |
grim | Wayland | Wayland screenshot fallback |
gnome-screenshot | Wayland | GNOME screenshot fallback |
Troubleshooting
Black screen when recording (X11)
FFmpeg is likely a snap or flatpak build that lacks x11grab support. Install the apt version:
sudo snap remove ffmpeg; sudo apt install ffmpegVerify x11grab is available:
ffmpeg -hide_banner -devices 2>&1 | grep x11grabBlack or blank video (Wayland)
Two likely causes:
- Missing packages: install the Wayland stack and log out/in so the portal starts.
- GNOME extension not active: the cursor bridge extension only loads at login. Log out and back in once after install.
sudo apt install pipewire wireplumber xdg-desktop-portal xdg-desktop-portal-gnome grim gnome-screenshotScreen capture prompt not appearing (Wayland)
xdg-desktop-portal may not be running. Install, log out/in, then verify:
systemctl --user is-active xdg-desktop-portalShould output active.
Still having issues?
Include the output of ffmpeg -version and echo $XDG_SESSION_TYPE when contacting support.