rega
rega is an image browser and viewer that runs in the terminal. It is made for renders: multi-layer OpenEXR files and sequences, plus TIFF, PNG, JPEG, MOV and MP4.
rega (reh-GAH, /rʲɛˈɡɐ/): Lithuanian for “sight”.
Use it on your own machine, or on one you reach through a terminal, such as a farm node
or a remote workstation: log in there with ssh from Ghostty or kitty, run rega on that
machine, and the images show in your terminal. Or run rega --gui for
a window of its own, no terminal needed.
Where to start
- Install rega on your machine, and on any remote machine whose renders you want to look at.
- Terminal setup: check your terminal (and tmux, if you use it) with
rega --doctor. - The tutorial:
rega --tutorialwalks you through sample images.
After that, rega browses the current folder and rega render.exr opens one image.
? lists every key.
Then the guide follows the screen, in the same order as the ? list: the
browser, the viewer and its panes.
Each page starts with a clip of the feature, a TL;DR and its keys. The
reference lists every command-line option and every key.
The clips use the tutorial’s images, so you can follow along: run rega --tutorial and
press the keys shown in the corner of each clip.
What it does
- Browse folders with a live preview. Numbered frames collapse into one sequence
(
shot.####.exr). Filter by typing, and mark images in any folder to open together. - View one image, a sequence with a playbar, every layer (AOV) side by side, or several images tiled.
- Compare two versions: A, B and |A − B| side by side, plus the header rows that differ.
- Inspect pixel values (Nuke coordinates), per-channel statistics, NaN and inf pixels, and the data window against the display window.
- Colour through your OpenColorIO config (
$OCIO) or OCIO’s built-in ACES configs: display, view, look and each image’s input colour space. - Annotate with burn-in text, filled in from each frame’s header (
[#owner],[#@frame]). - Follow a render: new frames appear as they’re written, and a half-written EXR shows what’s there.
Reading the keys
hjklmove left, down, up and right, as in the vim editor. The arrow keys work too.- A capital letter means Shift:
Eis Shift+e, andeandEdo different things. ggmeans pressgtwice.Ctrl+dandCtrl+clickmean hold Ctrl.?lists every key for the screen you’re on. Type to search it (a pane’s name finds that pane’s keys);?orEsccloses the list.qgoes back one screen.Qquits rega from anywhere.
How images are drawn
In Ghostty and kitty, images are full resolution, also through tmux and ssh. Every other terminal shows half-blocks, a coarser picture (side by side). Terminal setup has the details. The window is always full resolution.