Point it at your folders, browse everything through a fast feed-style interface. No cloud, no accounts — just your files and SQLite.
Originals stay in your gallery folder, untouched. Indexed metadata lives in SQLite on disk. No cloud sync, no external API, no accounts needed.
Runtime reads come from SQLite and pre-generated derivatives instead of live filesystem walks. Pagination, lazy loading, and three feed modes keep browsing snappy.
Indexes JPEG, PNG, WebP, GIF, AVIF, MP4, MOV, M4V, WebM, and MKV. Thumbnails and previews are generated automatically during scans or on demand in lazy mode. Videos get a full reels view with scroll-snap playback.
Runs open by default. Enable an admin password, a viewer password, or anonymous public mode from Settings. Non-admin sessions can browse but cannot scan, delete, or rebuild.
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.
Foldergram walks GALLERY_ROOT recursively, skipping hidden paths. Files directly at the gallery root are ignored, while ordinary nested folders that directly contain supported media become separate albums. In the default reserved modes, stories/ descendants provide stories and highlights, and media in carousels/Post name/ becomes a post in its owning App Folder instead of making those reserved descendants separate albums; a valid carousel child can also qualify a carousel-only owner as an App Folder.
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/.
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.
Walk the gallery tree, skip hidden paths, and collect every non-hidden folder that directly contains supported media files. In reserved carousel mode, a folder also qualifies when its carousels/ directory has an immediate child containing supported media directly.
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.
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.
Feed, folder, reels, explore, likes, and moments pages all read from SQLite and serve derivative URLs — no filesystem walk per request.
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.
Admins manage Home, Reels, and folder-order defaults, stories and carousel folder modes, excluded folders, and Places preparation from Settings, then run scans or rebuilds locally. All controls stay on disk and on-device.
Featured on
