A beautiful static gallery generator (written in Rust 🦀) for anyone who wants to showcase their photos, whether film scans or digital images. It keeps the analog spirit with vintage aesthetics and Atkinson dithering while making it easy to create stunning web galleries.
🎞️ See it in action here.
Warning
This project is currently under development and may introduce breaking changes.
- Create a new directory for your gallery.
mkdir films && cd films- Set up the required structure.
analogatique init-
Update
config.tomlwith your gallery details and preferences. -
Add your photos to the
photos/directory. -
Create
metadata.txtby writing one JSON line for each photo or useanalogatique extract-metadatato extract metadata from your photos.
{"filename": "photo1.jpeg", "date": "15-06-2023", "name": "Sunset at the Beach", "camera": "Canon AE-1", "film": "FUJICOLOR C200"}
{"filename": "photo2.jpeg", "date": "20-06-2023", "camera": "Polaroid SX-70", "film": "B&W SX-70"}- Generate your gallery:
analogatique generateYour gallery will be created in the public/ directory if you haven't changed the output directory.
Each line in metadata.txt should be a JSON object with these fields:
| Field | Description | Required |
|---|---|---|
filename |
Name of the photo file. | Yes |
date |
Date the photo was taken. (DD-MM-YYYY) | Yes |
camera |
Camera model used to take the photo. | No |
film |
Name of the film used for the photo. | No |
lens |
Lens used to capture the photo. | No |
location |
Place where the photo was taken. | No |
name |
Custom title or name given to the photo. | No |
notes |
Additional information or remarks about the photo. | No |
- JPEG (.jpg, .jpeg)
- PNG (.png)
- TIFF (.tif, .tiff)
- Thumbnails: WebP (You can enable optional Atkinson dithering.)
- Full Resolution: JPEG
The templates/ directory contains:
index.htmlstyles.cssfiles.
These use the Tera templating engine. Customize them to match your style!
This project is licensed under the MIT License. See the LICENSE file for details.
- I pay homage to Bill Atkinson for his Atkinson dithering algorithm and other work.
- I sincerely thank the Trippy team for their help with the release workflow. The current workflow is based on theirs.