Introducing pic-viewer cover
Research notebook

Introducing pic-viewer

pic-viewer is a desktop image browser built with a Go backend and Vue interface through Wails. Its defining feature is folder-aware navigation: when the current directory ends, sequential browsing can continue into the next leaf folder instead of stopping at a filesystem boundary.

The resizable tree sidebar selects a root and exposes nested folders. Buttons jump to the next, previous, random, or last-visited leaf directory. Slideshows can run sequentially, randomly within one folder, or randomly across the full tree. The next sequential image is preloaded for smoother browsing.

Mouse-wheel and arrow-key navigation keep the viewer fast to operate, while Ctrl plus the wheel controls zoom. Supported formats include JPEG, PNG, GIF, BMP, WebP, and embedded JPEG previews from Fuji RAF files.

Build it

Install Go, Node.js, npm, and the Wails CLI, then run:

git clone https://github.com/Alchemist-Aloha/pic-viewer.git
cd pic-viewer
wails build

The executable is written under build/bin. This is a viewer, not an editor or catalog database; it is best suited to collections whose existing folder structure already carries useful meaning.

Visit the pic-viewer repository for the source and current control list.