FolderFrame

SELF-HOSTED PHOTO & VIDEO GALLERY

Drop folders.
Get a gallery.

Browse photos and videos directly from your folders.
Customize the albums, controls and display behavior to fit your space and how you use it.

GitHub

Source & documentation

Docker

Image & Compose files

Unraid CA

Install from Community Apps

Home Assistant

App & card coming soon

Open source · MIT licensed · Still in Beta

● ● ● Gallery preview ↗
The FolderFrame gallery showing real photo thumbnails and folder albums
Embedded from the demoAll photos · Shuffle · 3 seconds

Simple hosting

Hosting requirements
  • No database
  • No PHP
  • No build step

Flexible hosting: Examples include live directory listings on a web server, or a generated manifest published to Cloudflare Pages, GitHub Pages or another static host.

Folder albums

  • Nested albums with cover previews
  • Browse folders or all photos
  • Drop files or folders into your media directory; auto-refresh picks them up

Viewing & slideshows

  • Photo and video slideshows
  • Touch controls, fullscreen and TV Mode
  • Photo Info with capture, camera and optional GPS details

Standalone or embedded

  • Use on its own or embed on your site
  • Choose an album for each display

Who it’s for

  • Self-hosters who want simple folder-based galleries
  • Families putting photos on tablets and wall displays
  • Businesses powering digital signage and screens
All features

INTERACTIVE EXAMPLE

A folder becomes an album

No uploads · just an illustration

Add a sample folder and watch its album appear. In the app, Auto Refresh picks up changes in your served media directory.

Your media directory

photos/
📁 Family/birthday.jpg

Your gallery

Family1 photo