3.9 KiB
title: Immich Frame created: 2026-06-07 updated: 2026-06-07 type: app tags: [catalogue, photos, immich, frame, kiosk, self-hosted, web] confidence: high contested: false sources: [https://selfh.st/apps/?tag=Photos, https://github.com/immich-app/immich-frame]
📸 Immich Frame
Cadre photo numérique connecté à Immich : transformez n'importe quel écran (vieux laptop, tablette, Raspberry Pi) en cadre dynamique affichant votre bibliothèque Immich.
📋 Informations Générales
| Attribut | Valeur |
|---|---|
| Nom | Immich Frame |
| Slug | app-immich-frame |
| Description | Cadre photo numérique pour Immich |
| Site officiel | immich.app |
| Repository | immich-app/immich-frame |
| Stars | 2 116 ⭐ |
| Licence | MIT |
| Langage principal | TypeScript, Svelte |
| Catégorie | Photos |
| Tags | [catalogue, photos, immich, frame, kiosk, self-hosted, web] |
📝 Description
Immich Frame est un projet officiel du team Immich (sous l'organisation GitHub immich-app) qui matérialise un usage simple : afficher votre bibliothèque Immich en mode cadre photo numérique. Vous avez un vieil écran, une tablette Android murale, un Pi avec écran LCD ? Branchez Immich Frame et vous avez un cadre dynamique, mis à jour en continu depuis votre serveur Immich.
Fonctionnalités : sélection aléatoire depuis un album spécifique (configurable), intervalle de rotation (5s à plusieurs minutes), transitions douces entre photos, horloge/calendrier superposés (overlay), météo locale (optionnel, via API Open-Meteo), détection de présence (capteur, en option), plein écran automatique, kiosque (désactive interactions, plein écran permanent).
Cas d'usage typique : un vieux moniteur 24" branché à un Pi 4 dans le salon, affichant les photos de famille stockées sur Immich, avec rotation toutes les 30 secondes. Effet waouh garanti, coût quasi nul.
🚀 Installation
Via Docker (recommandé)
# docker-compose.yml
services:
immich-frame:
image: ghcr.io/immich-app/immich-frame:latest
container_name: immich-frame
restart: unless-stopped
environment:
- IMMICH_API_URL=https://photos.example.com/api
- IMMICH_API_KEY=changeme
- IMMICH_ALBUM_ID=album-uuid
ports:
- 8080:8080
Sur Raspberry Pi en kiosk
# Après déploiement, ouvrir Chromium en mode kiosque sur l'URL
chromium-browser --kiosk --noerrdialogs --disable-infobars http://localhost:8080
⚙️ Configuration
- Clé API Immich : obligatoire, avec accès en lecture à l'album ciblé.
- Album source : un UUID d'album Immich — limiter le scope de la clé API.
- Intervalle de rotation : paramétrable via variables d'environnement ou UI web.
- Transitions : fade/slide/dissolve selon préférences.
- Wake-on-LAN / scheduling : combinable avec un script cron pour éteindre l'écran la nuit.
🔗 Alternatives
- app-immich-kiosk — Plus ancien, davantage orienté "kiosque public" que cadre familial
- app-chronoframe — Cadre avec timeline chronologique
- app-omoide — Approche japonaise minimaliste
🔒 Sécurité
- Clé API : choisir le scope minimal (lecture seule, album unique).
- Pas d'auth utilisateur : repose sur le secret API.
- Exposition : à garder sur LAN, ou protéger par VPN/Tailscale.
- HTTPS : obligatoire pour fetch sur Immich distant.