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
Automated rTorrent-PS-CH configuration
An almost completely automated setup with the patched version of
rTorrent-PS, rTorrent-PS-CH (requires v1.8.3-0.9.7 or newer) that doesn't need any additional UI only an SSH client (with the help of
tmux), with category support, requiring the least amount of human interaction, including config files/scripts/instrucions for FTP, Samba, email reporting and many more.
It's all about seeding data all the time until we can (unfortunately we have to download it before :) ). This is not the official PyroScope way to do things, I have to start with this. :) The project has been started around late 2014 with the curiosity of how many really useful things can be done with pure
rtorrent. As it turned out a lot.
The whole setup is based on an advanced version of Stefano's idea of download manager: it relies on moving data AND meta files all around the place. Please take the time and read more about Queue Manager.
It also includes some really unique ideas, so there's no need for ratio groups, stopping/starting torrents (either manually or by a script), deleting anything manually: it runs every torrent all the time, favours one group of torrents over 2 other groups of them and if it run out of space it'll try to create more by deleting old ones. These features alone make this setup so powerful! :)
This setup runs on a laptop from 2008 with dualcore CPU and 4GB of RAM with Ubuntu 14.04 (probably all other Debian flavor works fine, I don't know about the rest) and a 4TB HDD hooked up via ESATA with a net connection of 74/20 Mbps. It never stops until it gets power. :)
"Why is it just almost completely automated?" Well, because you, dear adventurer, have to figure out by yourself how to automate downloading of torrents, e.g. using flexget or writing your own script (there's also a sample download script).
"What?! Is there any?!" Well, yes. :) The following is not supported (mainly because of
auto-rotating torrents feature in queue script and lack of interest :) ):
- multiple disk device support (only 1 disk is supported) (read more: #77)
"OK, I can live with that, so what can it do?" Good question, let's see (most important ones come first):
- it's disabled by default (you have to enable it with
AUTOROTATETORRENTS=truein queue script)
- favouring one group of torrents over 2 other groups of them (read more)
- hash-checking dropped data (read more)
- full magnet link support (read more)
- p2p blocklist support (read more)
- regularly updates scrape information for all torrents (read more)
- extra columns on the fully customizable extended canvas (read more)
- sending email reports automatically (read more)
- logging major events on screen and into file (read more)
- regularly backup session dir of
rtorrent(with the help of backup script)
tmuxif it's not running (with the help of init script)
- providing config files / instructions for setting up / using FTP , Samba, SSH (e.g. for Windows)
- providing instructions for using it On-the-Road with an Android device (read more)
- and a lot more :)
"Sounds awesome! What else?" There are extra stuff defined in all over the setup:
variables in rtorrent:
attributes in rtorrent:
commands in rtorrent:
views in rtorrent:
keyboard shortcuts in rtorrent:
#send manual scrape request,
Tclear tag view,
_toggle visibility of specified columns,
|toggle selectable themes,
=toggle autoscale network history,
F2display quick help,
^qDISABLED (used to exit rtorrent)
rtorrent init script
See Additions page for more details.
"The whole thing is a little bit confusing now." Let's try to show how simple the workflow is:
- download/upload/copy a torrent file into one the subdirs of
.queuedir (the queue script will pick it up)
- alternatively put hash-checkable data into
incompletedir and put its meta file into one the subdirs of
.downloadingdir (hash-checking will start immediately)
- when download/hash-check is finished data and meta will be moved into it's final place
- you can move it to a different category later using this command in
- you can simply put it into delete queue by pressing } key multiple times
- you can still delete a torrent manually if you insist by
It's really that simple. :)
"It indeed looks easy. What if I encounter a problem?" Then see Hints and possible issues WIKI page for more details.
"It's kind'a cool! The problem is that I have already a working setup. What shall I do?" It's easy:
- make a backup first :)
- set up everything according to the new setup
- hash-ckeck all the existing data with the new setup (it will take care about everything else)
"Woow! But what about my previous local stats?" Well, nothing comes for free. :)
"Okie, I kind'a like it. What should I do now?" Well, go through the detailed Installation instructions, although it won't be a 5 minutes task :) , so let's summarize it first:
rTorrent-PS-CH(v1.8.3-0.9.7 or newer) and
- go through all the files in this project and modify them according to your setup/needs
- if you find a missing command on your system then install it (although every command should be covered by the Installation instructions)
- if you don't use a Debian based OS then you have to check every command switch whether it's compatible with your system
"Oh, my ... That's a lot of work!" Well, it took way more time to create it and document it. :) Good news is: you only have to do it once. :)
"Huhh, I finally managed to set it up, but what values should I use in rTorrent config?" Take a look at the official rTorrent WIKI page.
"All's good now." See CHANGELOG.md for more details.
"I just got data deleted!" Be careful! This setup can and will delete your data if you ask for it!
auto-rotating torrents feature in queue script (it's disabled by default) if you understand the basic concept of this setup and you configured everything as it should be!
This setup doesn't take any responsibility for data loss for any reason.
"That's awesome!" Thanks to the following people, sites:
- Rakshasa for this amazing client
- Pyroscope for his truly beautiful rtorrent-ps patches , pyrocore utilities, rTorrent Handbook for useful examples
- archlinux rtorrent wiki for useful examples and the idea of moving data and meta file of torrents
- the lost rtorrent docs with the help of web.archive.org
- Stefano for the original idea of queue manager
- anybody who has ever contributed in any way