= rTorrent-O-Meter =

rTorrent-O-Meter is a simple [http://munin.projects.linpro.no/ Munin] plugin pack for monitoring rTorrent's upload/download speed and/or torrent statistics

 * [#prerequisites Prerequisites]
 * [#installation Installation]
 * [#changelog Changelog]
 * [#download Download]

== Prerequisites == #prerequisites

 * rTorrent 0.7.5 or newer
  * compiled with "--with-xmlrpc-c"
  * XMLRPC-C >= 1.00

== Installation == #installation

Install the plugin, like any munin plugin (e.g.: create a symlink into /etc/munin/plugins), and open the /etc/munin/plugin-conf.d file. Create a section for the installed plugin, and insert the lines shown below:

{{{
[rtom_spd]
user username
env.src socket
env.socket /home/username/torrent/.socket/rpc.socket
}}}

or

{{{
[rtom_spd]
env.ip 127.0.0.1
env.port 5000
}}}

depending on what rTorrent configuration you have.[[BR]]
The same configuration is needed for both plugins.

Configurable variables:

|| src || "socket" when using scgi_socket, or anything else when using scgi_port ||||||
|| socket || rTorrent's rpc socket (scgi_local)	|| using scgi_local || needed, when "src" is set to "socket" ||
|| ip || rTorrent's ip address || using scgi_port || needed, when "src" is NOT set to "socket" ||
|| port || rTorrent's scgi port (scgi_port) || using scgi_port || needed, when "src" is NOT set to "socket" ||
|| diff || "yes" for using bps for upload and Bps for download, or anything else for using Bps for both	|||| used by rtom_spd plugin ||
 
== Changelog ==

 * [#v0.1.0 0.1.0]
 * [#v0.0.1d 0.0.1d]
 * [#v0.0.1 0.0.1]
 * [#v0.0.0 0.0.0]
 * [#legend Legend]

=== 0.1.0 === #v0.1.0

 * * Full rewrite in Perl
 * * Now supports unix domain socket (scgi_local)
 * * Added torrent statistics graph (shows number of started/stopped/incomplete/complete/all torrents)
 * + Speed graph uses get_{up|down}_total to get more actual values (and to make the graph smoother)
 * + Configurable via munin-node's plugin config (environmental variables)
 * - 2008. 05. 23.

=== 0.0.1d === #v0.0.1d

 * - Differet graph scale for upload and download for asymmetric line (upload is in b/s, download is in B/s)
 * - 2008. 02. 29.

=== 0.0.1 === #v0.0.1

 * x Minor textbugs fixed
 * - 2007. 12. 20.

=== 0.0.0 === #v0.0.0

 * - Initial release
 * - 2007. 12. 18.

=== Legend === #legend

 * * New feature
 * + Minor update
 * x Bugfix
 * - Information

== Download == #download

 * [/rtwi/downloads/rtom/rtom-0.1.0-080523.tar.gz Latest release]
 * [/rtwi/downloads/rtom All releases]