CheCheViewer

A fast, keyboard-first image viewer for macOS, inspired by IrfanView. Open a folder, see every image in a grid, and walk through them with the arrow keys. No waiting around.

Install with Homebrew Source on GitHub
CheCheViewer showing a photo of an aurora taken from the International Space Station, with the file name, position in the folder and zoom level in the top bar

Install

With Homebrew, on macOS.

1. Add the tap and install:

brew tap ezeql/checheviewer https://github.com/ezeql/checheviewer
brew install checheviewer

2. Launch it once, so it shows up in Finder's Open With menu:

open "$(brew --prefix)/opt/checheviewer/CheCheViewer.app"

To update later:

brew update && brew upgrade checheviewer

Homebrew builds it from source (it fetches Rust for the build, which takes about a minute), so there is no unsigned-app warning from Gatekeeper. It installs the app and the checheviewer command: checheviewer ~/Pictures opens a folder, checheviewer photo.jpg opens an image. To make it the default for a file type: ⌘I on an image → Open with → CheCheViewer → Change All.

The whole folder at a glance

Thumbnails come from the preview embedded in each file, so even large folders fill in right away. Enter opens the selected image, Esc goes back.

The grid view with eighteen space photos as thumbnails, the first one selected

Made for the keyboard

A welcome card lists the essentials the first time it opens.

←→previous / next image
↑↓previous / next row in the grid
Enter Escopen an image / back to the grid
+−0zoom in, out, 100 %
⌘0fit to window
LRrotate left / right
Ffull screen
Deletemove the image to the Trash
⌘Deletedelete it for good (asks first)
The welcome card listing the essential shortcuts, with a Skip this next time checkbox and a Start button

Fast, and the formats you have

Written in Rust on the GPU (Metal), with macOS ImageIO for Apple's formats.

Never waits on decoding

Images decode in the background and the next ones are fetched ahead, so the arrow keys keep up.

HEIC and camera RAW

JPEG, PNG, GIF, WebP, TIFF, AVIF, HEIC and RAW (CR2, CR3, NEF, ARW, DNG…), read by the same engine Preview uses.

Upright and sharp

EXIF orientation is always applied. Double-click toggles between fit and actual size; pinch or ⌘+wheel zooms.

The viewer showing the Crab Nebula fitted to the window