🌊
Ashflow
Connexion
Accédez à votre dashboard
Identifiants incorrects.
Contactez votre administrateur pour accéder.
🌊
Ashflow
Principal
🏠Dashboard
⬇TĂ©lĂ©chargements0
MĂ©dias
🎬MĂ©diathĂšque
📅Calendrier sorties
🔍Recherche indexeurs
Configuration
⚡Patterns & QualitĂ©
🌐Indexeurs
📡Clients de tĂ©lĂ©ch.
đŸ‘„Utilisateurs
⚙ParamĂštres
Support
📖Documentation
AD
admin
Administrateur
🏠 Dashboard
En cours
0
—
Bloqués / Timeout
0
Relance auto dispo
Espace utilisé
1.2 TB
sur 4 TB
Ratio upload
2.4
↑ 4.1 MB/s

Téléchargements actifs

NOM
TAILLE
PROGRESSION
VITESSE
STATUT
ACTIONS

Indexeurs

⬇ TĂ©lĂ©chargements
Tous
En cours
Seeding
En pause
BloquĂ©s ⚠
Erreur
NOM
TAILLE
PROGRESSION
VITESSE
STATUT
ACTIONS
🎬 MĂ©diathĂšque
🔍
Source :
TMDB ✓ TVDB ✓ AniList ✓ AniDB + config
Tout
🎬 Films
đŸ“ș SĂ©ries
đŸ—Ąïž Anime
Tous
✓ Dispo
⟳ Manquants
⚡ Autowatch
📅 Calendrier des sorties
Tout
🎬 Films
đŸ“ș SĂ©ries
đŸ—Ąïž Anime
⚡ Prochaines sorties — autowatch activĂ©
Film
SĂ©rie
Anime
Autowatch programmé
Sources : TMDB · TVDB · AniList · AniDB
⚡ Patterns & QualitĂ©
💡 Les patterns dĂ©finissent quels fichiers Ashflow recherche et tĂ©lĂ©charge. Activez/dĂ©sactivez et rĂ©ordonnez selon vos prĂ©fĂ©rences. Les patterns actifs sont utilisĂ©s en recherche automatique et manuelle.
🌍 Langue & Audio
Le premier actif est prioritaire en mode auto
🎬 QualitĂ© vidĂ©o
Du plus au moins prioritaire
⚙ Codec & Source
đŸš« Exclusions
Mots-clés à ignorer dans les résultats
⏱ Timeout — Relance automatique des tĂ©lĂ©chargements bloquĂ©s
Notification sur le dashboard
Suppression et action configurée
Avant d'abandonner définitivement
Action Ă  l'expiration :
⚠ Alerte seulement
🗑 Annuler le DL
🔍 Annuler + relancer recherche auto
💡 Relancer recherche : Ashflow annule automatiquement le torrent bloquĂ© et relance une recherche avec vos patterns actifs pour trouver une alternative.
đŸ‘ïž Aperçu du pattern de recherche gĂ©nĂ©rĂ©
Entrez un titre ci-dessus pour prévisualiser

🌐 Indexeurs
⭐ Mode recommandĂ© — Prowlarr comme proxy
Connectez un seul Prowlarr et accédez instantanément à 500+ indexeurs (Nyaa, TPB, YGG, 1337x
) déjà configurés dans Prowlarr.
Ashflow interroge Prowlarr via l'API Torznab — un standard universel.
✓ Nyaa · ✓ The Pirate Bay · ✓ YGGTorrent · ✓ 1337x · ✓ RARBG · ✓ +500 autres
URL : http://prowlarr:9696/{indexerId}/api?apikey=VOTRE_CLÉ
🔧 Mode direct — indexeurs individuels
Ajoutez chaque site un par un. Limites :
⚠ Nyaa : scraping HTML, fragile
⚠ The Pirate Bay : API souvent down
⚠ Sites privĂ©s : cookies/session requis
Prowlarr gÚre tout ça à votre place.
Indexeurs configurés
Tous
Prowlarr
Direct
📡 Clients de tĂ©lĂ©chargement
🔄 Comment Ashflow envoie les torrents
🔍
Ashflow
Recherche & sélectionne
→
📡
API HTTP/HTTPS
Lien magnet ou .torrent
envoyé via WebUI API
đŸ’Ÿ
Client distant
NAS, PC, Seedbox

sur n'importe quel réseau
💡 RĂ©seau distant (NAS Synology) : tant que l'URL est accessible (IP publique, VPN, ou tunnel), ça fonctionne. Download Station expose une API HTTP sur le port 5000 (HTTP) ou 5001 (HTTPS). qBittorrent expose son WebUI sur le port configurĂ© (dĂ©faut 8080).
🔌 Clients supportĂ©s & compatibilitĂ©
Client
API utilisée
NAS distant
Fiabilité
Clients configurés
🌐 AccĂšs NAS sur un autre rĂ©seau
✓ Via IP publique + port
Ouvrez le port Download Station (5000/5001) ou qBittorrent WebUI sur votre box. Utilisez l'IP publique du NAS.
✓ Via Synology QuickConnect
Synology fournit une URL QuickConnect. Download Station API accessible via https://quickconnect.to/votre-id
✓ Via VPN (recommandĂ©)
WireGuard ou OpenVPN entre les deux réseaux. Ashflow voit le NAS comme local. Aucune exposition publique.
đŸ‘„ Utilisateurs
UTILISATEUR
RÔLE
DERNIÈRE CO.
DL
ACTIONS
⚙ ParamĂštres
🎹 Thùme
Couleur :
📁 Stockage
Téléchargements
/data/downloads
Films
/data/movies
SĂ©ries
/data/series
⬇ TĂ©lĂ©chargement
Vitesse max (↓)
Illimitée
Vitesse max (↑)
2 MB/s
Max simultanés
5 torrents
🌍 MĂ©dias & Patterns
Patterns de langue
FRENCH, VOSTFR

Qualité préférée
4K → 1080p → 720p
Timeout & relance auto
60 min → relancer recherche
Auto-seed (ratio ≄ 1.0)
🔒 SĂ©curitĂ©
Changer mot de passe
Sessions actives
1 session
Inscription ouverte
Sur invitation
2FA
Non configuré
📖 Documentation
DĂ©marrage
Introduction
Installation Docker
Configuration Caddy
Utilisation
Téléchargements
MĂ©diathĂšque
Patterns & Qualité
Timeout & Relance
Admin
Utilisateurs & RĂŽles
Mises Ă  jour
Support
FAQ & Erreurs
v1.0.0 · Self-hosted · Docker · Ultra-léger

Ashflow — Documentation

TMDB TVDB AniList AniDB Prowlarr Docker FastAPI SQLite

Dashboard de gestion de torrents ultra-léger, auto-hébergé. MédiathÚque unifiée Films & Séries, recherche manuelle ou automatique, patterns de recherche configurables, timeout intelligent avec relance auto.

Architecture & ressources

Stack
🐍 Python 3.11 + FastAPI — backend API
đŸ”© libtorrent — client torrent natif
đŸ—„ïž SQLite — BDD fichier unique
🌐 HTML/JS/CSS — frontend statique
Ressources Docker
đŸ’Ÿ ~50–80 MB RAM idle
⚡ <2% CPU idle · pics lors des DL
📩 Image : ~180 MB (Alpine + Python)
🌊 1 seul container — aucun service externe

Sources de donnĂ©es — MĂ©diathĂšque

🎬 TMDB — Films & SĂ©ries
API gratuite. Métadonnées films/séries : affiche, synopsis, note, genres, casting. Clé API gratuite sur themoviedb.org.
https://api.themoviedb.org/3/
đŸ“ș TVDB — SĂ©ries TV
Base de référence pour les séries. Numérotation des épisodes, dates de diffusion précises. Clé API gratuite sur thetvdb.com.
https://api4.thetvdb.com/v4/
đŸ—Ąïž AniList — Anime
Référence pour l'anime japonais. API GraphQL gratuite, sans clé requise. Planning de diffusion hebdomadaire précis.
https://graphql.anilist.co
📋 AniDB — Anime (optionnel)
Base encyclopédique trÚs complÚte pour l'anime. Requiert inscription. Utile pour les titres rares ou anciens.
https://api.anidb.net/

Installation — Docker Compose

version: '3.8'
services:
  ashflow:
    image: ghcr.io/vous/ashflow:latest
    container_name: ashflow
    restart: unless-stopped
    ports:
      - "8080:8080"
      - "6881:6881/tcp"
      - "6881:6881/udp"
    volumes:
      - ./config:/app/config
      - /data/downloads:/downloads
      - /data/movies:/movies
      - /data/series:/series
    environment:
      - TZ=Europe/Paris
      - ADMIN_USER=admin
      - ADMIN_PASS=changeme
docker compose up -d

Configuration Caddy

torrent.mondomaine.fr {
    reverse_proxy ashflow:8080
}
✅ Caddy renouvelle les certificats TLS automatiquement — aucune config supplĂ©mentaire.

Patterns & Qualité

L'onglet ⚡ Patterns & QualitĂ© permet de configurer comment Ashflow cherche et filtre les torrents :

  • Langue : FRENCH, VOSTFR, MULTi
 — ordre = prioritĂ© en mode auto
  • QualitĂ© : 2160p/4K, 1080p, 720p, HDR
 — du meilleur au moins bon
  • Codec/Source : BluRay, WEB-DL, x265
 — filtrage de qualitĂ© technique
  • Exclusions : CAM, TS, HDTS
 — mots-clĂ©s bannis des rĂ©sultats

Recherche : Manuel vs Automatique

  • Manuel (✋) : Vous voyez tous les rĂ©sultats filtrĂ©s par vos patterns actifs. Choisissez librement lequel tĂ©lĂ©charger.
  • Auto (⚡) : Ashflow sĂ©lectionne et tĂ©lĂ©charge automatiquement le meilleur rĂ©sultat selon le critĂšre choisi (max seeds, meilleure qualitĂ©, taille minimale).

📅 Calendrier & Autowatch

Le calendrier affiche les sorties d'épisodes et de films à venir, agrégées depuis TMDB, TVDB et AniList. Il est possible d'activer l'Autowatch par titre :

  • Lorsqu'un Ă©pisode ou un film sort, Ashflow lance automatiquement une recherche sur vos indexeurs avec vos patterns actifs.
  • Si un rĂ©sultat valide est trouvĂ© (respecte les patterns langue/qualitĂ©, exclut CAM/TS), il est envoyĂ© directement au client de tĂ©lĂ©chargement configurĂ© par dĂ©faut.
  • En cas d'Ă©chec (aucun rĂ©sultat valide), Ashflow rĂ©essaie toutes les 2 heures pendant 48 heures.
💡 Astuce : activez l'autowatch sur les sĂ©ries depuis la mĂ©diathĂšque — icĂŽne ⚡ sur chaque carte. Les nouvelles saisons et Ă©pisodes sont dĂ©tectĂ©s automatiquement via TVDB/AniList.

Timeout & Relance automatique

Si un téléchargement stagne (vitesse zéro), Ashflow peut réagir automatiquement selon la configuration :

  • Alerte (dĂ©faut 30 min) : Badge ⚠ sur le dashboard, notification visible
  • Action (dĂ©faut 60 min) : selon le mode choisi :
  • Alerte seulement : notification uniquement
  • Annuler : supprime le torrent bloquĂ©
  • Annuler + Relancer : annule et relance automatiquement une recherche sur les indexeurs avec vos patterns actifs
⚠ Sauvegardez ./config avant toute mise Ă  jour (contient la BDD SQLite).

RĂŽles utilisateurs

  • Admin : accĂšs complet — patterns, indexeurs, users, paramĂštres
  • Utilisateur : peut tĂ©lĂ©charger et gĂ©rer ses torrents
  • InvitĂ© : lecture seule — mĂ©diathĂšque uniquement

Ajouter un torrent

Lien magnet ou fichier .torrent
📎 Glisser-dĂ©poser ou cliquer

Ajouter à la médiathÚque

Recherchez un titre — tĂ©lĂ©chargement automatique via vos patterns actifs
🎬

Recherchez un titre

Ajouter un indexeur

Connectez une source de torrents directement ou via Prowlarr
⭐ Prowlarr (recommandé)
🔧 Indexeur direct
⭐ Prowlarr centralise 500+ indexeurs (Nyaa, TPB, YGG
). Configurez-les une fois dans Prowlarr, Ashflow les importe tous.

Créer un compte

Ajoutez un utilisateur Ă  Ashflow

🔍 Relancer la recherche

Choisissez un remplacement pour le torrent annulé

Ajouter un client de téléchargement

DĂ©finissez oĂč Ashflow envoie les torrents Ă  tĂ©lĂ©charger