rtorrent

Der Shell-Befehl rtorrent (auch: Rtorrent, rTorrent) ist ein in C++ programmierter Bittorrent-Client und basiert auf der Bibliothek Libtorrent. Ausserdem nutzt es zur Darstellung die Programmbibliothek Ncurses und ist damit geeignet um es mit den Shell-Befehlen screen oder dtach zu verwenden.

Installation

Ubuntu 8.04 Hardy Heron

$ sudo apt-get install rtorrent

Verwendung

Nach dem ersten Aufruf erscheint eine recht leere Oberfläche.

$ rtorrent
                 *** rTorrent 0.8.0/0.12.0 - kanzler:20518 ***
[View: main]

...

(16:50:46) Using 'epoll' based polling.
(16:50:46) Could not read resource file: ~/.rtorrent.rc
[Throttle off/off KB] [Rate   0.0/  0.0 KB] [Port: 6955] [U 0/0] [D 0/0] [H 0/3

Eine erste Torrent-Datei wird hinzugefügt, indem zuerst die Taste RETURN gedrückt und dann am Prompt am unteren Fensterrand der Pfad zur Datei angegeben wird. Die Pfadangabe wird am besten mit absolutem Pfad gemacht, sie kann aber auch mit relativem Pfad gemacht werden, ausgehend vom Verzeichnis, aus dem heraus rtorrent gestartet wurde. Ähnlich wie in einer Shell zeigt das Drücken der TAB-Taste mögliche Datei- und Verzeichnisnamen an.

                 *** rTorrent 0.8.0/0.12.0 - kanzler:20646 ***
[View: main]

...

(16:58:01) Using 'epoll' based polling.
(16:58:01) Could not read resource file: ~/.rtorrent.rc
load> /MUSIC/Yo La Tengo - 2006-01-01 Hanukkah Night 8.torrent

Danach sieht die Oberfläche so aus:

                 *** rTorrent 0.8.0/0.12.0 - kanzler:20646 ***
[View: main]
   Yo La Tengo - 2006-01-01 Hanukkah Night 8
  [CLOSED]     0.0 /  895.7 MB Rate:   0.0 /   0.0 KB Uploaded:     0.0 MB
  Inactive:

...

(16:58:01) Using 'epoll' based polling.
(16:58:01) Could not read resource file: ~/.rtorrent.rc
[Throttle off/off KB] [Rate   0.0/  0.0 KB] [Port: 6912] [U 0/0] [D 0/0] [H 0/3

Wurden mehrere Bittorrents hinzugefügt, so kann mit den Pfeiltasten zwischen den einzelnen Bittorrents hin- und her gewechselt werden.

Neu hinzugefügte Bittorrents starten nicht automatisch. Sie werden angestossen, indem sie über die Pfeiltaste angewählt und die Tasten CTRL+S gedrückt werden. Mit CTRL+D wird das Herunterladen angehalten. Ein bereits angehaltener Bittorrent kann durch erneutes Drücken von CTRL+D aus der Liste gelöscht werden. Mit CTRL+Q wird rtorrent beendet.

Die Hauptansicht zeigt die wichtigsten Informationen kurz zusammengefasst. Die erste Spalte (hier "20.6") nennt die bereits heruntergeladene Datenmenge, die zweite die gesamte Dateigrösse (hier "895.7 MB"). Die dritte und vierte Spalte nennen die Datenübertragunsgrate (hier "Rate: 0.0 / 36.5 KB") fürs Hinauf- bzw. Herunterladen dieses Bittorrents. Die fünfte Spalte nennt die vom eigenen Bittorrent-Client hochgeladene Datenmenge (hier "Uploaded: 0.0. MB"). Die letzte Angabe (hier "[ 2%]") gibt an, welcher Anteil der Datei bereits auf der lokalen Festplatte gespeichert ist.

                  *** rTorrent 0.8.0/0.12.0 - kanzler:20781 ***
[View: main]
*  Yo La Tengo - 2006-01-01 Hanukkah Night 8
*             20.6 /  895.7 MB Rate:   0.0 /  36.5 KB Uploaded:     0.0 MB [ 2%]
*

...

(17:09:31) Could not create download, the input is not a valid torrent.
[Throttle off/off KB] [Rate   0.0/  5.7 KB] [Port: 6881] [U 0/0] [D 1/0] [H 0/3 

Wurde mit den Pfeiltasten ein Bittorrent markiert, so kann mit PFEIL_RECHTS in die Detailanzeige für diesen Bittorrent gewechselt werden. In dieser neuen Ansicht kann wieder mit den Pfeiltasten zwischen den einzelnen Punkten gewechselt werden.

• Die Peer list zeigt Informationen darüber, mit welchen anderen Peers die Anwendung in Kontakt steht. In den Spalten verstecken sich unter anderem die individuelle Datenübertragungsrate für das Hinauf- bzw. Herunterladen.
• Info zeigt einige allgemeine Informationen zum Bittorrent bereit - unter anderem die Anzahl und Grösse der einzelnen Stücke (engl. chunks), aus denen die Datei besteht.
• Im Punkt File list wird mit PFEIL_RECHTS in die Dateiliste gewechselt, wo mit der Leertaste diejenigen Dateien markiert werden können die mit erhöhter Priorität ("hig") heruntergeladen werden sollen bzw. auf die verzichtet wird ("off"). Mit PFEIL_LINKS wird diese Ansicht wieder verlassen.
• Chunks seen gibt Aufschluss darüber, welche Seeder welches Stück anbieten: Jede Zahl bzw. jeder Buchstabe vertritt dort ein Stück der Datei und gibt an, wieviele andere Peers dieses Stück bereithalten. Die Anzeige erfolgt quasi im Hexadezimalsystem: "0" steht für keine Peers, "A" für bis zu 10 und "F" für über 15 Peers. Tauchen in der Ansicht viele Nullen auf, so lässt sich dieser Bittorrent womöglich nicht ganz zuende laden. Normal angezeigte Buchstaben stehen für bereits heruntergeladene Dateistücke, fett geschriebene für noch ausstehende. Ist der Buchstabe schwarz hinterlegt, so wird das betreffende Dateistück gerade geladen.

               *** Yo La Tengo - 2006-01-01 Hanukkah Night 8 ***
                 IP              UP     DOWN   PEER   C/RE/LO  QS    DONE  REQSN
Peer list        24.14.30.126    0.0    37.8   0.0    l/Un/ci  0/17  100   1629u
               Torrent 1.8.2.0
Info

File list

Tracker list

Chunks seen

Transfer list

...

             43.9 /  895.7 MB Rate:   0.0 /  36.8 KB Uploaded:     0.0 MB [ 4%
Peers: 1(0) Min/Max: 40/100 Uploads: 15 U/I/C/A: 0/0/1/0 Failed: 0
[ :597]
[Throttle off/off KB] [Rate   0.0/ 36.9 KB] [Port: 6881] [U 0/0] [D 1/0] [H 0/3

FAQ

rtorrent in einer screen-Sitzung

In der Praxis hat es sich bewährt, rtorrent unabhängig von KDE oder Gnome in einer screen-Sitzung zu starten. Dazu wird in einem Terminalfenster folgender Befehl eingegeben. rtorrent läuft dann auch weiter, wenn das Terminalfenster geschlossen wird oder der X-Server abstürzt.

$ screen -S rtorrent rtorrent

Mit folgendem Befehl kann jederzeit innerhalb einer SSH-Sitzung nach den laufenden Bittorrents gesehen werden.

$ screen -rd -S rtorrent