====== Pour débuter ======

===== Installation =====

La façon recommandée d'installer rtorrent est via les dépots de votre distribution.

Sinon, référez-vous à cette page : https://github.com/rakshasa/rtorrent/wiki#download-links

===== Configuration =====

rtorrent n'est pas le plus pratique à configurer, car il faut éditer à la main le fichier de configuration ''~/.rtorrent.rc''.((L'emplacement du fichier ne peut pas être changé simplement, mais on peut passer les options suivantes en argument: ''-n -o import=~/.rtorrent.rc''))

Depuis la version 0.9, rtorrent propose une nouvelle syntaxe pour sa configuration. Les deux syntaxes ont l'essentiel de leurs mot-clés en commun, la compatibilité avec l'ancienne syntaxe sera cependant désactivée dans les futures versions.

Généralement, on reconnaît la nouvelle syntaxe du fait qu'elle fait davantage usage du "." comme séparateur (bon à savoir si vous lisez des vieilles documentations en ligne).

Pour ne rien vous cacher, bon nombre de personnes s'accordent à dire que la syntaxe de rtorrent ainsi que la façon dont elle évolue sont imbitables. Dès lors que vous souhaitez faire des opérations avancées, nous vous conseillons d'utiliser des outils auxiliaires (rutorrent ou pyrocore) pour les mener à bien...

Pour connaître votre version de rtorrent :
<code>
rtorrent -h | grep version
</code>

Le [[https://github.com/rakshasa/rtorrent/wiki/CONFIG-Template|wiki de rtorrent]] propose un exemple de fichier de configuration à adapter. Si vous souhaitez l'utiliser, vous devrez copier/coller et exécuter les 2 commandes indiquées. La 1ère créé un répertoire nommé "rtorrent" dans votre $HOME, ainsi que ses sous-répertoires. La 2nde récupère le fichier de config sur Github, mais vous pouvez aussi simplement le copier/coller.

Dans le fichier de configuration récupéré, vous devrez remplacer USERNAME par la bonne valeur. Le reste ne semble pas nécessiter d'adaptation.

Liens utiles : 

  * Page man de rtorrent : https://linux.die.net/man/1/rtorrent
  * Wiki de rtorrent : https://github.com/rakshasa/rtorrent/wiki
  * Une doc chez Archlinux : https://wiki.archlinux.org/index.php/RTorrent

===== Utilisation =====

Si tout se passe bien, vous pouvez lancer ''rtorrent''. S'il y a un pépin, revoyez votre fichier ''~/.rtorrent.rc''.

==== Ajouter un téléchargement ====

En ayant le focus sur l'interface de rtorrent, appuyez sur Entrée. Vous verrez alors en bas de l'écran:

<code>load.normal></code>

Il vous suffit alors de faire un copier/coller d'un lien magnet ou directement de l'URL du fichier torrent.

Une fois ajouté, il aura le status [CLOSED]. Vous devrez alors le démarrer.

Positionnez le curseur (les "***" sur le bord gauche de rtorrent) devant le torrent que vous souhaitez démarrer, puis faites CTRL+S. Le téléchargement devrait alors démarrer.

==== Contrôler rtorrent au clavier ====

Les touches permettant de contrôler rtorrent ne se devinent pas facilement, donc la consultation de son manuel est un passage obligé.

Voilà les principales:

=== Les torrents ===

  * ''CTRL+S'', aura pour effet de démarrer le torrent selectionné. 
  * ''CTRL+D'', aura pour effet de mettre en pause le torrent selectionné. Si vous l'utilisez sur un torrent déjà en pause, cela aura pour effet de le retirer de la liste (sans supprimer les fichiers téléchargés).
  * ''CTRL+Q'', pour quitter rtorrent, je ne quitterais pas si j'étais vous, la ligne de commande est bien pire.

=== Le débit ===

Il est aussi possible de gérer le débit maximal:

  * ''x'', ''s'': abaisse, monte l'upload maximum de 5Ko/sec
  * ''c'', ''d'': abaisse, monte l'upload maximum de 50Ko/sec

-> Les mêmes touches, mais en majuscule, affecteront le download.

=== Les vues ===

Par défaut, l'interface de rtorrent affiche la vue «Main». Les touches chiffrées (de 0 à 9) vous permettent de changer de vue, pour ne présenter à l'écran que les téléchargements présentant certaines caractéristiques (démarrés, arrêtés, complets, incomplets, hashing, seeding, leeching...)

==== Régler la priorité des fichiers ====

Si l'un de vos torrents contient plusieurs fichiers (une série...), vous pouvez assigner une priorité de téléchargement en positionnant le curseur sur le torrent (avec les touches flechées du clavier), et faire ''flèche droite''. Vous apercevrez les infos détaillées du torrent, dont la liste des fichiers qu'il contient.

Allez dans «File List», puis à nouveau ''flèche droite''. Il vous suffit ensuite d'appuyer sur ''+'' ou ''-'' (ou ''barre d'espace'' pour les anciennes versions) pour changer la priorité (off, high, aucune) du fichier selectionné.

Si vous positionnez la priorité sur off, le fichier en question ne sera pas téléchargé.

==== Ne pas télécharger certains fichiers ====

Utile si vous souhaitez déplacer certains des fichiers de votre torrent, sans pour autant casser le téléchargement.

Positionnez sur Off la priorité des fichiers déjà téléchargés, puis revenir sur l'interface principale (''Flèche gauche'').

Selectionnez le torrent, et faites ''CTRL+E''. Cela aura pour effet de recréer des fichiers vides à la place de vos fichiers déplacés (donc manquants), et de rendre rtorrent heureux. Vous pourrez alors faire un ''CTRL+S'' pour relancer le torrent.

==== Envoyer une commande ====

rtorrent possède un interpreteur de commandes, accessible par ''CTRL+X''.

==== Autres touches ====

La liste ci-dessus n'est pas exhaustive, d'autres touches utilisables au sein de rtorrent sont décrites dans le man.

  * https://linux.die.net/man/1/rtorrent