FolderFrame

FolderFrame is a self-hosted photo and video gallery that turns folders into albums with album browsing and slideshows.

  • Media Applications
  • Tools & Utilities
FolderFrame is a self-hosted photo and video gallery that turns folders into albums with album browsing and slideshows. No database, PHP, or build step is required.

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.

57/100 Fair

Maintained
93last commit 24 days ago
Popular
165 GitHub stars
Easy to install
351 install platform, install notes, Docker image
Light to run
No data

Based on 3 of 4 factors.

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

GitHub stars
5
Open issues
0
Last commit
2026-10-27
Latest release
v0.8.9
License
MIT
Activity
declining

Checked 23 days ago - source: GitHub (The-Grog/FolderFrame)

Resources & Compatibility

Requirements not published yet.

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

First-install notes

  • Security No authentication or TLS is configured by default. Use on a trusted LAN, or add access controls before public exposure. source
  • Folder Selection Do not select an entire share, source repository, private files, or a folder containing symlinks as the media folder. source

Fetched 47 days ago - each note links to its source

Alternatives

No alternatives collected yet.

Common questions

How should I bind-mount media directories in Docker?

Use dedicated media directories and mount the primary library read-only at /media/Library, with additional libraries at unique sibling paths such as /media/Archive. Leave /media itself unmounted.

What should I persist for settings and generated metadata?

Use a persistent /config directory if settings, thumbnails, manifests, and Photo Info metadata should survive container recreation.

What port does FolderFrame use, and does it include authentication or TLS?

FolderFrame has no built-in authentication or TLS and listens on container port 8080. The Docker Run example maps host port 8088 to container port 8080.

Can multiple displays share one media library?

Yes, each display can use its own album and slideshow settings while sharing the same media. It can also be embedded in a page with a standard iframe.

How does Photo Info get image metadata?

The viewer shows capture, camera, lens, exposure, dimensions, and GPS details only when the current image has an EXIF sidecar in the generated manifest. Valid GPS coordinates link to Google Maps only after you click them.

Answers sourced from github.com, www.folderframe.com

Community

Collected 49 days ago - public community threads