Show HN: Simple Photo Gallery – open-source CLI to create static photo galleries

Create beautiful photo galleries from collections in just 30 seconds. No configuration required to get started—simply run two commands in your photos folder and create a static gallery website you can self-host.

This is a free, open-source tool that you can use to generate galleries and self-host them. If you don't want to use the command line or bother with self-hostting, please check out simple.photo for a hosted solution.

• California Road Trip
• Visiting Australia
• Discovering Japan

To create a gallery you need to install he simple-photo-gallery package globally and then you can use the spg command:

Alternatively you can use npx to run the commands directly:

This will:

1. Install the simple-photo-gallery package from NPM (if you don't already have it)
2. Prompt you for your gallery title, description, and header image
3. Scan your photos and create a gallery.json file
4. Generate optimized thumbnails
5. Build a static HTML gallery that you can open in your browser and self-host

• Node.js 20+ - Download here
• FFmpeg (for video support) - Install via:
  • macOS: brew install ffmpeg
  • Ubuntu/Debian: sudo apt install ffmpeg
  • Windows: Download from ffmpeg.org

Images: JPEG, PNG, WebP, GIF, TIFF
Videos: MP4, MOV, AVI, WebM, MKV

For advanced usage, customization, and deployment options, see the comprehensive documentation:

• Commands Reference - Detailed guide for all CLI commands
  • init - Initialize new galleries
  • build - Generate static HTML galleries
  • thumbnails - Generate optimized thumbnails
  • clean - Remove gallery files
• Gallery Configuration - Manual editing of gallery.json and advanced features like sections
• Deployment Guide - Guidelines for hosting your gallery

The old Python version of Simple Photo Gallery V1 is still available here, but is now deprecated.

Simple Photo Gallery is licensed under the MIT License - see LICENSE file for details.