Skip to content
KINJA
Linux terminal with code on a dark screen
Productivity & Life

Screen Recording in Linux: The Complete Guide

OBS Studio with PipeWire screen capture is the best screen recording tool for Linux in 2026. For quick recordings, GNOME's built-in shortcut works too.

Alex ChenAlex Chen·10 min read
||10 min read

OBS Studio with PipeWire screen capture is the best screen recording tool for Linux in 2026. For quick recordings without installing anything extra, GNOME's built-in Ctrl+Shift+Alt+R shortcut handles simple screencasts on GNOME 45 and newer desktops.

Key Takeaway

Wayland is now the default display server on most major Linux distributions, and old X11 screen capture methods no longer work. OBS Studio with PipeWire screen capture is the most reliable, full-featured recording option for Wayland in 2026.

Why Did Screen Recording on Linux Get So Complicated?

If you last tried recording your Linux desktop a few years ago and are coming back to it now, you are going to hit a wall. The wall is called Wayland.

Wayland replaced X11 as the default display server on Ubuntu 24.04 LTS, Fedora 40, and most other current distributions. This was the right move for security and performance: Wayland prevents applications from silently reading other windows' contents, which is why keyloggers and screen scrapers had such an easy time on X11. But that same security model completely broke the old approach to screen recording. On X11, any application could grab raw pixels from the display buffer with a simple API call. On Wayland, applications must request screen access through the XDG Desktop Portal, and the user must explicitly approve through a permission dialog.

The practical fallout: SimpleScreenRecorder does not work on Wayland. Old ffmpeg x11grab commands produce errors. Screen recording scripts you copied from Stack Overflow in 2019 give you a black rectangle. If your distribution defaults to Wayland (check by running echo $XDG_SESSION_TYPE in a terminal), you need tools built for the new architecture.

Here is every tool that works on Linux in 2026, ranked by how strongly I recommend each one.

How Do You Record Your Screen with OBS Studio on Wayland?

OBS Studio is the right answer for the vast majority of Linux users who need screen recording. It is free, open-source, handles both local recording and live streaming, and its Wayland support through PipeWire has matured into something genuinely solid. The current stable release in early 2026 is OBS 31.x.

Installation

Ubuntu/Debian: sudo apt install obs-studio pulls the distribution package. For the latest version (often several releases ahead of what apt offers), install the Flatpak from Flathub instead: flatpak install flathub com.obsproject.Studio.

Fedora: sudo dnf install obs-studio. Fedora's repositories typically carry a recent build, so the distro package is fine here.

Arch: sudo pacman -S obs-studio. Arch users get the latest stable release as usual.

Wayland Screen Capture Setup

This is where most people get stuck. When you open OBS on Wayland for the first time, your instinct might be to add a "Screen Capture (XSHM)" source from the source list. Do not do that. XSHM is the X11 capture method and it will produce nothing but a black rectangle on a Wayland session.

Click the "+" button under Sources and select "Screen Capture (PipeWire)". A system dialog from the XDG Desktop Portal will appear, showing your available screens and individual windows. Select what you want to capture and click "Share." OBS now has portal-granted permission to record that screen. The dialog remembers your choice, so you only need to approve once per source.

If "Screen Capture (PipeWire)" does not appear as an option, your system is missing the portal backend package for your desktop environment. On GNOME, install xdg-desktop-portal-gnome. On KDE Plasma, install xdg-desktop-portal-kde. On wlroots-based compositors like Sway or Hyprland, install xdg-desktop-portal-wlr. Restart OBS after installing the package.

Audio Capture with PipeWire

PipeWire has replaced PulseAudio as the default audio server on most current distributions, and OBS handles PipeWire audio natively. Add an "Audio Output Capture (PipeWire)" source to record system sounds (game audio, browser playback, music). Add an "Audio Input Capture (PipeWire)" source for your microphone.

If you need to capture audio from a specific application while excluding everything else (record game audio but not your Discord call, for example), PipeWire's routing architecture makes this possible. Helvum is a graphical PipeWire patchbay that lets you visually connect and disconnect audio streams between applications and OBS. Install it with flatpak install flathub org.pipewire.Helvum. If you work with downloading and converting video files as part of the same workflow, tools like yt-dlp and ffmpeg pair naturally with OBS for a complete media pipeline.

Recommended Recording Settings

Navigate to Settings, then Output, switch Output Mode to "Advanced," and configure the Recording tab:

Container format: MKV. This is not optional. If OBS crashes, your system freezes, or you lose power during a recording, an MKV file remains playable up to the last successfully written frame. An MP4 file in the same scenario is completely corrupted, zero bytes recoverable, a total loss. Always record to MKV. After your recording finishes cleanly, use File > Remux Recordings in OBS to convert to MP4 in seconds with no quality degradation.

Encoder: For AMD GPUs, select "FFMPEG VAAPI" (hardware-accelerated encoding that offloads compression to your GPU). For NVIDIA, select "NVENC." For Intel integrated graphics, look for "QSV." All three options free your CPU for whatever you are recording. If none of the hardware options appear, "x264" (software encoding using your CPU) is the reliable fallback that works on any system.

Resolution: Match your monitor resolution for full-quality captures. If you are recording a 4K display and want smaller files, scale the output down to 1920x1080.

Bitrate: For 1080p at 30 fps, 6,000 to 10,000 Kbps produces good results. For 1080p at 60 fps, use 10,000 to 20,000 Kbps. For 4K, go with 20,000 to 40,000 Kbps. If you are using x264 with CRF mode (constant rate factor), a CRF between 18 and 23 gives excellent visual quality with reasonable file sizes.

Does GNOME Have a Built-In Screen Recorder?

Yes, and for quick captures it handles the job without installing a single additional package. If you run GNOME 45 or later (Ubuntu 24.04+, Fedora 40+, and similar), you get two options out of the box.

The keyboard shortcut: Press Ctrl+Shift+Alt+R to start recording immediately. A red dot appears in your system tray as confirmation. Press the same key combination again to stop. The file saves as a WebM video to your Videos folder. By default, recordings cap out at 30 seconds. To remove the limit, run gsettings set org.gnome.settings-daemon.plugins.media-keys max-screencast-length 0 in a terminal (setting the value to 0 means unlimited duration).

The Screenshot tool: Press Print Screen or search "Screenshot" in the activities launcher. In GNOME 46 and later, this tool supports both screenshots and screen recordings. You can select a specific region, a specific window, or the entire screen before clicking the record button. Output is WebM format.

The limitation that matters: GNOME's built-in recorder does not capture audio by default. No microphone input, no system sounds, nothing. If your recording needs any audio at all (voiceover narration, application sounds, game audio), you need OBS or another third-party tool. For silent UI demos, quick screencasts, and bug reproduction videos, GNOME's built-in option does the job perfectly.

Does SimpleScreenRecorder Still Work in 2026?

On X11: yes, and it remains one of the most straightforward recording tools available. On Wayland: no, with no plans to add support.

If you are still running an X11 session (check with echo $XDG_SESSION_TYPE), SimpleScreenRecorder offers a lightweight, wizard-style interface that walks you through screen area selection, audio source configuration, and codec choices without requiring you to already know what "CRF" or "PipeWire" means. Install it with sudo apt install simplescreenrecorder on Ubuntu and Debian. It handles recording tutorials, presentations, and demos on X11 with minimal fuss.

The writing is on the wall, though. X11 is in maintenance mode. Every major distribution has defaulted to Wayland or is in the process of switching. SimpleScreenRecorder's developer has confirmed that Wayland support is not on the roadmap because the architectural differences between X11 and Wayland screen access are too fundamental for a retrofit. If you depend on SimpleScreenRecorder today, start familiarizing yourself with OBS before your next OS upgrade flips you to Wayland.

How Do You Record the Screen from the Terminal with FFmpeg?

For users who prefer the command line or need to record in minimal, headless-adjacent environments, direct terminal-based recording is possible on both display servers. The commands are completely different depending on whether you are running X11 or Wayland.

X11 (ffmpeg direct capture)

ffmpeg -f x11grab -framerate 30 -video_size 1920x1080 -i :0.0 -c:v libx264 -preset ultrafast -crf 18 output.mkv

Here is what each piece does: -f x11grab tells ffmpeg to capture from the X11 display server. -framerate 30 sets the capture to 30 frames per second. -video_size 1920x1080 defines the capture area. -i :0.0 specifies which X display to capture (almost always :0.0 unless you are running multiple X servers). -preset ultrafast minimizes encoding latency at the cost of larger files. -crf 18 sets quality (lower numbers mean higher quality, 18 is visually near-lossless). Press Ctrl+C to stop recording. To add microphone audio, insert -f pulse -i default before the output filename.

Wayland (wf-recorder for wlroots compositors)

If you run Sway, Hyprland, or another wlroots-based Wayland compositor:

wf-recorder -f output.mp4

That is the entire command. wf-recorder captures through the wlroots screen capture protocol natively. Add -a to include audio. Add -g "$(slurp)" to interactively select a screen region with your mouse (requires the slurp utility installed). Install wf-recorder with sudo apt install wf-recorder or your distribution's equivalent package manager command.

On GNOME and KDE Wayland sessions, wf-recorder will not work because those desktop environments do not implement the wlroots capture protocol. For scripted or terminal-based recording on GNOME Wayland, the Flatpak application Kooha (flatpak install flathub io.github.seadve.Kooha) provides a simpler recording interface that works through the portal system. For broader media work from the terminal, tools like yt-dlp (which we cover in our SoundCloud downloading guide) share a similar command-line-first workflow.

Is Kazam Still Worth Using?

Kazam was a popular lightweight recorder among Ubuntu users from roughly 2015 to 2020. As of 2026, the project has not received a meaningful code update in years. It does not support Wayland. The GTK3 interface feels noticeably dated next to modern GNOME applications. If Kazam still runs on your X11 setup, there is no urgent reason to remove it. But I would not recommend installing it fresh in 2026 when OBS Studio and GNOME's built-in tools cover the same ground with active maintenance and Wayland compatibility.

What Can KDE Plasma Users Record with Spectacle?

KDE Plasma 6 (the default desktop on Kubuntu 24.04, Fedora KDE 40+, and similar distributions) includes screen recording capabilities built into Spectacle, KDE's screenshot and capture utility. Open Spectacle, navigate to the "Record Screen" tab, choose your capture area (full screen, specific window, or drawn rectangle), and start recording. Spectacle uses PipeWire for Wayland capture and supports recording audio from both your microphone and system output simultaneously.

The quality controls are more limited than what OBS provides. You get resolution and framerate options, but not granular encoder configuration, bitrate targeting, or output format selection. For KDE users who need a quick, integrated recording without installing additional packages, Spectacle does the job well. For anything requiring multi-source composition, scene switching, or specific encoder settings, you still want OBS.

How Do You Fix Common Linux Screen Recording Problems?

Black screen when recording on Wayland

You are using an X11 capture source on a Wayland session. In OBS, delete the "Screen Capture (XSHM)" source and add "Screen Capture (PipeWire)" instead. Verify that the correct portal backend is installed for your desktop: xdg-desktop-portal-gnome for GNOME, xdg-desktop-portal-kde for KDE, xdg-desktop-portal-wlr for wlroots compositors like Sway and Hyprland. Restart OBS after installing any missing portal packages.

No audio in the recording

Confirm that you have added an audio source in OBS (Audio Output Capture for system sounds, Audio Input Capture for your microphone). On distributions running PipeWire, use the PipeWire-specific variants of these sources. Run systemctl --user status pipewire to verify PipeWire is active. If you are using GNOME's built-in Ctrl+Shift+Alt+R recorder and wondering where the audio went, that is expected: GNOME's recorder does not capture audio by design.

Recording stutters or drops frames

Switch from software encoding (x264) to hardware encoding (VAAPI for AMD, NVENC for NVIDIA, QSV for Intel). Hardware encoding shifts the compression work to your GPU, freeing CPU cycles for whatever application you are recording. If hardware encoding is not available on your system, reduce your output resolution or lower the framerate from 60 to 30 fps. Also verify your storage can keep up: recording to a spinning hard drive under heavy disk I/O can cause frame drops that an NVMe SSD eliminates entirely.

Recording file is corrupted and will not play

You recorded to MP4 format and the recording ended abnormally (crash, power loss, kill signal). MP4 writes its file index at the very end of the recording process, so any interruption renders the entire file unplayable. The permanent fix: always record to MKV, which writes the index continuously. After a clean recording completes, use OBS's File > Remux Recordings to convert the MKV to MP4 in seconds with zero quality loss.

Frequently Asked Questions

What is the best screen recorder for Linux in 2026?

OBS Studio with PipeWire screen capture is the best overall option. It works on both Wayland and X11, handles audio capture natively, provides extensive encoder and quality settings, and costs nothing. For quick, no-install recordings on GNOME 45 or later, the built-in Ctrl+Shift+Alt+R keyboard shortcut handles basic screencasts.

Can you record your screen on Wayland in Linux?

Yes. OBS Studio's PipeWire capture, GNOME's built-in recorder, KDE Spectacle, and wf-recorder all support Wayland screen recording in 2026. The key is using PipeWire-based capture through the XDG Desktop Portal system rather than the old X11 screen grab methods, which produce a black screen on Wayland.

How do you capture system audio in a Linux screen recording?

Use OBS Studio with an "Audio Output Capture (PipeWire)" source. PipeWire, the default audio server on most 2026 Linux distributions, allows OBS to record system audio directly. For per-application audio routing (recording one app while muting another), install Helvum, a graphical PipeWire patchbay.

Does SimpleScreenRecorder work on Wayland?

No. SimpleScreenRecorder relies on X11-specific screen capture methods and has no Wayland support. The developer has confirmed that Wayland support is not planned due to fundamental architectural differences. Use OBS Studio, GNOME's built-in recorder, KDE Spectacle, or wf-recorder on Wayland instead.

Should you record to MP4 or MKV format on Linux?

Always record to MKV. If your recording is interrupted by a crash or power loss, an MKV file remains playable up to the last written frame. An MP4 file in the same scenario is completely unrecoverable. Record in MKV, then use OBS's built-in remux tool (File > Remux Recordings) to convert to MP4 when you need to share the file.

Topics

Alex Chen

Written by

Alex Chen

Technology journalist who has spent over a decade covering AI, cybersecurity, and software development. Former contributor to major tech publications. Writes about the tools, systems, and policies shaping the technology landscape, from machine learning breakthroughs to defense applications of emerging tech.

Continue Reading in Productivity & Life

The Kinja Brief

Get the stories that matter, delivered daily.