Cascade

A minimalist, offline masonry image viewer.

Masonry layouts are super common all over the web from websites like Pinterest, ArtStation, or DeviantArt. In terms of offline masonry viewers, the options are more limited. There are some programs like 123 Photos and Microsoft Photos. However, both of these solutions have a bit too much in the way, and only work on Windows.

This is where Cascade comes in. Choose a folder and look at your images without any unnecessary details.

Controls

Left click: Make target media fullscreen
Right click: Settings like sort order, recursion depth, and folder select
Ctrl + F: Choose another folder
Ctrl + Mouse wheel: Zoom in/out
Shift + Mouse wheel: Padding control
Esc: Close fullscreen view

Extra features

Automatic reload: Refreshes the grid when a setting is changed
Custom background colour: Accessed from the right-click menu
Folder persistence: Remembers chosen folder between sessions
Zoom persistence: Remembers zoom level between sessions
Format filtering: Toggle display of images and videos from right-click menu

Notes

Doesn't handle loading 1000+ files very well. Try to keep it under 500.

Installation

Development

npm install
npm start

Building

npm run package

Linux Desktop Integration

To integrate Cascade with your file manager (enable "Open with Cascade" context menu):

1. Install the application first using npm run package or npm run make
2. Copy the desktop file to system applications:

sudo cp cascade.desktop /usr/share/applications/

3. Copy the icon to system icons:

sudo cp app-icons/logo.png /usr/share/icons/hicolor/256x256/apps/Cascade.png

4. Update desktop database:

sudo update-desktop-database /usr/share/applications/

After installation, you can:

• Right-click folders or supported image/video files and select "Open with Cascade"
• Set Cascade as the default viewer for supported file types
• Launch Cascade from your application menu