.png)
1 month ago
5
SPHPIG is a PHP re-implementation of the static image gallery generator Snig, originally brain coded in Perl by Thomas Klausner ([email protected]). The goal of this port is to provide the same workflow in PHP-centric environments while keeping the spirit and behaviour of the upstream project. It was vibecoded using an LLM.
- Scans directories for jpg/jpeg files.
- Generates thumbnails and preview images while preserving aspect ratio.
- Applies optional EXIF-based orientation fixes.
- Produces per-image HTML pages and a linked index.
- Packages originals into a downloadable ZIP archive.
- Ships with simple PHP templates and the CSS shared with the Perl project.
- PHP 7.4 or newer with the CLI SAPI.
- GD extension (required) for image resizing.
- ZipArchive extension (required) for creating the archive.
- exif extension (optional but recommended) for richer metadata extraction.
- Clone this repository or copy the sphig folder into your project.
- Ensure the PHP executable you plan to use has the required extensions enabled.
- (Optional) Add sphpig/bin/snig.php to your PATH or create a convenient alias.
php bin/snig.php \
--input /path/to/images \
--output /path/to/gallery \
--name "My Gallery"
- --name Human-friendly gallery name (defaults to the input directory name).
- --th_size Thumbnail width in pixels (default: 200).
- --detail_size Preview width in pixels (default: 1000).
- --sort_by Sorting strategy: created (EXIF date) or mtime (filesystem modification time).
- --force Repeatable flag with values resize and/or zip to force image regeneration or ZIP creation even if artifacts already exist.
The output directory will contain:
- Copies of the originals (orig_*).
- Thumbnails (thumbnail_*) and previews (preview_*).
- An index.html page listing all images.
- Individual HTML pages per photo.
- The stylesheet snig.css and a ZIP archive with the original files.
- Upstream project: Snig (Perl) by Thomas Klausner – https://github.com/domm/snig
- PHP port: Maintained in this repository, following the intent and licensing of the original.
SPHPIG inherits the same license as Perl 5 (Artistic License 1.0 / GPL compatible). See the LICENSE file in the repository root for details.
Contributions are welcome. If you spot a bug, need support for a new format, or want to add features, please open an issue or submit a clearly described pull request.
Enjoy building static galleries with SPHPIG!
