---
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](https://immich-kiosk.app) |
| **Repository** | [damongolding/immich-kiosk](https://github.com/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é)

```yaml
# 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

- **[[app-immich-frame]]** — Plus simple, plus familial, par l'équipe Immich officielle
- **[[app-chronoframe]]** — Autonome, pas besoin d'Immich
- **[[app-omoide]]** — Approche japonaise minimaliste

## 🔒 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

- [Site officiel](https://immich-kiosk.app)
- [Repository GitHub](https://github.com/damongolding/immich-kiosk)
- [Configuration options](https://github.com/damongolding/immich-kiosk/blob/main/docs/Config.md)

## 🔗 Pages Liées
- [[cat-photos]]
- [[app-immich]]
- [[app-immich-frame]]
- [[app-chronoframe]]
- [[app-traefik]]
- [[recettes-docker-compose]]
- [[securisation-home-lab]]
