101 lines
3.8 KiB
Markdown
101 lines
3.8 KiB
Markdown
---
|
|
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]]
|