////////////////
// rtorrent.1.txt
// Asciidoc source for rtorrent manpage
// Lee Bigelow <ligelowbee@yahoo.com>
// Use as you will.
//
// processed to manpage with:
//     asciidoc -b docbook -d manpage rtorrent.1.txt
//     docbook2x-man rtorrent.1.xml
//        (or use: xmlto man rtorrent.xml)
// processed to html with:
//     asciidoc -b css-embedded -d manpage rtorrent.1.txt
////////////////

RTORRENT(1)
===========
Jari Sundell <jaris@ifi.uio.no>
v0.1.5, 9 April 2005

NAME
----
rtorrent - rakshasa's ncurses bittorrent client using libtorrent

SYNOPSIS
--------
*rtorrent* [-b ip] [-i ip] [-p portrange] [-d directory] [-s directory] [-h]

DESCRIPTION 
----------- 
The rtorrent command starts a ncurses based bittorrent downloading front-end
that uses libtorrent to control multiple bittorrent downloads.  

OPTIONS 
-------
-b <a.b.c.d>::      
    Bind the listening socket to this IP.
-i <a.b.c.d>::
    Set the IP address sent to the tracker.

-p <a-b>::
    Open a port in the range a to b.

-s <dir>::
    Use <dir> as the session directory. The torrents will be
    saved with the info-hash in hex as the filename.

KEYBOARD CONTROLS
-----------------
All:
~~~~

....................................
Ctrl-q  Quit

a       Increase Throttle by 1 KiB
z       Decrease Throttle by 1 KiB

s       Increase Throttle by 5 KiB
x       Decrease Throttle by 5 KiB

d       Increase Throttle by 50 KiB
c       Decrease Throttle by 50 KiB
....................................

In main window:
~~~~~~~~~~~~~~~

.............
Backspace  Activate text input for inserting urls/file
           paths. Arrows/C^f/C^b for navigation, enter/C^m.

Up/Down    Select torrent

Right      View torrent

Ctrl-s     Start torrent
Ctrl-d     Stop/delete torrent
...............


In torrent view:
~~~~~~~~~~~~~~~~

...............
Up/Down  Select peer

Left     Back to main

Right    View files
p        View peer
o        View trackers

1        Decrease max uploads
2        Increase max uploads

3        Decrease min peers connected
4        Increase min peers connected

5        Decrease max peers connected
6        Increase max peers connected

t        Query tracker

*        Snub peer
.............

In file view:
~~~~~~~~~~~~~

............
Up/Down   Select file

Left      Back to torrent view

SpaceBar  Change file priority
............

RESOURCES
---------

Homepage for libtorrent and rtorrent:: 
    * http://libtorrent.rakshasa.no[]

Mailing list for libtorrent and rtorrent:: 
    * Go to http://rakshasa.no/mailman/listinfo/libtorrent-devel[] to 
      subscribe to the mailing list
    * Send your emails to the list at <mailto:libtorrent-devel@rakshasa.no[]>
        
    

COPYING
-------

Copyright (C) 2005 Jari Sundell

This program is free software; you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation; either version 2 of the License, or
(at your option) any later version.

This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
GNU General Public License for more details.

You should have received a copy of the GNU General Public License
along with this program; if not, write to the Free Software
Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA

AUTHOR
------

Jari Sundell <mailto:jaris@ifi.uio.no[]>

BUGS
----

Send bug reports to the authors email address or to the mailing list for libtorrent.
