---
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]]