= rTorrent-O-Meter =

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

 * [#Prerequisites Prerequisites]
 * [#Installation Installation]
 * [#Changelog Changelog]
 * [#Download Download]

== Prerequisites ==

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

== 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_spdd]
user username
env.src socket
env.socket /home/username/torrent/.socket/rpc.socket
end.diff yes
}}}

or

{{{
[rtom_spdd]
env.ip 127.0.0.1
env.port 5000
env.diff yes
}}}

depending on what rTorrent configuration you have.[[BR]]
The same configuration is needed for all 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 displaying bps for upload and Bps for download, or anything else for using Bps for both	|||| used by rtom_spd plugin ||
 
== Changelog ==

 * [#v0.2.0 0.2.0]
 * [#v0.1.0d 0.1.0d]
 * [#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.2.0 === #v0.2.0

 * * New plugins for monitoring rTorrent's memory usage, torrent count, and peer count
 * + rtom_spdd displays upload and download limit on the graph
 * x Fixed bug, where rtom_spd stopped working on 32bit integer overflow (when using XMLRPC-C < 1.07)
 * - rtom_spd is now obsolete, use rtom_spdd instead
 * - 2008. 06. 19.

=== 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 ==

 * [/rtwi/downloads/rtom/rtom-0.2.0-080619.tar.gz Latest release]
 * [/rtwi/downloads/rtom All releases]