Foldergram
Media ServersA self‑hosted, local‑only photo and video gallery that presents folders as an Instagram‑style feed.
Features
- Instagram‑inspired UI with Home, Reels, Explore, Library, Likes, Moments/Highlights and app‑folder pages
- Supports images (JPG, PNG, GIF, AVIF, WebP) and videos (MP4, MOV, M4V, WEBM, MKV) with thumbnail and preview generation
- Configurable eager or lazy derivative creation for fast browsing; original media download controls
- Role‑based local access (admin, viewer, public), settings for feed modes and excluded folders
- Progressive Web App manifest plus service worker registration
Recent releases
View all 13 releases →- Legacy route aliases continue to work but new canonical routes are preferred.
- Settings changes for stories mode and excluded folders may require a subsequent scan.
- Fallback to original image when preview is missing
- Original media download actions in home feed, post viewer, stories viewer, and reels viewer
- Polished viewer experience: icon tooltips, click‑to‑pause video playback, video folder covers, smoother post switching
Full changelog
Foldergram v1.1.0 brings a solid round of viewer, routing, and library-management improvements.
Highlights:
- Fixed post viewer navigation on
/likes/posts, so previous/next now stays within the liked-posts collection. - Added a fallback to the original image when a generated preview is missing, preventing blank post views.
- Added original media download actions to the home feed, post viewer, stories viewer, and reels viewer.
- Polished the viewer experience with better icon tooltips, click-to-pause video playback, support for video-based folder covers, and smoother post-switching.
- Cleaned up canonical app routes: posts now prefer
/post/:idand folders now prefer/f/:slug, while legacy aliases continue to work. - Expanded Settings with a dedicated
General Settingsarea for stories behavior, feed defaults, and excluded folders. - Added configurable excluded folders for gallery discovery, rescans, and watcher-driven indexing, with support for both
.envconfig and runtime settings. - Clarified when settings changes require a follow-up scan, especially for stories-mode and excluded-folder updates.
- Moved generated previews and thumbnails into a new app-managed storage layout that is no longer tied to the gallery folder structure.
- Added clearer scan progress and migration status messaging, including guidance for older libraries that still need to move to the new derivative layout.
- Compatibility toggle in Settings allows reverting to legacy stories‑as‑folders behavior; use the provided rescan path if needed
- Reserved `AppFolder/stories` support for avatar stories and highlight capsules across scanning, storage, and API surfaces
- Shared `StoriesModal` for opening stories from Home avatars and folder pages
- Settings now includes a unified general settings card with stories mode controls, legacy toggle, migration messaging, and rescan flow
Full changelog
Summary
This release adds end-to-end folder stories and highlights support, fixes Recent feed ordering to stay strictly reverse-chronological, and improves the mobile viewing and settings experience.
Highlights
- Home
Recentfeed now renders in strict reverse-chronological SQL order with no post-query reshuffling or burst balancing. - Added reserved
AppFolder/storiessupport for avatar stories and highlight capsules across scanning, storage, and API surfaces. - Home avatars and folder pages now open stories through a shared
StoriesModal. - Added stories mode controls in Settings, including support for legacy stories-as-folders behavior, migration messaging, and rescan flow.
- Reserved story media is excluded from normal folder, feed, and reels surfaces.
- Improved mobile reels controls and streamlined navigation and settings menus.
- Refactored Settings into a unified general settings card with compact feed selectors and stories toggle.
- Fixed story ID validation plus story retry and error-state handling.
- Added regression coverage for Recent feed ordering and updated tests/docs for the new stories flow.
Notes
This change is designed to preserve existing local gallery behavior while introducing dedicated stories handling. If you were previously using stories as normal folders, the new settings flow provides a compatibility toggle and rescan path.
Weekly OSS security release digest.
The CVE patches and breaking changes that affected production tools this week. One email, every Sunday.
No spam, unsubscribe anytime.