---
title: Cinephage
created: 2026-06-07
updated: 2026-06-07
type: app
tags: [catalogue, arr, radarr, frontend, cinema]
confidence: high
contested: false
sources: [https://selfh.st/apps/?tag=*arr, https://github.com/nicocool84/cinephage]
---

# 🎬 Cinephage

> Frontend alternatif pour Radarr : interface cinéphile épurée, focus sur la découverte et la curation de films, vue "affiche + synopsis" façon Letterboxd, intégrée à votre instance Radarr existante.

## 📋 Informations Générales

| Attribut | Valeur |
|----------|--------|
| **Nom** | Cinephage |
| **Slug** | cinephage |
| **Description** | UI cinéphile moderne pour Radarr, style Letterboxd, découverte et curation |
| **Site officiel** | https://cinephage.app |
| **Repository** | https://github.com/nicocool84/cinephage |
| **Stars** | 757 ⭐ |
| **Licence** | MIT |
| **Langage principal** | TypeScript / Python |
| **Catégorie** | *arr (frontend) |
| **Tags** | [catalogue, arr, radarr, frontend, cinema] |

## 📝 Description

**Cinephage** est un frontend qui **ne remplace pas Radarr** (il faut Radarr qui tourne en backend) mais qui offre une expérience utilisateur **100% repensée pour les cinéphiles**. L'UI officielle de Radarr est pratique pour gérer les downloads, mais pauvre pour **découvrir** et **admirer** sa bibliothèque.

Fonctionnalités principales :
- **Vue "coverflow"** : navigation horizontale façon Apple TV/iTunes, focus sur les jaquettes.
- **Vue Letterboxd-like** : grille d'affiches avec note moyenne TMDB/IMDb, année, réalisateur, durée.
- **Filtres cinéphiles** : par décennie (1890-2030), par genre (jusqu'à 3 croisés), par pays, par langue originale, par durée, par note.
- **Statistiques** : votre "annee de cinema" (films vus par année de sortie), top réalisateurs, genres dominants, ratio court/long.
- **Curation éditoriale** : thèmes pré-faits "Films français des années 90", "Neo-noir japonais", "S.F. soviétique", etc., alimentés par TMDB.
- **Watchlist intégrée** : sync avec Trakt/Letterboxd, marqueurs "vu / à voir / coup de cœur".
- **Lecteur intégré** : si vous êtes sur le même LAN que Jellyfin/Plex, lance la lecture directement.
- **Thèmes** : plusieurs ambiances visuelles (sombre par défaut, sépia, monochrome), focus cinéma.
- **Mobile-first** : responsive impeccable sur téléphone, parfait pour le canapé.

L'UI est **léchée**, **fluide**, et on redécouvre sa bibliothèque comme si on l'avait jamais vue.

## 🚀 Installation
### Via Docker (recommandé)
```yaml
# docker-compose.yml
services:
  cinephage:
    image: ghcr.io/nicocool84/cinephage:latest
    container_name: cinephage
    restart: unless-stopped
    environment:
      - TZ=Europe/Paris
      - RADARR_URL=http://radarr:7878
      - RADARR_API_KEY=xxxxxxxxxxxxxxxx
      - TMDB_API_KEY=xxxxxxxxxxxxxxxx
      - JWT_SECRET=change...me
    volumes:
      - ./config:/app/config
    ports:
      - "7879:7879"
```
### Installation manuelle
Node.js 20+ pour le frontend, Python 3.11+ pour le backend. `git clone`, `npm ci && npm run build`, `pip install -r requirements.txt`, `python cinephage.py`.

## ⚙️ Configuration
- **Radarr API key** : Settings > General > API Key dans Radarr.
- **TMDB API key** : gratuite sur `themoviedb.org/settings/api`, obligatoire pour les métadonnées.
- **Trakt API** : optionnel, pour sync watchlist. Créer une app sur `trakt.tv/oauth/applications/new`.
- **Jellyfin/Plex URL** : optionnel, pour le bouton "Lancer le film" depuis Cinephage.
- **Thème par défaut** : sombre recommandé pour home cinema.
- **Reverse proxy** : `cinephage.example.com` via Traefik avec Authelia.

## 🔗 Alternatives
- **Radarr UI native** — fonctionnelle mais austère.
- **Overseerr/Jellyseerr** — orienté demandes utilisateurs, pas curation.
- **Letterboxd** — excellent pour la curation, mais pas d'intégration Radarr.
- **Watcharr** — plus orienté watchlist que curation cinéphile.
- **Aurral** — équivalent pour la musique (Lidarr).

## 🔒 Sécurité
- **JWT_SECRET** : critique, 32+ caractères aléatoires, rotation recommandée.
- **API key Radarr en lecture seule** : créer une clé dédiée avec permissions minimales.
- **TMDB/Trakt keys** : à stocker en variables d'environnement.
- **HTTPS obligatoire** : votre bibliothèque de films est personnelle.
- **Pas d'auth native forte** : derrière Authelia/Authentik avec 2FA.
- **Logs** : contenir les requêtes API, surveiller les accès suspects.

## 📚 Ressources
- Site officiel : https://cinephage.app
- Documentation : https://docs.cinephage.app
- Wiki *arr : https://wiki.servarr.com
- Letterboxd : https://letterboxd.com

## 🔗 Pages Liées
- [[cat-arr]]
- [[app-radarr]]
- [[app-sonarr]]
- [[app-jellyfin]]
- [[app-plex]]
- [[app-overseerr]]
- [[app-jellyseerr]]
- [[app-watcharr]]
- [[app-traefik]]
- [[app-authelia]]
- [[app-authentik]]
- [[recettes-docker-compose]]
- [[securisation-home-lab]]
