Download the app
Download the app from GitHub. Keep its files together in your server’s web root.
Get the app ↗How it works
Serve the app files and media folders, then open the gallery in a browser.
What you need
- A computer, NAS or server that can serve static files
- HTTP or HTTPS access — not a file opened from disk
- HTML directory listings for every media folder
- A modern browser and a reachable server
Web server examples: Caddy, NGINX, Apache and lighttpd. Enable directory browsing for media folders. No database, PHP or build step is needed.
On Unraid, use a suitable web-server container. The Community App is coming soon.
EXAMPLE FOLDER STRUCTURE
FolderFrame/
├── index.html + app files
├── folderframe.config.json
└── photos/
├── Family/
│ └── birthday.jpg
├── Vacations/
│ └── beach.heic
└── garden.mp4
Setup
Add your media
Add media to photos/ or define served folder paths in folderframe.config.json. Subfolders become albums.
Configuration guide ↗Open the gallery
Check that /photos/ shows a directory listing, then open the app’s main address. Auto Refresh picks up media changes.
Hosting details ↗Local test
RUN INSIDE THE DOWNLOADED APP FOLDER · REQUIRES PYTHON 3
python3 -m http.server 8000 # Then open http://localhost:8000
For testing or a trusted local network. Use a configured web server for a permanent installation.
Examples
A family photo frame
Show the Family album on a tablet in TV Mode, with ten-second photos.
/?album=Family&tv=1&interval=10
A living-room slideshow
Play a shuffled slideshow of media from all folders.
/?view=all&autoplay=1&shuffle=1
A gallery on your website
Embed the gallery in a portfolio or personal site using an iframe.
<iframe src="https://YOUR-SERVER/?profile=embed" title="Photo gallery" allow="autoplay; fullscreen" allowfullscreen></iframe>
A quiet wall display
Run a slideshow without controls. Videos are muted.
/?profile=embed&controls=0&autoplay=1&view=all
Display link
Enter your gallery address and choose a setup. Nothing is sent to your server.