SynCiné
Le compagnon des cinéphiles, auto-hébergé.
Streaming, cinémas, watchlist et recommandations, réunis dans une seule appli.
Français · English
---
Découvre, suis et retrouve tous tes films et séries, **quelle que soit ta plateforme de streaming**, et ne rate plus rien de ce qui passe **dans les cinémas de ta ville**.
SynCiné réunit et synchronise **Trakt**, **TMDB** et les disponibilités streaming de **JustWatch** dans une seule interface, avec des **recommandations faites pour toi**. En option : ton journal **Letterboxd**, ta bibliothèque **Plex**, **Jellyfin** ou **Emby** et les demandes d'ajout via **Seerr**.
Deux versions : **personnelle**, pour toi seul, ou **serveur**, avec un administrateur et des **comptes pour la famille**. Une fois en ligne, SynCiné s'installe comme une **application** sur téléphone, tablette et ordinateur (PWA), en français, anglais, italien, allemand ou espagnol.
## Soutenir SynCiné
SynCiné est gratuit, libre et sans publicité. Si l'appli te plaît, tu peux offrir **un café au développeur… et des croquettes à Claude, son chat** 🐱☕
## Sommaire
- [Aperçu](#aperçu)
- [Fonctionnalités](#fonctionnalités)
- [Sources de données](#sources-de-données)
- [Installation](#installation)
- [Premiers pas](#premiers-pas)
- [Accès HTTPS et application mobile](#accès-https-et-application-mobile)
- [Mise à jour et sauvegarde](#mise-à-jour-et-sauvegarde)
- [Réglages](#réglages)
- [Sécurité](#sécurité)
- [Développement](#développement)
- [Contributeurs](#contributeurs)
- [Crédits et licence](#crédits-et-licence)
## Aperçu
Fiche d'un titre : où le regarder, notes, bande-annonce, casting, saisons. |
Tes cinémas : les séances du jour et de la semaine, VO ou VF. |
Watchlist : une seule liste, synchronisée entre Trakt, Plex et Letterboxd. |
Pour ce soir : seulement ce que tu peux lancer tout de suite. |
Statistiques : par jour, semaine, mois ou année. |
Espace admin (version serveur) : lectures Plex en cours, comptes, demandes. |
Les captures viennent d'un compte de démonstration.
## Fonctionnalités
**Découvrir**
- Tendances, nouveautés sur tes plateformes, films à l'affiche et suggestions personnalisées, à partir de tes goûts, de tes notes et des recommandations Trakt.
- Classements du jour par plateforme, tuiles « J'aime / Pas intéressé / Vu » directement sur les affiches.
- **Les sorties récentes de ta watchlist** mises en avant pendant la période que tu choisis (film arrivé en salles ou en streaming, nouvelle saison, nouvel épisode).
- Filtre **Vus / Pas vus** sur chaque onglet, et option pour ne plus te proposer ce que tu as déjà vu (une série qui a de nouveaux épisodes reste proposée).
- **Mode swipe** pour trier rapidement des dizaines de titres : déjà vu, à voir, pas intéressé.
- **Pour ce soir** : une sélection limitée à ce que tu peux regarder tout de suite, filtrable par durée et par envie (18 envies, dont *Pépites méconnues* et *Classiques*), avec une rangée « À revoir ».
**Au cinéma**
- Les séances de **tes salles habituelles** (France, Allemagne, Espagne, Turquie, Mexique), avec un filtre « films uniquement » (sans opéras ni concerts).
- Les sorties en salles et en streaming de ton pays, en grille ou en calendrier.
- Pour un film annoncé : sa date de sortie en salles dans ton pays et sa première sortie en streaming dans le monde.
- Un film encore au cinéma ? SynCiné te le signale et peut demander son ajout pour le jour de sa sortie numérique.
**Actu Ciné**
- Les dernières critiques, actus et vidéos de tes sources préférées dans un seul fil : Écran Large, AlloCiné, Le Monde, Télérama, IndieWire, Variety, Letterboxd Journal…
- Ajoute n'importe quel site ou chaîne YouTube : il suffit de coller son adresse. Les articles s'ouvrent sur le site d'origine, où ton compte ou ton abonnement reste valable.
**Où regarder**
- Pour chaque titre, les plateformes où il est disponible dans ton pays : abonnement, location, achat. Tes abonnements passent en premier.
- Bouton « Regarder sur… » qui ouvre directement la bonne page, et l'application sur téléphone quand c'est possible.
- Notes du public (TMDB) et, avec un compte Plex relié, IMDb et Rotten Tomatoes ; bande-annonce, casting, collection.
**Suivre**
- **Watchlist, titres vus, notes et coups de cœur** réunis depuis Trakt, Plex et Letterboxd, et synchronisés dans les deux sens (avec aperçu et garde-fous).
- Suivi des séries saison par saison, épisode par épisode.
- Tris par date de sortie, date d'ajout, note globale, note de la critique, note du public, année ou ta propre note.
- **Notifications**, sous la cloche et en push sur ton téléphone ou ton ordinateur : un titre de ta watchlist arrive sur une de tes plateformes, un nouvel épisode d'une série que tu suis est sorti, un service ne répond plus. Tu choisis quand être prévenu : dès la diffusion, quand c'est sur tes plateformes, ou quand c'est ajouté sur Plex.
- **Statistiques** détaillées de ton historique : heures, films, épisodes, genres, jours et heures de visionnage.
**En famille (version serveur)**
- Un administrateur et des comptes pour chaque membre : chacun a sa watchlist, ses notes, son historique, ses services.
- Connexion par mot de passe, ou avec un compte Plex ou Jellyfin / Emby autorisé par l'administrateur.
- **Demandes d'ajout** : envoyées directement à Seerr pour les membres autorisés, sinon placées dans une file que l'administrateur traite.
- **Tableau de bord du serveur** (Plex, Jellyfin ou Emby, ou plusieurs à la fois) : lectures en cours (débit, transcodage), bibliothèques et analyses, statistiques.
**Partout**
- Application installable (PWA) sur iPhone, iPad, Android et ordinateur, pensée pour chaque taille d'écran, thème clair ou sombre.
- Un **assistant de premier démarrage** pour chaque nouveau compte, une **recherche dans les réglages**, et sur ordinateur un menu que tu ranges à ta guise.
- Interface en **français**, **anglais**, **italien**, **allemand** et **espagnol**, notifications comprises.
## Sources de données
| Service | Rôle | |
|---|---|---|
| [TMDB](https://www.themoviedb.org) | Fiches, tendances, sorties, recherche, disponibilités streaming | **Indispensable** (clé gratuite) |
| [Trakt](https://trakt.tv) | Watchlist, historique, notes, recommandations | Recommandé |
| [JustWatch](https://www.justwatch.com) | Liens directs vers chaque plateforme, nouveautés, classements | Option (API non officielle, désactivable) |
| AlloCiné · Filmstarts · SensaCine · Beyazperde | Séances de tes cinémas | Option (source non officielle) |
| [Letterboxd](https://letterboxd.com) | Ton journal de films (flux RSS public) | Option |
| Sites de cinéma et chaînes YouTube | Actu Ciné (flux RSS publics, choisis par chacun) | Option |
| [Plex](https://www.plex.tv) | Ta bibliothèque, lecture, historique, comptes de la famille | Option |
| [Jellyfin](https://jellyfin.org) · [Emby](https://emby.media) | Ta bibliothèque, lecture, titres vus, comptes de la famille | Option |
| [Seerr](https://github.com/seerr-team/seerr) | Demandes d'ajout à ta bibliothèque | Option |
SynCiné ne télécharge rien. Il peut seulement transmettre une demande à Seerr, qui la traite ensuite selon tes réglages.
## Installation
SynCiné tient dans **un seul conteneur Docker** (interface et serveur) et stocke tout dans une base SQLite.
### Choisir une version
| | Version **serveur** | Version **personnelle** |
|---|---|---|
| Pour qui | Toi et ta famille | Toi seul |
| Connexion | Oui : mot de passe, compte Plex, Jellyfin ou Emby | Non |
| Comptes, demandes, espace admin | Oui | — |
| Où l'utiliser | Réseau local, Tailscale, ou Internet derrière un proxy HTTPS | Réseau de confiance uniquement (réseau local, Tailscale) |
| Réglage | `CINESYNC_MODE=server` | `CINESYNC_MODE=personal` |
### Avec Docker (toute machine Linux, NAS, mini-PC…)
Prérequis : Docker avec le plugin Compose. L'image est publiée pour PC (amd64) et ARM (Raspberry Pi 4/5, NAS ARM).
1. Crée un dossier `syncine` et, dedans, un fichier `docker-compose.yml` :
```yaml
services:
syncine:
image: ghcr.io/gauffrepierre/syncine:latest
container_name: syncine
restart: unless-stopped
ports:
- "3000:8000" # port de l'interface sur la machine : 3000
volumes:
- ./data:/app/data # base de données (à sauvegarder)
environment:
- CINESYNC_MODE=server # ou personal (une seule personne, sans connexion)
- PUBLIC_URL= # adresse HTTPS de SynCiné, si tu en as une (voir plus bas)
- TZ=Europe/Paris
- PUID=1000 # propriétaire des données : résultat de la commande « id »
- PGID=1000
```
2. Lance-le :
```bash
docker compose up -d
```
3. Ouvre `http://:3000`. En version serveur, le premier écran crée le **compte administrateur** et demande un **code d'installation**, affiché dans les journaux :
```bash
docker logs syncine 2>&1 | grep "code pour créer"
```
Un assistant te guide ensuite (clé TMDB, pays, plateformes, cinémas, serveur multimédia…). Pour l'appli sur téléphone et l'accès hors de chez toi, passe ensuite en **HTTPS** (voir [Accès HTTPS](#accès-https-et-application-mobile)).
> 📦 **Guides par système** : [Unraid](docs/guides/fr/installation.md#unraid) · [TrueNAS](docs/guides/fr/installation.md#truenas) · [Proxmox](docs/guides/fr/installation.md#proxmox) · [OpenMediaVault](docs/guides/fr/installation.md#openmediavault) · [Docker Compose](docs/guides/fr/installation.md#docker-compose).
Compiler depuis les sources
```bash
git clone https://github.com/GauffrePierre/syncine.git
cd syncine
cp .env.example .env # puis adapte : version, dossier des données, port, PUID/PGID, PUBLIC_URL
docker compose up -d --build
```
Le conteneur s'appelle alors `cinesync` (`docker logs cinesync` pour le code d'installation).
### Sur Unraid
**Avec le modèle Unraid** : télécharge [`unraid/syncine.xml`](unraid/syncine.xml) dans `/boot/config/plugins/dockerMan/templates-user/` (commande dans le [guide d'installation](docs/guides/fr/installation.md#unraid)), puis **Docker → Add Container** et choisis **SynCiné** dans la liste des modèles. Les données vont dans `/mnt/user/appdata/syncine`, et le conteneur tourne sous `nobody:users`.
Avec Docker Compose sur Unraid (sans plugin)
Unraid n'embarque pas Docker Compose. Le binaire officiel peut être rangé avec l'application, sans rien installer dans le système :
```bash
mkdir -p /mnt/user/appdata/cinesync/bin && cd /mnt/user/appdata/cinesync
V=v5.7.0; B=https://github.com/docker/compose/releases/download/$V
cd bin && curl -fLO $B/docker-compose-linux-x86_64 && curl -fLO $B/docker-compose-linux-x86_64.sha256 \
&& sha256sum -c docker-compose-linux-x86_64.sha256 && mv docker-compose-linux-x86_64 docker-compose && chmod +x docker-compose
cd .. && git clone https://github.com/GauffrePierre/syncine.git app && cd app
cp .env.example .env # DATA_PATH=/mnt/user/appdata/cinesync/data, PUID=99, PGID=100, CINESYNC_PORT libre, PUBLIC_URL
../bin/docker-compose -p cinesync up -d --build
```
Si le port 3000 est déjà pris (Nginx Proxy Manager…), change `CINESYNC_PORT` dans `.env`.
## Premiers pas
> 📘 **Guides pas à pas** pour chaque situation : [version personnelle](docs/guides/fr/version-personnelle.md) · [serveur, administrateur](docs/guides/fr/serveur-admin.md) · [membre de la famille, avec ou sans Plex](docs/guides/fr/serveur-membre.md).
En résumé, tout se règle dans **Profil**, dans cet ordre :
1. **TMDB** : crée une clé gratuite sur [themoviedb.org](https://www.themoviedb.org/settings/api) (Paramètres → API). Sans elle, SynCiné affiche des données de démonstration.
2. **Région et plateformes** : choisis ton pays et coche tes abonnements. Ce choix sert aux badges, aux filtres, au bouton « Regarder sur… » et aux notifications.
3. **Cinémas** : cherche tes salles habituelles.
4. **Trakt** :
1. Crée une application sur [trakt.tv](https://trakt.tv/oauth/applications/new). L'URL de retour peut rester `urn:ietf:wg:oauth:2.0:oob`.
2. Saisis son **Client ID**. Aucun secret n'est nécessaire.
3. Clique sur **Se connecter avec Trakt** et saisis le code affiché sur trakt.tv/activate.
5. **En option** :
- **JustWatch** : une case à cocher, pour les liens directs et les nouveautés.
- **Letterboxd** : ton nom d'utilisateur.
- **Plex** : **Se connecter avec Plex**, puis le code à saisir sur plex.tv/link. SynCiné trouve ensuite tout seul la meilleure connexion à ton serveur.
- **Jellyfin / Emby** : l'adresse du serveur vue depuis SynCiné (IP locale, pas `localhost` en Docker) et une clé API (Jellyfin : Tableau de bord → Clés API ; Emby : Paramètres → Clés API).
- **Seerr** : son adresse et sa clé API.
La **synchronisation automatique** (watchlist identique partout, vus et notes recopiés là où ils manquent) se règle dans Profil → Synchronisation. Un aperçu montre ce qui va changer avant de l'activer.
Comptes de la famille (version serveur)
Dans **Profil → Admin** (ou l'entrée **Espace admin** du menu) :
- **Comptes locaux** : tu choisis un identifiant et un mot de passe provisoire, que la personne change à sa première connexion.
- **Comptes Plex** : SynCiné liste les personnes avec qui ton serveur Plex est partagé. Une fois autorisées, elles se connectent avec « Se connecter avec Plex ». SynCiné vérifie que c'est bien ce compte, et chacun retrouve ses propres vus et sa progression.
- **Comptes Jellyfin / Emby** : SynCiné liste les comptes de ton serveur. Une fois autorisés, ils se connectent avec « Se connecter avec Jellyfin » (ou Emby), avec leur mot de passe habituel, vérifié par ton serveur.
- **Demandes directes à Seerr** : à activer compte par compte. Sinon, les demandes arrivent dans l'onglet Demandes de l'administrateur, qui est prévenu par une notification.
La clé TMDB, le serveur multimédia (Plex, Jellyfin ou Emby), Seerr et JustWatch sont réglés une fois par l'administrateur et partagés par tous. Trakt, Letterboxd, les plateformes et les cinémas sont propres à chaque compte.
## Accès HTTPS et application mobile
Pour installer SynCiné comme une application (PWA), le navigateur exige le **HTTPS**. Deux solutions :
Tailscale : accès privé, sans ouvrir de port
Avec Tailscale installé sur le serveur :
```bash
tailscale serve --bg --https=8443 http://127.0.0.1:3000
```
SynCiné est alors sur `https://..ts.net:8443`, avec un certificat valide, et seulement depuis ton tailnet. Dans `.env` :
```ini
PUBLIC_URL=https://..ts.net:8443
CINESYNC_BIND=127.0.0.1 # le port HTTP n'est plus ouvert sur le réseau
```
Sur Unraid, évite le port 443 : l'interface d'Unraid l'utilise déjà sur l'adresse Tailscale.
Nom de domaine : derrière un proxy inverse (Caddy, Nginx Proxy Manager, SWAG…)
Exemple avec Caddy, qui obtient le certificat tout seul :
```
cinesync.exemple.fr {
reverse_proxy 127.0.0.1:3000
}
```
Dans `.env` :
```ini
PUBLIC_URL=https://cinesync.exemple.fr
CINESYNC_BIND=127.0.0.1
HSTS_SECONDS=31536000 # le navigateur n'utilisera plus que le HTTPS pour ce domaine
```
Si le proxy tourne dans un autre conteneur (Nginx Proxy Manager…), `127.0.0.1` n'est pas joignable depuis ce conteneur. Ajoute un fichier `docker-compose.override.yml`, propre à ton serveur, pour ouvrir SynCiné au seul réseau interne de Docker :
```yaml
services:
cinesync:
ports:
- "172.17.0.1:3000:8000" # passerelle du réseau Docker par défaut : invisible du réseau local
```
Le proxy redirige alors vers `http://172.17.0.1:3000`. Son adresse doit faire partie de `FORWARDED_ALLOW_IPS`, ce qui est le cas par défaut pour les réseaux Docker. Le HSTS n'est envoyé que sur le domaine de `PUBLIC_URL`.
**Installer l'application :**
- **iPhone / iPad** : ouvre SynCiné dans Safari, puis **Partager → Sur l'écran d'accueil**.
- **Android** : Chrome propose directement l'installation.
- **Ordinateur** : utilise l'icône d'installation dans la barre d'adresse.
## Mise à jour et sauvegarde
```bash
docker compose pull && docker compose up -d # image publiée
git pull && docker compose up -d --build # compilé depuis les sources
```
Sur Unraid : onglet **Docker → Check for Updates**, puis **Apply Update**.
La base de données (`cinesync.db` dans le dossier des données) est migrée automatiquement au démarrage.
**Sauvegardes** : SynCiné sauvegarde sa base chaque jour dans `backups/` (dossier des données) et garde les 7 dernières. Dans **Profil → Admin → Sauvegardes**, tu peux changer ce nombre, désactiver la sauvegarde automatique, sauvegarder tout de suite ou télécharger une copie. Une sauvegarde contient les jetons de tes services connectés : garde les copies en lieu sûr, idéalement aussi hors du serveur.
**Restaurer** une sauvegarde :
```bash
docker compose stop
gunzip -c data/backups/syncine-AAAAMMJJ-HHMMSS.db.gz > data/cinesync.db
rm -f data/cinesync.db-wal data/cinesync.db-shm
docker compose start
```
## Réglages
Dans le fichier `.env` (voir [`.env.example`](.env.example)). Les clés des services se saisissent dans l'interface, pas ici.
| Variable | Par défaut | Rôle |
|---|---|---|
| `CINESYNC_MODE` | `server` | `server` (comptes, connexion) ou `personal` (une personne, sans connexion) |
| `DATA_PATH` | `./data` | Dossier de la base sur l'hôte |
| `CINESYNC_PORT` | `3000` | Port de l'interface sur l'hôte |
| `CINESYNC_BIND` | `0.0.0.0` | `127.0.0.1` pour n'autoriser que l'accès par un proxy HTTPS installé sur le serveur |
| `PUBLIC_URL` | — | Adresse publique (`https://…`) : connexion Trakt, cookies sécurisés, vérification d'origine |
| `TZ` | `Europe/Paris` | Fuseau horaire |
| `PUID` / `PGID` | `99` / `100` | Propriétaire des fichiers de données (Unraid 99/100, la plupart des Linux 1000/1000, TrueNAS 568/568) |
| `HSTS_SECONDS` | `0` | Active le HSTS (domaine dédié en HTTPS uniquement) |
| `FORWARDED_ALLOW_IPS` | `127.0.0.1,172.16.0.0/12` | Proxys dont l'adresse du visiteur est acceptée |
| `NOTIFICATION_INTERVAL_HOURS` | `24` | Fréquence de vérification des disponibilités |
| `API_DOCS` | `false` | Documentation interactive de l'API sur `/api/docs` |
| `LOG_LEVEL` | `INFO` | Niveau des journaux |
## Sécurité
- **Version serveur** :
- connexion obligatoire, avec des mots de passe hachés (scrypt) et une session dans un cookie HttpOnly ;
- notifications push chiffrées pour chaque appareil, sans service tiers ;
- double authentification facultative (codes à 6 chiffres d'une application comme Aegis ou Google Authenticator, codes de secours) ;
- essais de connexion limités, requêtes venant d'autres sites refusées ;
- chaque compte ne voit que ses propres données.
- Les clés et jetons des services ne sont jamais renvoyés au navigateur. L'administrateur en voit seulement un aperçu masqué.
- Le conteneur tourne sans les droits root, et la base n'est lisible que par son propriétaire.
- La **version personnelle** n'a pas de connexion : ne l'expose jamais directement sur Internet.
Pour signaler une faille, voir [SECURITY.md](SECURITY.md).
## Développement
> 🛠️ **Wiki développeur** (en anglais) : [docs/wiki](docs/wiki/README.md) — architecture, serveur, interface, données, sécurité, synchronisation, tests, publication. Pour les assistants de code IA : [AGENTS.md](AGENTS.md).
```bash
# Serveur (Python 3.12)
cd backend
python -m venv .venv && . .venv/bin/activate
pip install -r requirements.txt pytest
uvicorn app.main:app --reload --port 8000 # base dans backend/data/
pytest
# Interface (Node 22)
cd frontend
npm install
npm run dev # http://localhost:5173, /api relayé vers :8000
```
Organisation du code
```
backend/app/
main.py application FastAPI : routes, sécurité, interface compilée
database.py SQLite, migrations, données cloisonnées par compte
scheduler.py tâches périodiques (synchronisation, disponibilités, épisodes, santé)
models/ comptes, réglages, état des titres, historique, notifications, demandes
routers/ API : auth, admin, media, library, tmdb, trakt, plex, cinema…
services/ clients TMDB, Trakt, Plex, JustWatch, AlloCiné, Seerr, Letterboxd ;
synchronisation, historique, suggestions, sessions
frontend/src/
pages/ Découvrir, À venir, Pour ce soir, Watchlist, fiche, Profil, Statistiques, Admin…
components/ mise en page, affiches, fiche, admin, profil, swipe, notifications
i18n/ traductions (le français sert de clé ; dictionnaires anglais, italien, allemand, espagnol)
hooks/ services/ store/
```
## Contributeurs
- **Pierre Gauffre** : créateur du projet et développement.
- **Claude** ([Anthropic](https://www.anthropic.com)) : développement. Claude a écrit une grande partie du code et de la documentation, sous la direction de Pierre. Ses contributions apparaissent comme co-autrice des commits.
Les contributions sont les bienvenues : signale un bug ou propose une idée dans les *issues*, ou ouvre une *pull request*.
## Crédits et licence
Ce produit utilise l'API TMDB, mais n'est ni approuvé ni certifié par TMDB.
Les disponibilités streaming proviennent de [JustWatch](https://www.justwatch.com). Les séances de cinéma proviennent des sites du groupe Webedia (AlloCiné, Filmstarts, SensaCine, Beyazperde). SynCiné n'est affilié à aucun de ces services, ni à Trakt, Letterboxd, Plex ou Seerr.
SynCiné est un logiciel libre, distribué sous licence [GNU AGPL-3.0](LICENSE) : tu peux l'utiliser, l'étudier, le modifier et le partager. Toute version modifiée, y compris proposée comme service en ligne, doit rester libre sous la même licence.