Grained

Grained is a self-hosted archive for lab-scanned film that imports scan ZIPs, logs per-roll metadata, and browses frames in a lightbox with per-frame…

  • Media Applications
  • Tools & Utilities
Grained is a self-hosted archive for lab-scanned film that imports scan ZIPs, logs per-roll metadata, and browses frames in a lightbox with per-frame annotations, helping film photographers revisit and share their work months or years later.

Platform availability

Available on 1 of 10 platforms

  • Unraid
  • TrueNAS (not listed)
  • Umbrel (not listed)
  • ZimaOS (not listed)
  • Proxmox (not listed)
  • Helm (not listed)
  • Mac (not listed)
  • Windows (not listed)
  • Linux (not listed)
  • Any server (not listed)

Health score?A 0-100 score computed nightly from four factors: maintained (40%: recent commits and steady activity), popular (25%: GitHub stars, log scale), easy to install (20%: platforms, install notes, setup guides, Docker image) and light to run (15%: minimum RAM, ARM support). When the source code has been checked, a fifth factor, security check (20%: automated scan for committed secrets, unsafe desktop-app settings, known-vulnerable dependencies and project hygiene; any serious finding caps it at 20), is added. Factors without data are left out and the rest are rescaled.

35/100 Low

Maintained
59last commit 159 days ago
Popular
123 GitHub stars
Easy to install
351 install platform, install notes, Docker image
Light to run
108 GB minimum RAM

Availability: platform listings confirmed today, links checked 22 days ago

GitHub stars
3
Open issues
0
Last commit
2026-06-15
Latest release
v1.0.0
Activity
stale

Checked 7 days ago - source: GitHub (Revise0592/grained)

Resources & Compatibility

Minimum requirements: 8 GB RAM, 10 GB disk.

Checked 54 days ago - source: Docker Hub image tags and published docs

First-install notes

  • Import scan archives After setup, import your lab scan ZIP files so Grained can prepare frames for browsing. source

Fetched 4 days ago - each note links to its source

Alternatives

No alternatives collected yet.

Common questions

Which environment variables must be set before starting Grained in Docker?

You need at least DATABASE_URL and UPLOAD_DIR in your .env file. Those define where the archive database and upload files are stored.

How do I enable Grained's built-in login?

Set AUTH_DISABLED=false, start the app, then use the login page in the browser on first run to create the admin password. Grained keeps that auth state in the database.

How can I protect API access separately from the web app?

Add an API_KEY value when you want protected API access. It is used as a bearer token through middleware protection.

What parts of my archive should I back up?

Back up the database pointed to by DATABASE_URL and the files in UPLOAD_DIR. The upload directory holds original scans and generated files.

How long are temporary upload files kept before cleanup?

UPLOAD_TEMP_TTL_MS controls the retention time in milliseconds. The default is 86400000 ms.

Answers sourced from github.com

Community

Collected 49 days ago - public community threads