SPIS

SPIS is a Simple Private Image Server that provides a minimal, fast web gallery for images and videos stored on a filesystem. It is designed for low-resource hosts and mobile use, exposing a progressive web app frontend while delegating media serving to a separate webserver.

Key Features

• Progressive Web App (PWA) frontend optimized for mobile and desktop
• Endless scrolling gallery with thumbnail generation and fast pagination
• Favorites, archive, slideshow playback, and basic filtering by year/month/subdirectory
• Video support with processing using external tools (transcoding/metadata via ffmpeg/ffprobe)
• Custom commands configurable in the UI to run scripts on selected media files
• Configuration via CLI, environment variables, or TOML file with templating for nginx, systemd, and docker-compose
• Docker image and prebuilt binaries for easy deployment
• Filesystem-first design: no database required, multi-threaded Rust backend for indexing and metadata processing

Use Cases

• Personal photo and video galleries hosted on a NAS or single-board computer
• Lightweight media viewer for private collections with PWA installability on phones
• Embeddable admin/viewer for shared media directories with custom command hooks

Limitations and Considerations

• SPIS does not serve raw media files directly; a separate webserver must be configured to serve media and thumbnails
• No built-in user authentication or access control; protection should be implemented at the webserver or reverse-proxy layer
• Video features require ffmpeg/ffprobe on the host for processing and metadata extraction

SPIS is focused on simplicity, performance, and low operational overhead, making it a practical choice for self-hosted personal galleries and lightweight media browsing on modest hardware.