100 lines
3.9 KiB
Markdown
100 lines
3.9 KiB
Markdown
---
|
|
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](https://immich.app) |
|
|
| **Repository** | [immich-app/immich-frame](https://github.com/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é)
|
|
|
|
```yaml
|
|
# 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
|
|
|
|
```bash
|
|
# 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.
|
|
|
|
## 📚 Ressources
|
|
|
|
- [Repository GitHub](https://github.com/immich-app/immich-frame)
|
|
- [Site Immich officiel](https://immich.app)
|
|
- [Topic immich-frame sur Reddit](https://reddit.com/r/immich)
|
|
|
|
## 🔗 Pages Liées
|
|
- [[cat-photos]]
|
|
- [[app-immich]]
|
|
- [[app-immich-kiosk]]
|
|
- [[app-chronoframe]]
|
|
- [[app-traefik]]
|
|
- [[recettes-docker-compose]]
|
|
- [[securisation-home-lab]]
|