https://github.com/un1970ix/analogatique
web gallery for your photos
https://github.com/un1970ix/analogatique
cli dithering gallery-generator photos rust static-site-generator
Last synced: 4 months ago
JSON representation
web gallery for your photos
- Host: GitHub
- URL: https://github.com/un1970ix/analogatique
- Owner: un1970ix
- License: mit
- Created: 2025-06-17T12:58:09.000Z (about 1 year ago)
- Default Branch: master
- Last Pushed: 2025-06-21T09:29:29.000Z (about 1 year ago)
- Last Synced: 2025-10-30T04:42:20.862Z (8 months ago)
- Topics: cli, dithering, gallery-generator, photos, rust, static-site-generator
- Language: Rust
- Homepage:
- Size: 39.1 KB
- Stars: 9
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
Awesome Lists containing this project
README
# analogatique · web gallery for your 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](https://films.un1970ix.com).**
> [!WARNING]
> This project is currently under development and may introduce breaking changes.
## Quick Start
1. Create a new directory for your gallery.
```zsh
mkdir films && cd films
```
2. Set up the required structure.
```zsh
analogatique init
```
3. Update `config.toml` with your gallery details and preferences.
4. Add your photos to the `photos/` directory.
5. Create `metadata.txt` by writing one JSON line for each photo or use `analogatique extract-metadata` to extract metadata from your photos.
```json
{"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"}
```
6. Generate your gallery:
```zsh
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](https://keats.github.io/tera/) templating engine. Customize them to match your style!
## License
This project is licensed under the MIT License. See the [LICENSE](LICENSE) file for details.
## Acknowledgments
- I pay homage to Bill Atkinson for his Atkinson dithering algorithm and other work.
- I sincerely thank the [Trippy](https://github.com/fujiapple852/trippy) team for their help with the release workflow. The current workflow is based on theirs.