Adding Torrents and Existing Data FR

🇬🇧 English · 🇫🇷 Français

Ajouter des torrents & données existantes

Un torrent entre dans Hydra de trois façons, et il y a deux manières très différentes de traiter des données déjà sur le disque. Bien s'y prendre fait la différence entre « seede instantanément » et « re-télécharge 40 Go que tu as déjà ».

Les trois chemins d'ajout

Chemin	Endpoint	Appelant typique
UI web	bouton Add Torrent	toi
REST natif	POST /api/torrents/upload (multipart file, save_path, mode, category)	scripts
Shim qBittorrent	POST /api/v2/torrents/add	autobrr, *arr, cross-seed

mode vaut race ou hoard (le shim qBit le dérive de la catégorie — voir Catégories & routage).

Deux façons de traiter des données déjà sur disque

Quand tu ajoutes un torrent dont les fichiers sont déjà présents (re-add après un restart, cross-seed du même contenu, ou données déplacées à la main), tu choisis entre :

1. Faire confiance — skip_checking=true (rapide)

L'ajout via shim qBit avec skip_checking=true met le torrent directement en seed mode : aucun hash, il seede tout de suite. C'est le chemin cross-seed / hardlink — instantané, mais il fait confiance aux octets sur disque. S'ils sont mauvais, tu distribues de mauvaises pièces (et un tracker privé peut te hardban). À n'utiliser que quand tu sais que les données sont correctes (ex. tu viens de hardlinker tes propres fichiers vérifiés).

2. Vérifier — recheck (sûr)

Ajoute-le en mode download (sans skip_checking). Si Hydra voit des données déjà présentes au save-path, il hash-check chaque pièce contre le torrent et :

• garde et sert les pièces qui vérifient,
• ne récupère que ce qui manque ou est corrompu,
• bascule en seeding si tout est bon.

C'est automatique à l'ajout quand des données sont présentes, et tu peux aussi le déclencher à tout moment :

• qBit : POST /api/v2/torrents/recheck avec hashes=<infohash>
• natif : POST /api/hoard/torrents/<infohash>/verify

Le recheck est hoard uniquement. Le moteur race n'a pas de piece picker pour enregistrer la vérification par pièce, donc verify/recheck sur un torrent race renvoie une erreur explicite. Recheck ce que tu comptes seeder.

hashes=all est ignoré volontairement. Un recheck de masse sur un hoard de 100k torrents serait une tempête disque. Passe des info-hashes explicites.

Lequel choisir ?

• Cross-seed de tes propres données fraîchement linkées → skip_checking=true (rapide, tu fais confiance).
• Import de données d'ailleurs, re-add après crash, ou incertain → mode download et laisse le recheck établir ce qui est vraiment valide.

Convention de save-path (importante pour les données existantes)

Le recheck (et le seeding normal) ne trouve tes données que si le save-path correspond à là où le moteur regarde :

• Torrent single-file → le moteur lit save_path/<nom>. Passe le dossier parent comme save_path ; le fichier lui-même doit être à save_path/<nom>.
• Torrent multi-file → le moteur lit save_path/<nom>/<fichier…>. Passe le dossier qui contient le dossier racine du torrent.

Si un recheck rapporte 0/N vérifiées sur des données que tu es sûr d'avoir, c'est presque toujours un décalage de save-path (le fichier est un niveau de dossier trop loin). Vérifie le save_path du torrent dans get files / le panneau de détail et aligne-le.

Comportement au boot

Au restart le moteur recharge ses resume et le store durable, donc il ne re-hash pas tout ton hoard — il fait confiance au resume pour ce qu'il avait déjà. Le recheck est pour le cas ajout / à la demande, jamais un scan global au boot.