PluginRatio - Novik/ruTorrent GitHub Wiki

Plugin Ratio

Description

Since version 0.8.5 rtorrent has a capability to set ratio limits for groups of torrents. The plugin allows to manage it conveniently. When the plugin is installed a new section "Ratio Groups" appears in the Settings dialog. Here user can define limits of ratio for some (by default - 8) groups. Assignation of group to one or several torrents is performed by selecting an appropriate option in the context menu of torrents.

Perameters of groups are:

  • Min, % - minimal ratio required to perform a defined Action.
  • Max, % - maximal ratio required to perform a defined Action. It may be omitted.
  • UL, Mb - minimal amount of data to be uploaded before perform a defined Action.
  • Time, h - time when the torrent finish before perform a defined Action.
  • Action - what should be done when a condition is satisfied. It may be Stop the torrent, Remove it or Stop the torrent and clean up the ratio group.

All these conditions may be phrased as "Seed this torrent until it's ratio reach Min and with that uploaded not less than UL megabytes. Stop seeding any way if the ratio has reached Max".

How does it work

When ruTorrent starts first time with plugin Ratio installed, it creates groups with required parameters. As groups are created only after first ruTorrent's start, in the time between start of rtorrent and then first start of ruTorrent defined ratio limits will not work. To avoid this, some special strings should be added to the rtorrent configuration file (see How to start plugins with rtorrent for details).

Additional plugin adjustment

Should be done in the file plugins/ratio/conf.php.

  • MAX_RATIO - the constant defines maximum number of groups. You can change this value to bigger as well as to lesser.

Additional plugin for work

Plugin seedingtime needed for time ratio