Join GitHub today
GitHub is home to over 28 million developers working together to host and review code, manage projects, and build software together.Sign up
Clone this wiki locally
RTorrent and LibTorrent Wiki
The rTorrent bittorrent client uses ncurses and is ideal for use with tmux, screen or dtach. Alternatively, version 0.9.7+ has a built-in daemon mode disabling the user interface, so you can only control it via XMLRPC. It supports saving of sessions, allows the user to add/remove torrents, and much more.
| This wiki is editable by any GitHub user, and thus the often-expressed wish for a complete and current manual depends on YOU. See Mastering Wikis and Mastering Markdown, it's NOT science.
The TODO page has a list of pending work items. See About this Wiki… for more information on how you can contribute, and the structure of this wiki (i.e. where to put things). ---: | :---
- the User Guide explains how to use the ‘curses’ UI, and what the displayed information actually means.
- the Configuration Guide helps you to adapt rTorrent to serve your needs.
- rTorrent Configuration Template
- Watch Directories
- Ratio Handling
- Tor Proxying
- Using DHT
- Using XMLRPC with rTorrent
- Performance Tuning
- Favoring one group of torrents over the rest of them
- Migration to the 0.9.x command syntax
- Common Tasks in rTorrent
- Choke Groups
- IP filtering
- rTorrent 0.9 Comprehensive Command list
- Using initial seeding
- the Scripting Guide allows ‘power users’ to extend rTorrent's configuration with more complex logic, and control it remotely via XMLRPC.
- the Vagrant repository allows easy creation of a test environment for the client.
See the Installing wiki page for more information.
rTorrent and libTorrent packages are both available for the following operating systems and distributions:
Fedora : Run
dnf install rtorrent.
Mandriva Linux : the latest packages are available from the Cooker contribs.
ArchLinux : The latest packages are available by installing with
pacman -S rtorrent
Lunar-Linux : in the moonbase; to install just
Sourcemage GNU/Linux : do a
NixOS/Nixpkgs : The latest packages are available in Nixpkgs tree, you can using it by doing
nix-shell -p rtorrentto open a shell with
OpenDarwin : in ports;
Please report any package related problems to the package maintainers. Listing of a package here does not imply it has been tested or approved by the author.
This is not the same
libtorrent project as the one used by Deluge and some other clients.
If you want to be precise and avoid confusion, refer to this project's
libtorrent-rakshasa, and the other one's as
Feel free to add content as I'm probably not going to write much ATM. Some kind of user guide would be really nice. By committing tickets, wiki changes, etc. you agree to license them under the GNU GPL. Remember to add a short comment describing the changes.
This project is developed by Jari Sundell, "Rakshasa", a former student of computer science, math and Japanese at the University of Oslo. He can be reached on firstname.lastname@example.org, also an unofficial help channel may be found at
##email@example.com which should be used for user-support.
If you didn't get a reply to a mail sent to this address, it may either mean he is busy, has a rather full inbox or that you should have searched the internet first.