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-utils

Wayland

sudo apt update && sudo apt install ffmpeg pipewire wireplumber xdg-desktop-portal xdg-desktop-portal-gnome grim gnome-screenshot

Packages

PackageSessionPurpose
ffmpegBothVideo encoding and screen capture
xdotoolX11Keyboard and mouse control
x11-utilsX11Monitor detection (xrandr)
pipewireWaylandLow-latency screen capture
wireplumberWaylandPipeWire session manager
xdg-desktop-portalWaylandScreen capture portal
xdg-desktop-portal-gnomeWaylandGNOME portal backend
grimWaylandWayland screenshot fallback
gnome-screenshotWaylandGNOME 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 ffmpeg

Verify x11grab is available:

ffmpeg -hide_banner -devices 2>&1 | grep x11grab

Black 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-screenshot

Screen capture prompt not appearing (Wayland)

xdg-desktop-portal may not be running. Install, log out/in, then verify:

systemctl --user is-active xdg-desktop-portal

Should output active.

Still having issues?

Include the output of ffmpeg -version and echo $XDG_SESSION_TYPE when contacting support.

Contact support →