LinuxCommandLibrary

gpu-screen-recorder

Hardware-accelerated screen recorder

TLDR

Select a source using a desktop portal and record it

$ gpu-screen-recorder -w portal -o [path/to/video.mp4]
copy
Specify a specific video source
$ gpu-screen-recorder -w [screen|DP-1|HDMI-A1|...] -o [path/to/video.mp4]
copy
List video capture sources
$ gpu-screen-recorder --list-capture-options
copy
List audio capture sources
$ gpu-screen-recorder --list-audio-devices
copy
Record using the replay buffer
$ gpu-screen-recorder -w screen -r 30 -c mp4 -ro [path/to/directory] -o whatever
copy
Capture a video from the replay buffer
$ pkill -SIGUSR1 -f gpu-screen-recorder
copy
Run gpu-screen-recorder in the background
$ systemctl start --user gpu-screen-recorder
copy

SYNOPSIS

gpu-screen-recorder [options] -w source -o output

DESCRIPTION

gpu-screen-recorder is a hardware-accelerated screen recorder that uses GPU encoding (NVENC, VAAPI, or AMF) for minimal CPU impact. It is designed for recording gameplay and screen content with low performance overhead.
Key features include a replay buffer (recording the last N seconds like instant replay), support for both X11 and Wayland via portals, and efficient hardware encoding. The replay buffer can be triggered to save via SIGUSR1 signal. The tool supports multiple monitors, specific window capture, and simultaneous system audio and microphone recording.

PARAMETERS

-w SOURCE

Video source: screen, portal, or specific output name
-o FILE
Output file path
-r SECONDS
Replay buffer duration in seconds
-ro DIR
Replay output directory
-c CONTAINER
Container format: mp4, mkv, flv, etc.
-f FPS
Frame rate (default: 60)
-q QUALITY
Quality preset: ultra, high, medium, low
-a DEVICE
Audio device to record
--list-capture-options
List available video capture sources
--list-audio-devices
List available audio devices

CAVEATS

Requires compatible GPU with hardware encoding support (NVIDIA with NVENC, AMD with VAAPI/AMF, or Intel with VAAPI). Wayland support depends on desktop portal implementation. Some desktop environments may require additional configuration.

HISTORY

gpu-screen-recorder was created to provide an efficient, GPU-accelerated alternative to software-based screen recorders. It's particularly popular among Linux gamers for its low overhead and instant replay capabilities.

SEE ALSO

obs(1), ffmpeg(1), wf-recorder(1)

> TERMINAL_GEAR

Curated for the Linux community

Copied to clipboard

> TERMINAL_GEAR

Curated for the Linux community