Le suivi de séries, animes et films — épisode par épisode, entre amis, auto-hébergé.
Zéro clé d'API · Un seul conteneur Docker · Mise à jour automatique à chaque push ·
Les trackers grand public poussent vers un abonnement et demandent une clé d'API rien que pour afficher une affiche. TVTracker fait l'inverse : un docker run, un compte admin, et vos amis s'inscrivent — leurs données restent sur votre serveur, point final.
|
📺 Séries & Animes Cochez un épisode ou une saison entière en un clic, suivez votre progression, filtrez en cours / terminées. 🎬 Films Liste à voir / vu, note personnelle, bascule instantanée. |
🔍 Explorer Recherche en temps réel, tendances du moment, distribution complète avec photos, badge « Déjà ajouté ». 👤 Profil Temps de visionnage total, top contenus, import de tout votre historique TV Time en un fichier. |
Interface mobile-first (navigation en bas d'écran sur téléphone, sidebar sur desktop), thème sombre.
docker run -d --name tvtracker -p 3000:3000 \
-e JWT_SECRET=$(openssl rand -hex 32) \
-e ADMIN_USERNAME=admin -e ADMIN_EMAIL=admin@exemple.com -e ADMIN_PASSWORD=changez-moi \
-v tvtracker_data:/data \
ghcr.io/estemobs/tvtracker:latestL'application est sur http://localhost:3000. Le compte admin est créé automatiquement au premier démarrage ; vos amis s'inscrivent ensuite et apparaissent dans l'onglet Admin pour validation.
Ou avec Docker Compose, en clonant le dépôt :
git clone https://github.com/Estemobs/tvtracker.git && cd tvtracker
cp .env.example .env # puis éditer : JWT_SECRET, ADMIN_*
docker compose up -d --buildChaque push sur main republie l'image sur GHCR ; sur un serveur lancé avec docker-compose.prod.yml, Watchtower la récupère toute seule au bout de quelques minutes — aucune mise à jour manuelle à faire.
| Variable | Rôle | Requis |
|---|---|---|
JWT_SECRET |
Signature des sessions — générer avec openssl rand -hex 32 |
✅ |
ADMIN_USERNAME / ADMIN_EMAIL / ADMIN_PASSWORD |
Compte admin initial | ✅ |
PORT |
Port HTTP exposé | non (3000) |
MOVIE_PROVIDER |
Source des films : cinemeta (défaut) ou wikipedia (retour arrière pendant la migration) |
non (cinemeta) |
| Contenu | Source |
|---|---|
| Séries & animes | TVmaze — recherche, fiches, saisons/épisodes, notes |
| Films — recherche | Cinemeta — repli iTunes |
| Films — tendances | iTunes |
Cinemeta est un service non officiel et ses titres sont en anglais ; quand iTunes connaît une fiche française, son titre localisé est utilisé sur la fiche du film.
Import TV Time : la page Profil accepte directement l'export RGPD téléchargé sur gdpr.tvtime.com — l'import tourne en fond avec une barre de progression, pas besoin de tout ressaisir à la main.
┌─────────────────────────────────────────────────┐
│ Conteneur Docker unique │
│ │
│ React (statique) ──► Express (API + fichiers) │
│ │ │
│ ├──► SQLite ──┐ │
│ │ ▼ │
│ │ volume /data │
│ │ (BDD + avatars) │
│ ▼ │
│ TVmaze · Cinemeta · iTunes │
│ (catalogue, sans clé d'API) │
└─────────────────────────────────────────────────┘
React + Vite + Tailwind côté client, Node.js + Express côté serveur (sert l'API et le front sur le même port), SQLite dans un simple fichier. Auth par JWT + bcrypt, verrouillage anti brute-force.
La migration 010 des versions précédentes pouvait supprimer les films enregistrés par les utilisateurs. La version 1.0.1 corrige la migration pour les installations qui ne l'ont pas encore exécutée ; la 1.0.2 complète la récupération, mais aucune version ne peut restaurer les lignes déjà effacées. Le script backend/src/scripts/recover-user-movies.js tente de les retrouver dans le fichier SQLite et son WAL.
La récupération est best-effort : elle ne retrouve que les pages qui n'ont pas encore été réutilisées. Faites une sauvegarde avant toute opération.
-
Sauvegarder le volume
/data(adapter le nom du volume, visible avecdocker volume ls) :docker run --rm -v tvtracker_tvtracker_data:/data -v "$PWD":/backup alpine \ tar czf /backup/tvtracker-data-backup.tgz -C /data .
-
Empêcher Watchtower de redémarrer le conteneur pendant l'opération :
docker compose -f docker-compose.prod.yml stop watchtower
-
Ne pas redémarrer l'application avant le premier dry-run. L'ancien conteneur ne contient pas le script : utilisez l'image 1.0.2 dans un conteneur ponctuel, avec le même volume :
docker compose -f docker-compose.prod.yml pull tvtracker docker compose -f docker-compose.prod.yml run --rm --no-deps -e DATA_DIR=/data \ tvtracker node src/scripts/recover-user-movies.js
-
Si le dry-run trouve des lignes, relancer avec
--apply:docker compose -f docker-compose.prod.yml run --rm --no-deps -e DATA_DIR=/data \ tvtracker node src/scripts/recover-user-movies.js --apply
-
Redémarrer l'application et réactiver Watchtower :
docker compose -f docker-compose.prod.yml up -d tvtracker docker compose -f docker-compose.prod.yml start watchtower
# Backend (Node 20 — better-sqlite3 est un module natif compilé)
cd backend && npm install
JWT_SECRET=dev ADMIN_EMAIL=admin@test.com ADMIN_USERNAME=admin ADMIN_PASSWORD=adminpass npm run dev
# Frontend (autre terminal — proxy /api vers :3000)
cd frontend && npm install
npm run devAprès une mise à jour depuis une version où les films étaient sourcés Wikipédia, associer leur identifiant IMDb et les rebasculer sur Cinemeta :
cd backend && npm run backfill:imdb # --dry-run pour prévisualiserLes correspondances ambiguës sont listées à la fin pour arbitrage manuel.
backend/src/
db/ connexion SQLite + migrations (jouées au boot)
routes/ auth, admin, shows, movies, explore, profile
services/ tvmaze.js, cinemeta.js, itunes.js, catalog.js (cache)
frontend/src/
pages/ Series, Movies, Explore, Profile, Admin
components/ NavBar, PosterCard, ProgressBar