Tracker Dashboard

Tu l'utilises ? Tu l'aimes ? ⭐ Mets une étoile ! — ça prend deux secondes.

Important

Le projet est porté par l'organisation GitHub Tracker-Dashboard, en collaboration avec Zup (Autovisit-Web).

Les pull requests sont les bienvenues. Le projet continue d'évoluer (nouveaux sites, statistiques, interface).

Warning

Lors d'un rafraîchissement général ou du premier lancement, certains trackers peuvent temporairement afficher une erreur ou prendre du temps à se mettre à jour. Lancez si besoin une mise à jour individuelle du tracker concerné.

Les lectures via navigateur headless sont plus lourdes que les lectures HTTP. L'application limite la concurrence, applique un timeout par tracker, sert le cache au démarrage et utilise curl-impersonate quand c'est possible.

Tracker Dashboard

Tracker Dashboard est une WebUI pour suivre les statistiques de vos trackers BitTorrent : upload, download, ratio, buffer, points bonus, torrents en seed, MP non lus… selon les capacités de chaque site. Elle gère les identifiants, un proxy (HTTP/HTTPS/SOCKS/SSH), des connexions automatiques planifiées, l'historique en SQLite, et compare vos stats aux torrents réellement présents dans vos clients BitTorrent.

Au premier accès, l'application demande de créer le compte administrateur de la WebUI.

Export Prometheus + Grafana : endpoint /metrics (protégé par token via METRICS_TOKEN) exposant les stats des trackers activés (tracker_*) et des clients BitTorrent (tracker_qbit_*). Dashboard Grafana JSON dans grafana/dashboard.json — voir grafana/README.md.

Changements récents

Image principale allégée : Playwright, Chromium et CloakBrowser sont regroupés dans le service parallèle tracker-dashboard-browser, avec état, versions et alertes de mise à jour dans la WebUI.
Plusieurs comptes par tracker : duplication d'un tracker, noms d'affichage personnalisables, regroupement sous le site et attribution des torrents par passkey entre comptes.
Clients BitTorrent et cross-seed : comparaison aux torrents locaux, rafraîchissement automatique par client, plusieurs instances cross-seed et plusieurs clients associés à une même instance.
Seeding comparé : compteurs annoncés par le site et détectés dans les clients BitTorrent affichés côte à côte.
Protection anti-bot renforcée : sessions navigateur plus fiables, cookies par tracker et repli automatique via FlareSolverr lorsqu'un challenge bloque la lecture normale.
Ajout de trackers simplifié : presets UNIT3D, Gazelle, TorrentLeech, MyAnonamouse et API JSON, modes guidé/expert et catalogue enrichi, notamment avec IPTorrents et DarkPeers.
Interface modernisée : navigation latérale, vues cartes/lignes, taille des cartes partagée entre appareils, thèmes clair/sombre/système et fiches trackers enrichies.
Graphiques et calendrier : activation facultative, courbes UP/DL/ratio, comparaisons multi-trackers et historique des rafraîchissements OK/KO.
Notifications complètes : canaux globaux ou par tracker via Discord, Apprise ou e-mail, avec détection des messages privés non lus.
Observabilité : métriques Prometheus des trackers et clients BitTorrent (tracker_*, tracker_qbit_*) et dashboard Grafana fourni.
Authentification et réseau : 2FA TOTP par tracker, proxies HTTP/HTTPS/SOCKS/SSH et cookies de session pour les sites à CAPTCHA ou Cloudflare.
Lectures optimisées : curl-impersonate lorsque possible, Chromium par défaut et CloakBrowser en moteur furtif optionnel.

Interface

La navigation se fait depuis la barre latérale gauche :

Dashboard : vue d'ensemble des trackers (cartes ou lignes, bascule sous le menu). Chaque carte peut porter un « incident connu » et une note libre.
Graphiques : Global (UP/DL/seedtime agrégés), Évolution (par tracker ou « Tous »), comparaison multi-trackers (sélection libre des trackers), Totaux par tracker. Chaque graphe a un sélecteur de période et une plage de dates Du/Au.
Calendrier : calendrier des refreshs (OK/KO par jour) ; un tracker en KO renvoie vers sa configuration.
Trackers activés : accordéon listant les trackers actifs ; un clic ouvre la fiche du tracker.
Configuration : Ajouter un tracker (sites non activés), Configurer les actifs, Clients BitTorrent, Notifications (Canaux, Notifications globales, Par tracker), Proxies, Fréquence d'auto visite.
En bas : Synchroniser les sites, horodatage de dernière mise à jour, bascule de thème Clair / Sombre / Système, déconnexion.

Fiche d'un tracker

En-tête : logo, nom, lien vers le site, badge de statut (OK / cassé / données anciennes).
Stats actuelles : ratio, buffer, UP, DL, seed, torrents client.
Courbes d'évolution : Volumes (UP / DL, buffer en option) et Ratio, sur 7 jours / 30 jours / Tout ou une plage Du/Au.
Comment ce tracker est lu : mode de lecture (login auto / cookie collé / captcha), dernière lecture réussie, cookie et 2FA définis ou non.
Erreurs : erreur en cours, erreurs récentes (7 jours), historique complet.
Notifications configurées : reprend les notifications du menu Notifications applicables au tracker (sinon « Aucune »).
Torrents liés : torrents détectés dans vos clients BitTorrent pour ce tracker (état, taille, UP/DL/ratio), avec import des associations non reconnues.

Cookies de session (sites à CAPTCHA / Cloudflare)

Certains trackers protègent leur login par un CAPTCHA ou un challenge anti-bot (Cloudflare Turnstile…). Le navigateur headless ne peut pas les résoudre. Pour ces sites, fournissez directement un cookie de session : connectez-vous dans votre navigateur, exportez tous les cookies du site, puis collez-les dans Configuration → Configurer les actifs → (le tracker) → Options avancées → Cookie de session. Le dashboard les injecte avant chaque lecture et saute la page de login. Les cookies doivent être créés avec la même IP de sortie que celle utilisée par ce tracker dans Tracker Dashboard : activez donc dans votre navigateur le même proxy que celui configuré pour le tracker, ou utilisez la même connexion directe si aucun proxy ne lui est affecté. Vérifiez notamment que cf_clearance est présent pour les sites protégés par Cloudflare ; sinon, les sessions liées à l'IP et les cookies anti-bot seront refusés.

Trois formats auto-détectés :

fichier Netscape cookies.txt ;
export JSON d'une extension type Cookie-Editor ;
chaîne brute nom=valeur; nom2=valeur2 copiée depuis les DevTools.

Extensions pratiques : cookies-txt, Cookie-Editor, Get cookies.txt LOCALLY.

Le cookie est optionnel et propre à chaque tracker ; il finit par expirer, il suffit alors d'en recoller un frais.

Double authentification (2FA / TOTP)

Pour les trackers en 2FA basée sur le temps (TOTP), le dashboard génère lui-même le code à 6 chiffres. Renseignez le secret 2FA (clé base32 affichée à l'activation, ex. JBSWY3DPEHPK3PXP) dans Options avancées → Secret 2FA (TOTP) du tracker.

Secret stocké côté serveur, jamais renvoyé en clair par l'API.
Code calculé en local (RFC 6238, HMAC-SHA1, 6 chiffres, fenêtre 30 s).
Flux en deux étapes (Laravel Fortify / UNIT3D) : le code est soumis automatiquement sur la page de challenge. Pris en charge en HTTP, curl-impersonate et navigateur.
Flux en une étape : login.otpField ou placeholder {{otp}} dans le corps de login.

Laissez le champ vide pour les trackers sans 2FA.

Plusieurs comptes par tracker

Pour suivre plusieurs comptes sur un même site, dupliquez un tracker : dans Configuration → Configurer les actifs → (le tracker), cliquez sur Dupliquer. Un nouveau compte « (2) » est créé, prêt à recevoir ses identifiants.

Le duplicata reprend la même mécanique de login que le tracker d'origine et hérite automatiquement des corrections de login publiées par la suite.
Identifiants, cookie, 2FA, profil navigateur, statistiques, planning et notifications sont indépendants entre comptes.
Nom d'affichage modifiable : sur la fiche de configuration de chaque compte, champ Nom d'affichage + Renommer (ex. « C411 », « C411 Alex », « C411 Ishem »).
Dans la barre latérale (« Configurer les actifs » et « Trackers activés »), les comptes d'un même site sont regroupés sous le nom du site, dépliable.
Un compte dupliqué est supprimable (bouton Supprimer sur sa fiche) ; le tracker intégré d'origine, lui, ne peut être que désactivé.

Attribution des torrents par passkey

Quand un site a plusieurs comptes, les torrents de vos clients BitTorrent sont ventilés par passkey (celle présente dans l'URL d'annonce). Sur la fiche d'un compte, la section Attribution des annonces liste les passkeys détectées (affichées masquées) ; attribuez chacune au bon compte. Les torrents correspondants — et leurs statistiques — suivent alors le compte choisi. Avec un seul compte, rien ne change : l'attribution automatique par hôte reste utilisée.

Captures d'écran

Les captures ci-dessous illustrent le principe (données factices). L'interface a évolué depuis et ces captures seront mises à jour.

Connexions automatiques

La planification se règle dans Configuration → Fréquence d'auto visite :

Planification globale : trois modes — toutes les X heures, tous les X jours à heure fixe, ou certains jours de la semaine. Chaque cycle visite les trackers actifs disposant d'identifiants.
Fréquences individuelles : par tracker, on peut suivre la planification globale, la désactiver, ou fixer un intervalle propre (en heures).
Synchroniser les sites (bas de la barre latérale) lance un rafraîchissement manuel immédiat.

En cas de timeout ponctuel non marqué comme incident, les dernières données valides restent affichées avec un indicateur, puis le dashboard retente automatiquement 3 fois toutes les 10 minutes, puis 3 fois toutes les heures, avant la prochaine connexion planifiée.

Clients BitTorrent

Dans Configuration → Clients BitTorrent, ajoutez un ou plusieurs clients qBittorrent ou ruTorrent/rTorrent (URL d'API, identifiants). Le dashboard agrège les torrents par hôte d'annonce et les rapproche de vos trackers, ce qui alimente la fiche de chaque tracker.

Un lien Ouvrir mène à l'interface du client.
Chaque client a un champ Auto (j / h) : intervalle de rafraîchissement automatique (0 = désactivé). Les données sont aussi exposées à Prometheus (tracker_qbit_*).

Instances cross-seed

Dans la même page, la section Instances cross-seed permet d'associer une ou plusieurs instances cross-seed à leurs clients BitTorrent :

renseignez l'URL de la WebUI cross-seed (port par défaut 2468) et sélectionnez tous les clients qBittorrent ou ruTorrent/rTorrent alimentés par cette instance ;
conservez les marqueurs par défaut cross-seed-link, cross-seed, ou indiquez le linkCategory, la catégorie ou le tag utilisé par votre installation ;
lancez une synchronisation des clients BitTorrent : le logo cross-seed apparaît discrètement près des trackers et des torrents concernés ;
cliquez sur le logo ou sur Ouvrir cross-seed dans une fiche tracker pour rejoindre directement la bonne WebUI.

Tracker Dashboard identifie les torrents depuis les catégories et tags réellement remontés par le client BitTorrent. Aucune clé API cross-seed n'est nécessaire et aucune route tRPC interne n'est utilisée. Si plusieurs instances alimentent le même client, configurez un marqueur distinct par instance afin de conserver une attribution non ambiguë.

Notifications

Configurables dans Configuration → Notifications, en trois volets :

Canaux : destinations Discord, Apprise ou e-mail.
Notifications globales : échecs, succès, rétablissement après échec, statistiques, MP non lus.
Par tracker : réglages spécifiques (échecs, succès, stats, MP, seuils de ratio / buffer / ancienneté de session) qui priment sur les réglages globaux.

Sécurité proxy

Par défaut, les connexions aux trackers sont bloquées si aucun proxy n'est actif. Pour autoriser les connexions, il faut soit :

configurer et activer un proxy,
cocher explicitement l'option de connexion directe sans proxy (utile si le conteneur sort déjà via un VPN au niveau du réseau Docker).

Cette sécurité s'applique aussi au premier lancement.

Types pris en charge : HTTP, HTTPS, SOCKS4, SOCKS5 et SSH — en proxy global comme en override par tracker.

Proxy SSH

Avec le type SSH, le dashboard ouvre un tunnel SSH (SOCKS5 local adossé au forwarding dynamique) pour sortir via l'IP d'un serveur auquel vous avez un accès SSH.

Renseignez hôte / port / utilisateur, puis un mot de passe OU une clé privée (PEM OpenSSH, passphrase acceptée).
Les secrets sont stockés côté serveur, jamais renvoyés en clair (masqués).
Le bouton Tester établit le tunnel et vérifie l'IP de sortie.

Runtime navigateur

Le navigateur (Playwright/Chromium/CloakBrowser) est externalisé dans l'image ghcr.io/tracker-dashboard/tracker-dashboard-browser:latest. L'image principale reste allégée.

Si vous gérez Tracker Dashboard avec Compose, ajoutez une petite stack parallèle pour le runtime navigateur :

services:
  tracker-dashboard-browser:
    image: ghcr.io/tracker-dashboard/tracker-dashboard-browser:latest
    container_name: tracker-dashboard-browser
    restart: unless-stopped
    network_mode: "container:tracker-dashboard"
    volumes_from:
      - tracker-dashboard

La clé est bien volumes_from au pluriel. volume_from est invalide.

Équivalent en commande Docker :

docker run -d \
  --name tracker-dashboard-browser \
  --restart unless-stopped \
  --network container:tracker-dashboard \
  --volumes-from tracker-dashboard \
  ghcr.io/tracker-dashboard/tracker-dashboard-browser:latest

Avec --network container:tracker-dashboard, Tracker Dashboard joint automatiquement le runtime sur http://127.0.0.1:3001. Avec --volumes-from tracker-dashboard, les profils navigateur et cookies restent sur le même volume ./config. Le service navigateur ne touche pas la base : l'app principale reste la source de vérité et lui transmet ce qu'il faut par appel interne.

Si le runtime navigateur est absent, les trackers en mode: browser affichent une erreur claire et la WebUI donne la commande d'installation. L'état et les versions (Playwright/Chromium/CloakBrowser) sont visibles dans Proxies → Moteur navigateur → Runtime navigateur. La WebUI signale aussi si le runtime navigateur ne correspond pas à la révision de l'application.

Moteur navigateur (CloakBrowser)

Les lectures en mode navigateur utilisent Chromium (Playwright) par défaut. Une option (panneau Proxies → Moteur navigateur) bascule sur CloakBrowser, un Chromium modifié pour présenter une empreinte de vrai navigateur (TLS, fingerprint) et franchir davantage de protections anti-bot. S'il est indisponible, l'app repart automatiquement sur Chromium.

Repli Cloudflare (FlareSolverr)

Tracker Dashboard peut utiliser FlareSolverr en dernier recours lorsqu'un tracker renvoie explicitement un challenge Cloudflare ou anti-bot. Le sidecar reçoit uniquement l'URL, les cookies et le proxy du tracker concerné, résout le challenge dans une session temporaire, renvoie le HTML puis détruit cette session. Les erreurs de credentials, de réseau ou d'extraction ne déclenchent pas ce navigateur supplémentaire. Un tracker connu pour nécessiter FlareSolverr, comme YGGReborn, peut déclarer ce repli en priorité après les lectures HTTP légères.

Le fichier docker-compose.yml fourni inclut déjà ce sidecar. Pour une stack existante, ajoutez :

services:
  tracker-dashboard-flaresolverr:
    image: ghcr.io/flaresolverr/flaresolverr:latest
    container_name: tracker-dashboard-flaresolverr
    restart: unless-stopped
    network_mode: "container:tracker-dashboard"
    environment:
      HOST: 127.0.0.1
      # Évite de journaliser les corps de requête, qui contiennent les cookies de session.
      LOG_LEVEL: warning
      TZ: Europe/Paris

Le partage du réseau du conteneur principal est important : FlareSolverr est alors joignable en interne sur http://127.0.0.1:8191 et réutilise aussi les tunnels SOCKS locaux des proxies SSH. Aucun port FlareSolverr n'est exposé sur l'hôte. Une URL différente peut être fournie avec FLARESOLVERR_URL.

Lecture rapide (curl-impersonate)

curl-impersonate usurpe l'empreinte TLS/HTTP2 d'un vrai Chrome et franchit le filtrage anti-bot passif sans navigateur. Le dashboard l'utilise automatiquement pour le login HTTP complet et pour les trackers navigateur disposant d'un cookie. Le repli est automatique (aucune lecture cassée). Réglage : panneau Proxies → Moteur navigateur → Lecture rapide (activé par défaut).

User-Agent aléatoire

Rotation automatique de User-Agents (paquet top-user-agents) pour les nouvelles sessions HTTP et contextes navigateur.

Sites intégrés & ajout d'un site

Une trentaine de définitions de sites sont fournies dans config/trackers/*.json (un fichier JSON par site : connexion, page à lire, champs à extraire). Les nouvelles définitions sont détectées au démarrage et proposées à l'activation.

Pour préparer l'ajout d'un site, fournissez idéalement : nom, URL de base, URL de login (et méthode particulière éventuelle), URL de la page de stats, son HTML une fois connecté, les valeurs à récupérer, et le CMS éventuel (UNIT3D, Gazelle, Luminance…).

Champs habituels :

Champ	Usage
`uploadedBytes`	Upload
`downloadedBytes`	Download
`ratio`	Ratio
`bufferBytes`	Buffer
`seeding`	Torrents en seed
`seedBonus`	Points bonus
`tokens`	Jetons / tokens
`unreadMessages`	MP non lus

Le ratio peut être calculé depuis upload/download s'il n'est pas exposé ; idem pour le buffer.

Format simplifié d'une définition

{
  "id": "example",
  "name": "Example Tracker",
  "baseUrl": "https://example.org",
  "enabled": false,
  "login": {
    "url": "login",
    "method": "POST",
    "contentType": "form",
    "body": { "username": "{{username}}", "password": "{{password}}" },
    "failurePatterns": ["login"]
  },
  "fetch": {
    "url": "account",
    "mode": "http",
    "responseType": "html",
    "fields": {
      "uploadedBytes": {
        "regex": "Upload[^0-9]*(?<value>[0-9.,]+\\s*(?:GB|GiB|TB|TiB))",
        "transform": "bytes"
      }
    }
  }
}

Transformations disponibles

Transformation	Effet
`bytes`	Convertit `1.5 GB`, `800 MiB`, `2 To`, `276 Gio`… en octets
`number`	Nombre décimal
`integer`	Entier
`string`	Conserve le texte

Remerciements

Autovisit — idée de la prise en charge du 2FA (TOTP).
CloakBrowser — moteur Chromium furtif proposé en option.
FlareSolverr — résolution de challenges Cloudflare via un sidecar interne optionnel.
cross-seed — détection des torrents injectés et logo officiel (licence Apache-2.0).
Et tous les contributeurs qui partagent des définitions de trackers.

Name		Name	Last commit message	Last commit date
Latest commit History 275 Commits
.github		.github
config		config
docs		docs
grafana		grafana
public		public
screens		screens
scripts		scripts
src		src
.dockerignore		.dockerignore
.gitattributes		.gitattributes
.gitignore		.gitignore
Dockerfile		Dockerfile
Dockerfile.browser		Dockerfile.browser
LICENSE		LICENSE
README.md		README.md
docker-compose.yml		docker-compose.yml
package-lock.json		package-lock.json
package.json		package.json
tsconfig.json		tsconfig.json

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Uh oh!

Repository files navigation

Tracker Dashboard

Changements récents

Interface

Fiche d'un tracker

Cookies de session (sites à CAPTCHA / Cloudflare)

Double authentification (2FA / TOTP)

Plusieurs comptes par tracker

Attribution des torrents par passkey

Captures d'écran

Connexions automatiques

Clients BitTorrent

Instances cross-seed

Notifications

Sécurité proxy

Proxy SSH

Runtime navigateur

Moteur navigateur (CloakBrowser)

Repli Cloudflare (FlareSolverr)

Lecture rapide (curl-impersonate)

User-Agent aléatoire

Sites intégrés & ajout d'un site

Format simplifié d'une définition

Transformations disponibles

Remerciements

About

Uh oh!

Packages

Uh oh!

Contributors

Uh oh!

Languages

Uh oh!

Folders and files

Latest commit

History

Repository files navigation

Tracker Dashboard

Changements récents

Interface

Fiche d'un tracker

Cookies de session (sites à CAPTCHA / Cloudflare)

Double authentification (2FA / TOTP)

Plusieurs comptes par tracker

Attribution des torrents par passkey

Captures d'écran

Connexions automatiques

Clients BitTorrent

Instances cross-seed

Notifications

Sécurité proxy

Proxy SSH

Runtime navigateur

Moteur navigateur (CloakBrowser)

Repli Cloudflare (FlareSolverr)

Lecture rapide (curl-impersonate)

User-Agent aléatoire

Sites intégrés & ajout d'un site

Format simplifié d'une définition

Transformations disponibles

Remerciements

About

Resources

License

Uh oh!

Stars

Watchers

Forks

Packages 0

Uh oh!

Contributors

Uh oh!

Languages

Packages