Repolode
foldergram

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. 1

    Создайте папку для Foldergram и перейдите в неё

    mkdir foldergram cd foldergram
  2. 2

    Скачайте файл Compose

    wget -O docker-compose.yml https://raw.githubusercontent.com/foldergram/foldergram/main/docker-compose.yml
  3. 3

    Создайте первую папку галереи, добавьте в неё фотографии или видео, а затем запустите контейнер

    mkdir -p data/gallery/example-album docker compose up -d
  4. 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 обновляется ежедневно.

Похожие проекты

Самостоятельно размещаемая веб-галерея для просмотра личных фото и видео с тегами, удобным интерфейсом для мобильных устройств и поиском похожих изображений и лиц.

1,2 тыс.+3 за неделю108JavaScriptMITОбновлён 7 дней назад

Самостоятельно размещаемая фотогалерея, которая превращает папки на сервере в альбомы и подходит фотографам с большими коллекциями RAW-файлов.

6,6 тыс.+7 за неделю496GoAGPL-3.0Активно поддерживаетсяОбновлён 8 дней назад

Самостоятельно размещаемая система управления фотографиями: загружайте, упорядочивайте и публикуйте снимки на собственном сервере или веб-хостинге.

4,3 тыс.+8 за неделю384PHPMITАктивно поддерживаетсяОбновлён 21 час назад

Самостоятельно размещаемая фотогалерея: извлекает EXIF, определяет места съёмки, воспроизводит Live Photos и предлагает альбомы и просмотр на карте.

2 тыс.+6 за неделю156VueMITАктивно поддерживаетсяОбновлён вчера