Initial vault setup

Catalogue-Self-Hosted/apps/app-foldergram.md

@@ -0,0 +1,102 @@
+---
+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]]