103 lines
3.8 KiB
Markdown
103 lines
3.8 KiB
Markdown
---
|
|
title: Foldergram
|
|
created: 2026-06-07
|
|
updated: 2026-06-07
|
|
type: app
|
|
tags: [catalogue, photos, gallery, folder, simple, self-hosted, web]
|
|
confidence: high
|
|
contested: false
|
|
sources: [https://selfh.st/apps/?tag=Photos, https://github.com/foldergram/foldergram]
|
|
---
|
|
|
|
# 📸 Foldergram
|
|
|
|
> **Galerie photos basée sur dossiers, sans import** : pointez l'app sur votre arborescence existante et obtenez une galerie web clé en main, sans rien déplacer ni indexer lourdement.
|
|
|
|
## 📋 Informations Générales
|
|
|
|
| Attribut | Valeur |
|
|
|----------|--------|
|
|
| **Nom** | Foldergram |
|
|
| **Slug** | app-foldergram |
|
|
| **Description** | Galerie web générée depuis une arborescence de dossiers |
|
|
| **Site officiel** | [foldergram.app](https://foldergram.app) |
|
|
| **Repository** | [foldergram/foldergram](https://github.com/foldergram/foldergram) |
|
|
| **Stars** | 433 ⭐ |
|
|
| **Licence** | MIT |
|
|
| **Langage principal** | TypeScript, Node.js |
|
|
| **Catégorie** | Photos |
|
|
| **Tags** | [catalogue, photos, gallery, folder, simple, self-hosted, web] |
|
|
|
|
## 📝 Description
|
|
|
|
**Foldergram** part d'un constat simple : vous avez déjà vos photos **bien rangées** dans des dossiers (par date, événement, voyage). Pourquoi les importer dans une nouvelle base, créer des albums virtuels, gérer une BDD ? Foldergram lit **directement votre arborescence** et en fait une galerie web navigable, avec le dossier = album.
|
|
|
|
C'est l'**anti-Immich** dans l'approche : zéro import, zéro duplication, zéro base de données centrale. L'app scanne votre dossier, génère des thumbnails à la volée, et présente une UI web qui reflète votre structure.
|
|
|
|
Fonctionnalités : **scan récursif** de l'arborescence, **dossiers = albums** automatiques, **thumbnails générés à la volée** (cache disque), **tri chronologique** (par EXIF ou mtime), **carte géographique** (si EXIF GPS), **lightbox** plein écran, **slideshow**, **partage par lien** (sous-dossier), **recherche par nom**, **lazy loading** agressif, **PWA installable**.
|
|
|
|
Cas d'usage : **archives photos existantes** (vous avez déjà tout bien rangé), **partage temporaire** (dossier d'événement à montrer), **portfolios photographes** (dossier = série).
|
|
|
|
## 🚀 Installation
|
|
|
|
### Via Docker (recommandé)
|
|
|
|
```yaml
|
|
# docker-compose.yml
|
|
services:
|
|
foldergram:
|
|
image: ghcr.io/foldergram/foldergram:latest
|
|
container_name: foldergram
|
|
restart: unless-stopped
|
|
environment:
|
|
- FOLDERGRAM_ROOT=/photos
|
|
volumes:
|
|
- /mnt/photos:/photos:ro
|
|
- foldergram-cache:/app/cache
|
|
ports:
|
|
- 8088:8080
|
|
```
|
|
|
|
### Installation manuelle
|
|
|
|
```bash
|
|
git clone https://github.com/foldergram/foldergram.git
|
|
cd foldergram
|
|
npm install
|
|
PHOTOS=/chemin/vers/photos npm start
|
|
```
|
|
|
|
## ⚙️ Configuration
|
|
|
|
- **Dossier source** : variable d'environnement `FOLDERGRAM_ROOT`, montage `:ro` recommandé.
|
|
- **Cache** : volume séparé pour les thumbnails (s'efface sans perte).
|
|
- **Auth** : optionnelle (basic auth), utile pour exposition restreinte.
|
|
- **Performance** : sur grosse collection, prévoir SSD (lecture intensive).
|
|
|
|
## 🔗 Alternatives
|
|
|
|
- **[[app-pigallery2]]** — Même philosophie, mais en Go (plus performant)
|
|
- **[[app-foldergram]]** — (vous y êtes déjà)
|
|
- **[[app-photoview]]** — Galerie Go avec plus de fonctionnalités sociales
|
|
|
|
## 🔒 Sécurité
|
|
|
|
- **Lecture seule** : `:ro` pour éviter qu'un bug ne supprime vos originaux.
|
|
- **Pas d'auth par défaut** : activer basic auth en reverse proxy si nécessaire.
|
|
- **HTTPS** : recommandé.
|
|
- **Pas de base de données** : pas de risque d'injection SQL, surface d'attaque réduite.
|
|
|
|
## 📚 Ressources
|
|
|
|
- [Site officiel](https://foldergram.app)
|
|
- [Repository GitHub](https://github.com/foldergram/foldergram)
|
|
- [Démo en ligne](https://foldergram.app/demo)
|
|
|
|
## 🔗 Pages Liées
|
|
- [[cat-photos]]
|
|
- [[app-pigallery2]]
|
|
- [[app-photoview]]
|
|
- [[app-traefik]]
|
|
- [[recettes-docker-compose]]
|
|
- [[securisation-home-lab]]
|