README

rtorrent-init-script by Super Jamie <jamie@superjamie.net>

This is an initscript to run rTorrent on CentOS and Fedora

## Installation

* Put it at /etc/init.d/bittorrent and make it executable

    chmod +x /etc/init.d/bittorrent

* Add to chkconfig

    chkconfig --add bittorrent

* Set to start on system startup if desired

    chkconfig bittorrent on

* If you want non-root users to be able to control it, put this in your
  visudo, replace "username" with your non-priveledged username

    username localhost=NOPASSWD:/etc/init.d/bittorrent*

* Setup an alias to the script in the user's ~/.bashrc

    alias bittorrent='/etc/init.d/bittorrent'
    alias bt='bittorrent'

## Requirements

* screen and rtorrent

* A non-priveledged user to run rtorrent, this can either be a new user
  just to run torrents, or an existing user

* Absolute session path in the .rtorrent.rc file

    session = /home/rtorrent/.session  ## this is good
    session = ~/.session               ## this will break
    session = .session                 ## so will this

  Paths for other actions such as monitoring directories for .torrent files
  and auto-moving complete downloads don't have to be absolute.

## Usage

* Control the daemon with
  bittorrent start, bittorent stop, bittorrent restart

* Get information about the daemon with
  bittorrent status, bittorrent info

* Connect to the screen session with
  bittorrent connect
  (press ctrl+a then d to disconnect)

## Licensing

Released under GNU GPL v3 - http://www.gnu.org/licenses/