The window
Tip
TL;DR
rega --guiopens 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.exeis 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.
qin 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;
atypes one (Enteradds it). Paths from a file manager (file://…), quoted ones and~are fine; patterns likeshot.####.exropen as sequences. Missing ones show red. Open (n) opens them together, as marks do in the browser:n/pstep,ttiles. - Recent: a click puts an item in that list (again: out), Shift+click a range,
a double click opens it on its own.
xforgets one.
Keys
Start screen
| Key | Does |
|---|---|
o | open images or movies (the system’s dialog) |
f | open a folder |
b | browse: the file browser, where it was left |
t | the tutorial: a tour on sample images |
Ctrl+V | paste paths, one a line: listed to open together |
a | type a path (Enter adds it, Esc done) |
x X | remove the selected path / clear the list |
1 … 9 | open a recent one again |
click space | a recent one into the list (again: out) |
Shift+click J K | a range of them into the list |
double-click | a recent one: open it at once |
j/k ↑/↓ | move (the pointer too) |
Enter | open what is selected |
x | a recent one: forget it |
q / Q | quit |
Window
| Key | Does |
|---|---|
Ctrl+O | open images or movies (the system’s dialog) |
Ctrl+Shift+O | open a folder |
drop | files or folders on the window: open them |
q (browser) | back to the start screen (Q quits) |
Ctrl+C | copy: the path (browser, image), the rows (2, 4) |
Ctrl+F | search the keys (in ? too) |
Ctrl+V | paste: into what is typed, else paths to open |
Ctrl+= / - | bigger / smaller text |
Ctrl+0 | text size back to the default |
F11 | full 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
| Path | What |
|---|---|
~/.local/state/rega/window | size, text size, the browser’s last folder |
~/.local/state/rega/recent | the 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.