Самостоятельно размещаемая веб-галерея для просмотра личных фото и видео с тегами, удобным интерфейсом для мобильных устройств и поиском похожих изображений и лиц.
foldergram/foldergram
Самостоятельно размещаемое веб-приложение, которое превращает локальные папки с фото и видео в ленту и галерею в стиле Instagram.
Open source альтернатива:Google Photos
- Звёзды
- 602
- Форки
- 36
- Открытые issues
- 21
- Последний коммит
- 3 дня назад
Что это?
Foldergram индексирует поддерживаемые изображения и видео в указанной корневой папке галереи. Каждая неп скрытая папка, в которой непосредственно находятся медиафайлы, становится папкой приложения и отображается как профиль, а каждый файл в ней — публикацией. Метаданные хранятся в SQLite, а миниатюры и превью создаются во время сканирования или при первом запросе, поэтому при просмотре данные берутся из базы, а не из файловой системы в реальном времени.
Интерфейс — это Progressive Web App с главной лентой в режимах Recent, Rediscover или Random, разделом Reels только для видео, библиотекой с поиском и сортировкой папок, а также просмотрщиком публикаций с поддержкой каруселей. Доступ можно отключить (только для администратора), защитить паролем для зрителей или открыть для публичного просмотра с избранным, хранящимся локально в браузере. Дополнительные настройки позволяют задать время создания производных файлов, качество изображений — оригиналы или превью, исключить папки и включить доступный только для чтения публичный деморежим.
Для обработки видео и анимированных последовательностей AVIF при установке из исходников нужны ffmpeg и ffprobe. Они входят в Docker-образ. Проект работает на Node.js 22, Express 5, Vue 3 и Vite.
Ключевые возможности
- 01Главная лента в стиле Instagram, профили папок приложения и просмотрщик публикаций.
- 02Отдельный раздел Reels для видео и вкладки Reels для каждой папки.
- 03Предварительное или отложенное создание миниатюр и превью для изображений и видео.
- 04Публикации-карусели из 2–20 упорядоченных изображений или видео.
- 05Ролевой доступ: администратор, зритель с общим списком понравившегося или публичный режим просмотра.
- 06Исключение папок с помощью маркеров .nofoldergram и правил GALLERY_EXCLUDED_FOLDERS.
- 07Развёртывание через Docker: образ GHCR или локальная сборка.
Сценарии использования
- Просмотр личного архива фото и видео на домашнем сервере или NAS.
- Просмотр папок с экспортированными материалами с камеры в формате социальной ленты по локальной сети.
- Публикация доступной только для чтения галереи локальных медиафайлов в деморежиме.
- Хранение медиафайлов локально, без загрузки в облачный фотосервис.
Быстрый старт
- 1
Создайте папку для Foldergram и перейдите в неё
mkdir foldergram cd foldergram - 2
Скачайте файл Compose
wget -O docker-compose.yml https://raw.githubusercontent.com/foldergram/foldergram/main/docker-compose.yml - 3
Создайте первую папку галереи, добавьте в неё фотографии или видео, а затем запустите контейнер
mkdir -p data/gallery/example-album docker compose up -d - 4
Откройте приложение в браузере по адресу localhost, порт 4141
Что важно знать
- Требуется Docker или Node.js 22 с pnpm либо npm. Для поддержки видео вне Docker также нужен ffmpeg.
- Лицензия AGPL-3.0 требует раскрывать исходный код изменений, доступных по сети.
В подборках
Темы
Частые вопросы
- Что такое foldergram?
- Самостоятельно размещаемое веб-приложение, которое превращает локальные папки с фото и видео в ленту и галерею в стиле Instagram. Foldergram индексирует поддерживаемые изображения и видео в указанной корневой папке галереи. Каждая неп скрытая папка, в которой непосредственно находятся медиафайлы, становится папкой приложения и отображается как профиль, а каждый файл в ней — публикацией. Метаданные хранятся в SQLite, а миниатюры и превью создаются во время сканирования или при первом запросе, поэтому при просмотре данные берутся из базы, а не из файловой системы в реальном времени.
- foldergram можно использовать бесплатно? Какая у него лицензия?
- foldergram распространяется с открытым исходным кодом под лицензией AGPL-3.0. Перед использованием в коммерческих продуктах проверьте условия лицензии.
- foldergram всё ещё поддерживается?
- Активно поддерживается. Последний коммит в foldergram — 3 нояб. 2026 г..
- Для чего можно использовать foldergram?
- Просмотр личного архива фото и видео на домашнем сервере или NAS. Просмотр папок с экспортированными материалами с камеры в формате социальной ленты по локальной сети. Публикация доступной только для чтения галереи локальных медиафайлов в деморежиме. Хранение медиафайлов локально, без загрузки в облачный фотосервис.
- Как установить foldergram?
- Создайте папку для Foldergram и перейдите в неё: mkdir foldergram cd foldergram Скачайте файл Compose: wget -O docker-compose.yml https://raw.githubusercontent.com/foldergram/foldergram/main/docker-compose.yml Создайте первую папку галереи, добавьте в неё фотографии или видео, а затем запустите контейнер: mkdir -p data/gallery/example-album docker compose up -d Откройте приложение в браузере по адресу localhost, порт 4141
- Где скачать foldergram?
- Исходный код и инструкции по установке — на GitHub: https://github.com/foldergram/foldergram
Описание создано ИИ на основе README проекта. Статистика GitHub обновляется ежедневно.
Похожие проекты
Самостоятельно размещаемая фотогалерея, которая превращает папки на сервере в альбомы и подходит фотографам с большими коллекциями RAW-файлов.
Самостоятельно размещаемая система управления фотографиями: загружайте, упорядочивайте и публикуйте снимки на собственном сервере или веб-хостинге.
Самостоятельно размещаемая фотогалерея: извлекает EXIF, определяет места съёмки, воспроизводит Live Photos и предлагает альбомы и просмотр на карте.
Самостоятельно размещаемая фотогалерея на Go и Vue в виде одного бинарного файла — для просмотра множества снимков без изменения оригиналов.
Самостоятельно размещаемая галерея фото и видео, куда гости мероприятия загружают свои материалы по ссылке или QR-коду.