analogatique

Crates.ioanalogatique
lib.rsanalogatique
version0.2.0
created_at2025-06-17 17:30:08.809358+00
updated_at2025-06-21 08:54:56.751764+00
descriptionweb gallery for you photos
homepage
repositoryhttps://github.com/un1970ix/analogatique
max_upload_size
id1716072
size86,971
bedir ekim (un1970ix)

documentation

README

analogatique ยท web gallery for you photos

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.

Quick Start

  1. Create a new directory for your gallery.
mkdir films && cd films
  1. Set up the required structure.
analogatique init
  1. Update config.toml with your gallery details and preferences.

  2. Add your photos to the photos/ directory.

  3. Create metadata.txt by writing one JSON line for each photo or use analogatique extract-metadata to 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"}
  1. Generate your gallery:
analogatique generate

Your gallery will be created in the public/ directory if you haven't changed the output directory.

Metadata Format

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

Supported Image Formats

  • JPEG (.jpg, .jpeg)
  • PNG (.png)
  • TIFF (.tif, .tiff)

Output Formats

  • Thumbnails: WebP (You can enable optional Atkinson dithering.)
  • Full Resolution: JPEG

Customization

Templates

The templates/ directory contains:

  • index.html
  • styles.css files.

These use the Tera templating engine. Customize them to match your style!

License

This project is licensed under the MIT License. See the LICENSE file for details.

Acknowledgments

  • 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.
Commit count: 5

cargo fmt