Files
2026-06-09 18:40:21 +02:00

3.8 KiB


title: Immich Kiosk created: 2026-06-07 updated: 2026-06-07 type: app tags: [catalogue, photos, immich, kiosk, presentation, self-hosted, web] confidence: high contested: false sources: [https://selfh.st/apps/?tag=Photos, https://github.com/damongolding/immich-kiosk]

📸 Immich Kiosk

Mode kiosque pour Immich : transformez un écran en présentation photo automatique, idéal pour les événements, salons ou affichage public.

📋 Informations Générales

Attribut Valeur
Nom Immich Kiosk
Slug app-immich-kiosk
Description Affichage kiosque automatique basé sur Immich
Site officiel immich-kiosk.app
Repository damongolding/immich-kiosk
Stars 1 534
Licence MIT
Langage principal Go, TypeScript
Catégorie Photos
Tags [catalogue, photos, immich, kiosk, presentation, self-hosted, web]

📝 Description

Immich Kiosk est un projet communautaire (par damongolding) qui se branche sur votre instance Immich pour offrir un mode présentation automatique : pas d'UI, pas de menus, juste vos photos qui défilent en plein écran, avec des transitions soignées. C'est l'équivalent d'un diaporama PowerPoint, mais avec votre bibliothèque Immich comme source.

Différence avec app-immich-frame : Immich Kiosk met l'accent sur le kiosque public (mariage, conférence, vitrine de magasin) avec des mécanismes anti-burn-in (décalage progressif pour OLED), transitions plus variées, horloge et météo superposées, personnalisation par URL (query strings pour ajuster le comportement à la volée), mode Zen (photos aléatoires sans UI), et beaucoup d'options de filtrage (albums, personnes, dates, favoris).

Cas d'usage : mariage (afficheur dans la salle), funérarium, conférence (transitions entre talks), vitrine commerciale, accueil d'entreprise. L'URL peut être customisée par événement sans toucher au déploiement.

🚀 Installation

Via Docker (recommandé)

# docker-compose.yml
services:
  immich-kiosk:
    image: ghcr.io/damongolding/immich-kiosk:latest
    container_name: immich-kiosk
    restart: unless-stopped
    environment:
      - IMMICH_API_URL=https://photos.example.com/api
      - IMMICH_API_KEY=***
    ports:
      - 8083:8080

Query strings utiles

# Afficher un album spécifique
http://kiosk.local/?album=uuid-album

# Intervalle 10 secondes, anti-burn-in activé
http://kiosk.local/?duration=10&burnin=true

⚙️ Configuration

  • Clé API Immich : avec droits lecture sur les albums ciblés.
  • Query strings : configuration sans redémarrage (durée, album, transitions, etc.).
  • Reverse proxy : trivial, app statique Go + JS.
  • Capteur de présence (option) : supporté via MQTT/URL dynamique.

🔗 Alternatives

🔒 Sécurité

  • Clé API : scope minimal (lecture seule, albums spécifiques).
  • Pas d'auth utilisateur : tout le monde voit le kiosque, par design.
  • HTTPS : obligatoire pour fetch cross-origin en prod.
  • Exposition : ne pas exposer sur Internet si les photos sont sensibles.

📚 Ressources

🔗 Pages Liées