---
name: "gsr-ui-cli"
section: "1"
platform: "linux"
package: "gpu-screen-recorder-ui"
version: "1.15.0-1"
release: "Arch Linux 2026-11-01"
platforms: ["linux"]
url: "https://new.carta.tech/gsr-ui-cli"
---

# gsr-ui-cli(1)

command-line interface for gsr-ui

## NAME

gsr-ui-cli - command-line interface for gsr-ui

## 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.

## COMMANDS

- **--help, -h**

  Show 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 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.

## REPORTING BUGS

Report bugs to: dec05eba@protonmail.com ⟨mailto: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.

## SEE ALSO

Project homepage ⟨https://git.dec05eba.com/gpu-screen-recorder-ui⟩\
 GPU Screen Recorder homepage (CLI) ⟨https://git.dec05eba.com/gpu-screen-recorder⟩\
 [**gpu-screen-recorder**(1)](/gpu-screen-recorder/1.md), [**gsr-ui**(1)](/gsr-ui/1.md)