Welcome to the “rTorrent Handbook”!

This is a comprehensive manual and user guide for the rTorrent bittorrent client, written by and for the community. See also the homepage of the community project and the community wiki.

rTorrent is written in C++ and uses the ncurses library to provide a textual user interface. It can be used in a (SSH) terminal session together with a terminal multiplexer like tmux, providing a very lean bittorrent solution. Using its XMLRPC remote control API, alternative user interfaces can be provided by web clients like ruTorrent, or command line clients like pyrocore and its rtcontrol command.

The Overview chapter offers you a guided tour through this manual, or browse through the table of contents below to find what you’re looking for.

If you like what is here but are missing something, the best way to fill that hole is to pour what you know into it. Every contribution counts, and instead of lamenting the situation, please go fix it by taking small steps in the right direction. If everyone chimes in, we all profit in the end.

Contributing Guidelines tells you more about how to add your changes to the project.

Contents of This Manual

Indices & Tables