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, Places, Collections, Trash, Folder pages, post detail and modal, Likes, saved posts, Moments or 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, .jpeg, .png, .webp, .gif, .avif. 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, optional place assignments, 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, Stories, and Places

Home surfaces date-based Moments when EXIF timestamps are available, or Highlights otherwise. Reserved AppFolder/stories subfolders power avatar stories and highlight rings, and prepared offline place data can group GPS-tagged photos into Places pages.

6

Maintain locally

Admins manage Home, Reels, and folder-order defaults, stories mode, excluded folders, and Places preparation from Settings, then run scans or rebuilds locally. All controls stay on disk and on-device.

Released under the AGPL-3.0 License.