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

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

  1. Install rega on your machine, and on any remote machine whose renders you want to look at.
  2. Terminal setup: check your terminal (and tmux, if you use it) with rega --doctor.
  3. The tutorial: rega --tutorial walks 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

  • h j k l move left, down, up and right, as in the vim editor. The arrow keys work too.
  • A capital letter means Shift: E is Shift+e, and e and E do different things.
  • gg means press g twice.
  • Ctrl+d and Ctrl+click mean hold Ctrl.
  • ? lists every key for the screen you’re on. Type to search it (a pane’s name finds that pane’s keys); ? or Esc closes the list.
  • q goes back one screen. Q quits 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.