Home

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.

Community documentation is available on the rtorrent-community/rtorrent-docs repository and on ReadTheDocs.

👥 📝 | 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). ---: | :---

Donate to help keep the creators working on this project.

Page Contents

• User's Manual
• Other Information
• Download Links
• Installation
• Packages
• Disclaimer
• Stuff

User's Manual

• 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
  • Auto-Scraping
  • Logging
  • 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.

Other Information

• List of Known Issues
• List of Todos

Download Links

Stable Version

• https://github.com/rakshasa/rtorrent-archive/raw/master/libtorrent-0.13.8.tar.gz
• https://github.com/rakshasa/rtorrent-archive/raw/master/rtorrent-0.9.8.tar.gz

All Versions

• http://rtorrent.net/downloads/

Static Builds

• In this gist.

Installation

See the Installing wiki page for more information on how to compile it, or check the Docker wiki page for a quick deploy.

Packages

rTorrent and libTorrent packages are both available for the following operating systems and distributions:

• Debian and Ubuntu : Run apt-get install rtorrent.

• Fedora : Run dnf install rtorrent.

• Gentoo : in Portage; see latest version on libTorrent and rTorrent.

• ROSA : Run urpmi rtorrent.

• SUSE Linux : latest packages available from Packman for libTorrent and rTorrent.

• Arch Linux : The latest packages are available by installing with pacman -S rtorrent

• Void Linux : maintained version available in the x86-64 repository. Run xbps-install -S rtorrent

• Crux : in the Crux Ports DB; see latest version on libTorrent and rTorrent.

• Lunar-Linux : in the moonbase; to install just lin rtorrent

• Sourcemage GNU/Linux : do a cast rtorrent or cast libtorrent

• NixOS/Nixpkgs : The latest packages are available in Nixpkgs tree, you can using it by doing nix-shell -p rtorrent to open a shell with rtorrent environment.

• FreeBSD : in FreshPorts; see latest version on libTorrent and rTorrent.

• NetBSD : in pkgsrc; net/rtorrent.

• OpenBSD : in ports; net/libtorrent and net/rtorrent respectively.

• OpenDarwin : in ports; net/libtorrent and net/rtorrent respectively.

• macOS : via HomeBrew; brew install rtorrent.

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.

Disclaimer

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 library as libtorrent-rakshasa, and the other one's as libtorrent-rasterbar.

Stuff

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 sundell.software@gmail.com, also an unofficial help channel may be found at ##rtorrent@irc.freenode.net 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.