FolderFrame
FolderFrame is a self-hosted photo and video gallery that turns folders into albums with album browsing and slideshows.
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
Variants
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
- Alternatives to Jellyfin that have folder browsers? : r/selfhosted - Reddit (reddit)
- Photo gallery app that uses existing folder structure? - Reddit (reddit)
- How to install or use FOlderframe.??? : r/PaintToolSAI - Reddit (reddit)
- Simple, Minimal Folder Sharing Recommendations : r/selfhosted - Reddit (reddit)
Collected 49 days ago - public community threads