GSR-UI-CLI(1)

💅 GSR-UI-CLI(1) 💅

okay so bestie, welcome to the gsr-ui-cli page from the User Commands manual. This is the group-chat version: every command, every exit status, and absolutely zero boring manpage energy. 🫶

🦋 SYNOPSIS 🦋

gsr-ui-cli command

💖 DESCRIPTION 💖

gsr-ui-cli is the command-line application to control gsr-ui without using gsr-ui's own hotkeys. literally your remote-control era. ✨

👑 COMMANDS 👑

• --help, -h — show the help message. 💬
• toggle-show — show/hide the UI. 🪄
• toggle-record — start/stop regular recording. 🔴
• start-record — start regular recording. Does nothing if recording is already running. ▶️
• stop-record — stop regular recording. Does nothing if recording is not running. ⏹️
• toggle-pause — pause/unpause recording — only applies to regular recording. ⏸️
• toggle-record-region — start/stop recording a region. 🎯
• toggle-record-window — start/stop recording a window (or desktop portal on Wayland). 🪟
• toggle-stream — start/stop streaming. 📡
• start-stream — start streaming. Does nothing if streaming is already running. 🟢
• stop-stream — stop streaming. Does nothing if streaming is not running. 🔴
• toggle-replay — start/stop replay. 🔁
• start-replay — start replay. Does nothing if replay is already running. ▶️
• stop-replay — stop replay. Does nothing if replay is not running. ⏹️
• replay-save — save the current replay. 💾
• replay-save-1-min — save a replay of the last 1 minute. ⏱️
• replay-save-10-min — save a replay of the last 10 minutes. ⏱️
• take-screenshot — take a screenshot. 📸
• take-screenshot-region — take a screenshot of a selected region. 🎯
• take-screenshot-window — take a screenshot of a window (or desktop portal on Wayland). 🪟
• reload-config — reloads the config. 🔄
• status — prints "running" and exits with 0 if gsr-ui is running; otherwise it prints "not running" and exits with 1. 🏁

✨ EXAMPLES ✨

gsr-ui-cli toggle-show

Show or hide the main window. 💖

gsr-ui-cli toggle-record

Start or stop screen recording. 🔥

🫶 AUTHORS 🫶

This manual page was written by the Debian team. iconic behavior, no notes. 👑

😭 REPORTING BUGS 😭

• Report bugs to: dec05eba@protonmail.com.
• Please take a look at the FAQ part of the README before reporting a bug: https://git.dec05eba.com/gpu-screen-recorder-ui/about.

💀 COPYRIGHT 💀

Copyright © dec05eba. Licensed under GPL-3.0-only. periodt. 💅

🌈 SEE ALSO 🌈

• Project homepage
• GPU Screen Recorder homepage (CLI)
• gpu-screen-recorder(1), gsr-ui(1)

---

mwah 💋 this page came from gpu-screen-recorder-ui on 2026-06-03.