Keyboard shortcuts

Press ← or → to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

The window

Tip

TL;DR rega --gui opens rega in a window of its own: the same keys and panes, no kitty or Ghostty needed. With nothing to open it starts on a screen to open files, a folder, pasted paths or a recent one. Drop files on it, Ctrl+V paths, drag to pan.

rega --gui              # the start screen
rega --gui shots/       # the browser, in that folder
rega --gui render.exr   # the viewer

Everything in this guide works the same in the window, keys and panes alike. Pictures are always full resolution, playback too (P still caps it when a sequence can’t keep up).

Note

The window comes with the Nix package and with source builds. The static Linux binary from the install script is terminal-only. On Windows, rega.exe is always the window.

Start screen

  Open files…
  Open a folder…
  Browse ~/renders
  Tutorial

  Paste paths…
    comp.exr            ~/renders/v002                 ×
    comp.exr            ~/renders/v003                 ×
                        [ Open (2) ]

  Recent
  shot.####.exr         ~/renders/sq010            2 h ago
  plates/               ~                         3 days ago
  • Open files… and Open a folder… show the system’s dialogs.
  • Browse opens the browser where it was last left. q in the browser comes back here.
  • Tutorial renders the tutorial’s images (the first time) and starts its tour.
  • Paste paths…: Ctrl+V adds each pasted line to the list; a types one (Enter adds it). Paths from a file manager (file://…), quoted ones and ~ are fine; patterns like shot.####.exr open as sequences. Missing ones show red. Open (n) opens them together, as marks do in the browser: n / p step, t tiles.
  • Recent: a click puts an item in that list (again: out), Shift+click a range, a double click opens it on its own. x forgets one.

Keys

Start screen

KeyDoes
oopen images or movies (the system’s dialog)
fopen a folder
bbrowse: the file browser, where it was left
tthe tutorial: a tour on sample images
Ctrl+Vpaste paths, one a line: listed to open together
atype a path (Enter adds it, Esc done)
x Xremove the selected path / clear the list
1 … 9open a recent one again
click spacea recent one into the list (again: out)
Shift+click J Ka range of them into the list
double-clicka recent one: open it at once
j/k ↑/↓move (the pointer too)
Enteropen what is selected
xa recent one: forget it
q / Qquit

Window

KeyDoes
Ctrl+Oopen images or movies (the system’s dialog)
Ctrl+Shift+Oopen a folder
dropfiles or folders on the window: open them
q (browser)back to the start screen (Q quits)
Ctrl+Ccopy: the path (browser, image), the rows (2, 4)
Ctrl+Fsearch the keys (in ? too)
Ctrl+Vpaste: into what is typed, else paths to open
Ctrl+= / -bigger / smaller text
Ctrl+0text size back to the default
F11full screen
on macOS, ⌘ works as Ctrl here

Mouse

  • Drop files or folders anywhere on the window to open them.
  • Drag to pan: the right or middle button anywhere, the left one on a still or on tiles. The picture follows the pointer; tiles still rendering show as boxes.
  • Wheel over the image or tiles zooms by as much as you turn: smoothly on a touchpad.
  • Shift+click / Ctrl+click in the browser mark a range / one more.
  • Drag a file in the files pane to sort the list.
  • Click a selected row in the metadata pane again, or below the rows, to unselect.

Ctrl+C copies: the path in the browser and the viewer, the selected rows in the metadata and inspector panes. Ctrl+V pastes into what you type, else opens the paths. On macOS ⌘ works as Ctrl.

What it keeps

PathWhat
~/.local/state/rega/windowsize, text size, the browser’s last folder
~/.local/state/rega/recentthe start screen’s recent items

On Windows they’re in %LOCALAPPDATA%\rega.

First launch

The app isn’t notarized (macOS) or signed (Windows) yet, so the system asks once:

  • macOS: open it, then System Settings → Privacy & Security → Open Anyway.
  • Windows: SmartScreen’s More info → Run anyway.