-
-
Notifications
You must be signed in to change notification settings - Fork 416
Config Guide
Contents
See rTorrent Configuration Template for a modern rTorrent configuration that provides a good starting point. The following sub-sections describe some of the essential settings you must have in a common configuration.
Adding the session.path.set command will enable session management, which means the torrent files and status information for all open downloads will be stored in this directory. When restarting rTorrent all torrents previously loaded will be restored. Only one instance of rTorrent should be used with each session directory, though at the moment no locking is done. An empty string will disable the session handling.
The client may be configured to check a directory for new torrents and load them. Torrents loaded in this manner will be tied to the file's path. This means when the torrent file is deleted the torrent may be stopped (requires additional configuration), and when the item is removed the torrent file is, too. Note that you can untie an item by using the U key (which will delete the tied file), and using ^K also implictly unties an item.
# Watch directories (add more as you like, but use unique schedule names)
schedule = watch_start,10,10,((load.start,"./watch/start/*.torrent"))
schedule = watch_load,15,10,((load.normal,"./watch/load/*.torrent"))See also the Watch Directories page.
These pages and the following sections cover information that you don't need when you start out (i.e. read at your leisure), or only apply to a small number of users.
- Ratio Handling
- Tor Proxying
- Using DHT
- Using XMLRPC with rTorrent
- Performance Tuning
- Favoring one group of torrents over the rest of them
Using the ''-i '' flag or ''"ip = "'' option you may change your ip address that is reported to the tracker. If you have a dynamic ip address then ''"schedule = ip_tick,0,1800,ip=my_address"'' may be used to update the ip address every 30 minutes.
The client may spend as much as 60 seconds trying to contact a UDP tracker, so if you are behind a firewall that blocks the reply packets you should tell the client to skip the UDP tracker. Set "use_udp_trackers = no" in your configuration file or in the command line option.