offlickr turns a Flickr Your Flickr Data export into a self-contained static website — a browsable offline archive of your photostream, albums, galleries, and profile. Zero runtime dependencies, works from file://, USB stick, or any static host.
Status: alpha (v0.1.0). Ingest, derive, render, and external asset fetch are all working.
New to the command line? Copy this prompt into Claude, ChatGPT, or any AI assistant:
Read https://raw.githubusercontent.com/yaniv-golan/offlickr/main/llms.txt and guide me, step by step, how to archive my Flickr account for safe-keeping.
pipx install offlickr # or: uv tool install offlickr
# Request your Flickr data from https://www.flickr.com/account
# (delivers ~5 zip files by email — put them in one folder)
offlickr build ~/Downloads/flickr-export -o ~/my-flickr-archive
offlickr serve ~/my-flickr-archive # opens http://127.0.0.1:8000Flickr accounts outlive Flickr's business decisions. If you care about your photos, comments, and the decade-plus of conversations attached to them, you want a local archive you can browse exactly like the site, without depending on Flickr being up.
The data layer (data/model.json + originals/) is independent of the rendered site — thumbnails and HTML are fully regeneratable. See What to keep for what actually needs to go into cold storage.
- Replicates the structure of
flickr.com/photos/<you>/: photostream, albums, galleries, groups list, faves, tags, geo map, about, testimonials. - Per-photo detail pages with description, comments, EXIF, notes, and links back to flickr.com.
- Two themes (
minimal-archivedefault,flickr-classicalternative). - Private by default: Flickrmail, contacts, followers, and non-public photos are excluded unless you opt in with
--include-privateand--include-private-photos. - Optional external-asset caching (
--archive-external) to include avatars and fave thumbnails from other Flickr accounts. Requires a free Flickr API key — see external fetching. No API key is needed for the core archive.
| Photostream | Albums | Map | Photo detail |
|---|---|---|---|
 |
 |
 |
 |
- Getting started
- CLI reference
- Data model
- llms.txt — LLM-friendly doc index
See CONTRIBUTING.md. This project is strictly test-driven.
MIT.