rTorrent Configuration Cookbook
This page is a collection of configuration recipes and a catalog of problem solutions that goes beyond rTorrent's common tasks wiki page.
Contents
1. Introduction
The following sections contain lists of small recipes to tweak your rTorrent setup, organized by topics. Please use the existing format for all entries here, and the RecipeTemplate for the recipe pages themselves. Also start all recipe links with Recipe/ plus a meaningful description.
You can add a new entry to a list, without providing the linked-to page, to express an interest into some topic. Just copy an existing entry, and change the title to describe what you're looking for.
Also see the list of rTorrent C++ Core Patches for extensions that require re-compiling rTorrent with code modifications.
2. Configuration
Recipes related to extending your configuration in general.
2.1. Basic configuration
2.2. Advanced configuration
3. User interface tweaks
3.1. Internal UI tweaks
3.2. UI tweaks relying on external programs
Terminal multiplexer magic:
Recipe/Rebinding keys and defining keyboard macros using "screen"
Recipe/Adding additional panes to your ncurses view using "screen"
Recipe/Adding additional panes to your ncurses view using "tmux"
The following rely on PyroScope being installed:
The following rely on the PyroScope rTorrent distribution (or its patches applied):
4. Event handling
Recipes that at their core use rTorrent event handling mechanism, i.e. usually invoke scripts triggered by an event.
4.1. Completion handling
Recipe/Move downloaded data to another directory and continue seeding (common task)
Recipe/Move completed torrents to different directory depending on watch… (common task)
5. Torrent management
5.1. Loading and keeping track of .torrent files
Recipe/Saving torrent state and resume data between sessions (common task)
Recipe/Immediately delete .torrent file after loading it from a watch
Recipe/Move .torrent file after loading it manually (common task)
Recipe/Move .torrent file after loading it, including ones loaded from watch directories
5.2. Ratio handling
5.3. Working with .torrent files
Recipe/Adding fast-resume data to .torrent files (common task)
Recipe/Mass-changing the announce URL of active download items (needs PyroScope)
5.4. Various manual management tasks
6. Automation
These recipes show how to do things once, when setting them up, and then let the computer slave at it. After all, that's what they're there for. See also Event handling above for tasks that run when some distinct event occurs.
6.1. Automatic downloading
Recipe/Using FlexGet to download .torrent files from RSS feeds
Recipe/Automatic download of items announced on an IRC channel
6.2. Download item status management
6.3. Data management
Recipe/Delete data files when removing incomplete downloads (common task)
Recipe/Safely delete partial data files when removing incomplete downloads (needs PyroScope)
6.4. Bandwidth management
6.5. Generating (statistical) reports
The following rely on PyroScope being installed:
7. Other recipes
Here is anything that doesn't fit elsewhere.
rTorrent Community Wiki