Client bittorrent - rtorrent

Dernière mise à jour : Debian 10.6

rtorrent est un client de téléchargement bittorrent ncurse, performant et simple, utilisable par exemple, pour télécharger les images iso de Debian ou autres distributions.

Référence :

1 - Installation

• Installer rtorrent depuis les dépôts :

$ sudo aptitude install rtorrent

2 - Utilisation

2.1 - Lancement

rtorrent peut-être lancé

• avec ou sans fichier de configuration (.rtorrent.rc)
  

• avec ou sans options : voir paragraphe suivant
  

• avec ou sans indication du fichier à télécharger, ce qui a pour effet

• de lancer le téléchargement si le fichier est spécifié

• d'ouvrir une interface ncurse de suivi et de pilotage, dans laquelle des fichiers à téléchargés pourront être rajoutés
  

Exemples d'utilisation :

• Lancement sans indication du fichier à télécharger
  

$ rtorrent

• Lancement après téléchargement du fichier torrent :

• télécharger le fichier torrent

$ wget https://cdimage.debian.org/debian-cd/current/amd64/bt-cd/debian-9.1.0-amd64-netinst.iso.torrent

• puis, lancer rtorrent en spécifiant le fichier torrent

$ rtorrent debian-9.1.0-amd64-netinst.iso.torrent

• Lancement avec indication de l'URL du fichier torrent :
  

$ rtorrent https://cdimage.debian.org/debian-cd/current/amd64/bt-cd/debian-9.1.0-amd64-netinst.iso.torrent

2.2 - Options de la ligne de commande

• Le téléchargement peut-être lancé avec des options spécifiées dans un fichier de configuration ou dans la ligne de commande. Les options en ligne de commande sont décrites ci-dessous

• -n : ne pas charger le fichier de configuration .rtorrent.rc (qui n'existe pas par défaut)

• -p : spécifier le port

• -s : spécifier un répertoire pour créer une session qui permettra de reprendre automatiquement le téléchargement (ici le répertoire courant)

• -d : spécifier le répertoire de téléchargement (par défaut le répertoire courant)

• -o download_rate, -o upload_rate : limiter les vitesses de téléchargement et téléversement, les vitesses sont exprimées en koctets par seconde
  

• -o check_hash : vérifier le hash après téléchargement

2.2.1 - Lancement sans fichier de configuration

• Dans cet exemple
  
• la session et le téléchargement s'effectuent dans le répertoire courant
• les options sont choisies selon les recommandations de https://wiki.archlinux.org/index.php/RTorrent),
  
• adapter la vitesse de téléchargement en fonction des besoins
  

$ rtorrent -n -p 55718-55718 -s ./ -d ./ -o download_rate=1000,upload_rate=20,check_hash=yes debian-9.1.0-amd64-netinst.iso.torrent

• Pour simplifier la commande, il est possible de définir un alias avec les différentes options

$ alias rtorrent='rtorrent -n -p 55718-55718 -s ./ -d ./ -o download_rate=1000,upload_rate=20,check_hash'

2.2.2 - Utilisation avec fichier de configuration

• Par défaut, aucun fichier de configuration n'est présent. Il est possible d'en télécharger un sur le site de l'auteur : https://github.com/rakshasa/rtorrent/wiki/CONFIG-Template

$ curl -Ls "https://raw.githubusercontent.com/wiki/rakshasa/rtorrent/CONFIG-Template.md" \
    | sed -ne "/^######/,/^### END/p" \
    | sed -re "s:/home/USERNAME:$HOME:" >~/.rtorrent.rc

$ mkdir -p ~/rtorrent/

• La commande de lancement devient

$ rtorrent -o download_rate=1000,upload_rate=20,check_hash=yes debian-9.1.0-amd64-netinst.iso.torrent

Le téléchargement s'effectue dans le répertoire ~/rtorrent/download

$ ls ~/rtorrent/
download  log  watch

2.3 - Interface ncurse - partie haute

En partie haute, l'interface ncurse comporte, de haut en bas :

• Le titre du logiciel avec numéro de version, le nom d'hôte de la machine et le pid du processus rtorrent

*** rTorrent 0.9.6/0.13.6 - asus:2240 ***

• Le titre de la vue :
  

[View: main] 

Puis pour chaque torrent téléchargé, sur deux lignes

• Le nom du fichier téléchargé
  

debian-9.1.0-amd64-netinst.iso

• L'avancement du téléchargement :

• Données téléchargées & Taille totale du torrent

94,5  / 290,0 MB

• Les vitesses de téléversement (upload) & de téléchargement (download)
  

0,0  / 101,2 KB

• Données téléversées
  

0,0 MB

• Ratio Données téléchargées / Taille totale du torrent, ce ration prend en compte les éventuelles données téléchargées erronées

[32%]

• Temps estimé restant pour le téléchargement complet (ici 0 jour, 0 heures, 33 minutes)

Od 0:33

• Ratio de partage (données téléversées sur données téléchargées)
  

[   R: 0,00]

2.4 - Interface ncurse partie basse

La ligne en bas de l'écran est commune à tous les téléchargements :

• Vitesses maximum téléversement (upload) et téléchargement (download)
  

Throttle 200/100 KB

• Vitesses courantes de téléversement et téléchargement
  

[Rate   0,1/ 20,4 KB]

• Port de téléchargement du torrent
  

[Port: 6903]

• Voir manuel utilisateur : https://github.com/rakshasa/rtorrent/wiki/User-Guide
  

    [U 0/11] [D 11/14] [H 0/32] [S 14/58/768] [F 1/128]

2.4.1 Réglage des vitesses maximum

Les vitesses maximales de téléchargement et téléversement (pour l'ensemble des torrents) sont réglables :

• Utiliser les touches a,s,d, z,x,c pour ajuster les vitesses de téléversement (upload) :

a | s | d      Increase the upload throttle by 1/5/50 KB.
z | x | c         Decrease the upload throttle by 1/5/50 KB.

• Utiliser les touches majuscules associées, pour ajuster les vitesses de téléchargement (download),
  

A | S | D      Increase the download throttle by 1/5/50 KB.
Z | X | C       Decrease the download throttle by 1/5/50 KB.

2.4.2 Ajout d'un téléchargement

Dans la fenêtre de téléchargement, taper Entrée. La ligne du bas devient :

load.normal>  

Entrer directement le nom du torrent ou bien utiliser la touche Tab pour faire afficher le contenu des répertoires ou utiliser l'auto-complétion ou utiliser les caractères de substitutions, par exemple *.torrent.

2.4.3 Arrêt & reprise téléchargement

• Utiliser les touches Montée et Descente pour sélectionner un torrent : des étoiles apparaissent en marge des lignes correspondant au torrent sélectionné.

• Pour démarrer ou reprendre un téléchargement : ctrl s

• Pour arrêter un téléchargement : ctrl d

• Pour fermer le programme et la console : Ctrl Q
  

Note : Par défaut, le protocole Xon/Xoff est activé (ixon dans la liste des paramètres stty), et intercepte les combinaisons ctrl s et ctrl q

$ stty -a |grep ixon
-ignbrk -brkint -ignpar -parmrk -inpck -istrip -inlcr -igncr icrnl ixon ixoff

Pour le désactiver :

$ stty -ixon
$ stty -a |grep ixon
-ignbrk -brkint -ignpar -parmrk -inpck -istrip -inlcr -igncr icrnl -ixon ixoff

La commande de désactivation de ixon peut-être placée dans ./bashrc pour éviter d'avoir à la retaper à chaque ouverture de shell.