---
title: Watcharr
created: 2026-06-07
updated: 2026-06-07
type: app
tags: [catalogue, arr, watchlist, trakt, simkl, frontend]
confidence: high
contested: false
sources: [https://selfh.st/apps/?tag=*arr, https://github.com/sbondCo/Watcharr]
---

# 🎬 Watcharr

> Interface web unifiée pour gérer votre watchlist cinéma/série : agrège les watchlists Trakt, Simkl, IMDb, et offre une UI moderne pour suivre, noter et découvrir du contenu à voir.

## 📋 Informations Générales

| Attribut | Valeur |
|----------|--------|
| **Nom** | Watcharr |
| **Slug** | watcharr |
| **Description** | UI de watchlist cinéma/série moderne, agrège Trakt/Simkl/IMDb, support multi-utilisateurs, public/private lists |
| **Site officiel** | https://watcharr.app |
| **Repository** | https://github.com/sbondCo/Watcharr |
| **Stars** | 1 381 ⭐ |
| **Licence** | MIT |
| **Langage principal** | TypeScript / Go |
| **Catégorie** | *arr (utilitaires) |
| **Tags** | [catalogue, arr, watchlist, trakt, simkl, frontend] |

## 📝 Description

**Watcharr** part d'un besoin simple : centraliser toutes ses watchlists éparpillées (Trakt, Simkl, IMDb, Letterboxd, listes Overseerr...) dans **une seule interface** qu'on contrôle, et qu'on peut partager avec sa famille ou sa communauté.

Fonctionnalités principales :
- **Auth locale** ou **OAuth Trakt/Simkl/IMDb** : on peut soit utiliser Watcharr comme source unique, soit se connecter à ses comptes existants pour importer les watchlists.
- **Listes multiples** : "À voir", "Vu", "En cours", "Recommandé par Paul", etc. Listes **publiques** (partageables via URL) ou **privées**.
- **Recherche unifiée** : agrège les métadonnées TMDB, TVDB, OMDB pour les jaquettes, synopsis, casting, notes.
- **Multi-utilisateurs** : authentification, isolation des watchlists par user.
- **Activité** : timeline d'ajouts, de visionnages, de notations.
- **Intégration Overseerr/Jellyseerr** : depuis la fiche d'un film, déclencher une demande Overseerr en un clic.
- **Acteurs** : import des watchlists Trakt en masse, sync bidirectionnelle (expérimental).

L'UI est **claire, sombre, responsive**, plus moderne que l'UI Trakt native. Le projet est jeune mais très actif.

## 🚀 Installation
### Via Docker (recommandé)
```yaml
# docker-compose.yml
services:
  watcharr:
    image: ghcr.io/sbondco/watcharr:latest
    container_name: watcharr
    restart: unless-stopped
    environment:
      - TZ=Europe/Paris
      - JWT_SECRET=change...me
      - DB_TYPE=sqlite
    volumes:
      - ./config:/app/config
    ports:
      - "3080:3080"
```
### Installation manuelle
Node.js 20+ pour le frontend, Go 1.21+ pour le backend. `git clone`, `npm ci && npm run build`, `go build`.

## ⚙️ Configuration
- **JWT_SECRET** : 32+ caractères aléatoires, **obligatoire**, jamais la valeur par défaut.
- **Connexion Trakt** : créer une app sur `trakt.tv/oauth/applications/new`, fournir client_id/secret.
- **Connexion Simkl** : idem sur `simkl.com/settings/developer/`.
- **TMDB API key** : gratuite sur `themoviedb.org/settings/api`, utilisée pour les métadonnées et jaquettes.
- **Overseerr URL** : `http://overseerr:5055`, l'UI ajoute un bouton "Demander" sur chaque fiche.
- **Reverse proxy** : `watcharr.example.com` avec HTTPS (Traefik/Caddy).

## 🔗 Alternatives
- **Trakt.tv** — service cloud, leader, mais UI vieillissante et données hors de notre contrôle.
- **Simkl** — concurrent direct de Trakt, plus jeune.
- **Letterboxd** — films uniquement, très orienté cinéphiles.
- **Maloja / Gonic** — orientés stats musicales, pas la même cible.
- **Sonarr/Radarr Wishlist** — la "wanted list" *arr est une watchlist technique (manque), pas une watchlist humaine (envie).

## 🔒 Sécurité
- **JWT_SECRET** : critique,泄漏 = vol de sessions, **rotation** possible mais invalidant.
- **HTTPS obligatoire** : les watchlists révèlent vos goûts, à protéger.
- **OAuth tokens Trakt/Simkl** : stockés chiffrés en DB, `./config` à protéger au repos.
- **Multi-users** : chaque user doit avoir un mot de passe fort, supporter 2FA si dispo.
- **Listes publiques** : attention à ce que vous partagez, l'URL est devinable.
- **Logs** : modérés, ne contiennent que les ajouts de films/séries, pas les notes.

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

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