Controls

Hotkeys

While upscaling a window, you can use hotkeys to change the behavior of the upscaler, to take a screenshot or to exit.

Shortcut	Action
`Alt`+`Shift`+`S`	Pause / resume upscaling
`Alt`+`Shift`+`Escape`	Exit the upscaler
`Alt`+`Shift`+`P`	Take a lossless screenshot (directly from the SRCNN output)
`Alt`+`Shift`+`M`	Switch to the next upscaling model
`Alt`+`Shift`+`G`	Cycle output geometry (fit, stretch, cover)
`Alt`+`Shift`+`+` / `-`	Zoom in / zoom out
`Alt`+`Shift`+`↑` / `↓` / `←` / `→`	Pan the upscaled content
`Alt`+`Shift`+`R`	Restore output geometry, zoom and pan to their initial values

Screenshots

By default, screenshots are saved to your Pictures directory under Screenshots/, using the timestamp template Screenshot_{timestamp:%Y%m%d_%H%M%S}.png.

You can change the location and template filename used:

In the GUI, through the Extras tab.
Using CLI options --screenshot-dir and --screenshot-filename.
Changing them in the YAML configuration file (screenshot_dir and screenshot_filename).

For the filename, there are several placeholders that the upscaler automatically handle:

Placeholder	Description
`{timestamp}`	Capture time (supports `strftime` formats)
`{title}`	Current window title
`{profile}`	Active profile name (or window title, if no profile matched)
`{model}`	Active upscaling model
`{width}`	Upscaled image width in pixels
`{height}`	Upscaled image height in pixels

Example: {model}/{timestamp:%H-%M-%S}.png saves to fast/14-30-22.png.

Customizing hotkeys

Hotkeys can be modified in the configuration file (~/.config/linux-rt-upscaler/config.yaml) under the hotkeys key.

By default, they are defined like this:

hotkeys:
  toggle_scaling: "Alt+Shift+S"
  exit_app: "Alt+Shift+Escape"
  screenshot: "Alt+Shift+P"
  cycle_model: "Alt+Shift+M"
  cycle_geometry: "Alt+Shift+G"
  restore_view: "Alt+Shift+R"
  zoom_in: "Alt+Shift+Plus"
  zoom_out: "Alt+Shift+Minus"
  offset_up: "Alt+Shift+Up"
  offset_down: "Alt+Shift+Down"
  offset_left: "Alt+Shift+Left"
  offset_right: "Alt+Shift+Right"

To modify them, keep in mind this:

Supported modifiers are Ctrl, Alt, Shift, Super (Windows key).
Key names are case-insensitive and follow common X11 keysyms names (for example A, Space, Return, Escape, Left, Right, Up, Down, Plus, Minus).

If using embedded API

If you are embedding the upscaler in a Python application, you may want to disable or modify these hotkeys to avoid conflicts with your own shortcuts. To disable them, set enable_hotkeys=False when creating the UpscalerSession.