# transmission-client: A Transmission RPC Client
The goal is to support all requests described in the Transmission [RPC Specifications](trac.transmissionbt.com/browser/trunk/doc/rpc-spec.txt).
## Installing You need to have gemcutter.org in you gem sources. To add it you can execute either
sudo gem install gemcutter sudo gem tumble
sudo gem source -a gemcutter.org
To install transmission-client:
sudo gem install transmission-client
If you want to use EventMachine (optional) you need to install the eventmachine gem and igrigorik's em-http-request: sudo gem install eventmachine sudo gem install em-http-request
## Usage Get a list of torrents and print its file names:
require 'transmission-client' t = Transmission::Client.new('127.0.0.1', 9091) t.torrents.each do |torrent| puts torrent.name end
To use the EventMachine driven interface:
require 'eventmachine' require 'transmission-client'
EventMachine.run do t = Transmission::Client.new EM.add_periodic_timer(1) do t.torrents do |torrents| torrents.each do |tor| puts tor.percentDone end end end end
RDoc is still to be written, at the meantime have a look at the code to find out which methods are supported.