Skip to content

FoldergramLocal-first photo and video gallery

Point it at your folders, browse everything through a fast feed-style interface. No cloud, no accounts — just your files and SQLite.

Foldergram Logo

Foldergram at a Glance

What ships today

Home (Recent, Rediscover, Random feed modes), Reels, Explore, Library, Folder pages, Post detail and modal, Likes, Favorites, Moments, Highlights, Folder stories, Settings, and local scan and rebuild tooling.

How indexing works

Foldergram walks GALLERY_ROOT recursively, skipping hidden paths. Any folder that directly contains supported media becomes an indexed album. Files at the gallery root and nested folders each become their own album.

Formats and storage

Images: .jpg, .png, .webp, .gif. Videos: .mp4, .mov, .m4v, .webm, .mkv. Originals are never moved. SQLite stores metadata. Thumbnails and previews are written under thumbnails/ and previews/.

Access modes

No password gate by default. Settings can enable admin-only access, a separate viewer password, or anonymous public mode. Admin sessions can run scans, rebuild indexes, delete posts, and manage access credentials.

How Foldergram Works

1

Discover folders

Walk the gallery tree, skip hidden paths, and collect every non-hidden folder that directly contains supported media files.

2

Index posts

Store normalized paths, media metadata, EXIF timestamps, stable sort order, and playback strategy in SQLite. Missing files are soft-deleted rather than hard-removed.

3

Generate derivatives

Create 640 px thumbnails, up to 1500 px image previews, and 720p-class video previews. Derivatives can be generated eagerly during scans or lazily on first request.

4

Serve fast reads

Feed, folder, reels, explore, likes, and moments pages all read from SQLite and serve derivative URLs — no filesystem walk per request.

5

Build Moments and Stories

Home surfaces date-based Moments when EXIF timestamps are available, or Highlights otherwise. Reserved AppFolder/stories subfolders power avatar stories and highlight rings on folder pages.

6

Maintain locally

Admins manage stories mode, excluded folders, and Home/Reels defaults from General Settings, then run scans or rebuilds from Scan & Library. All controls are local — no remote calls involved.

Released under the AGPL-3.0 License.