rtgui for Debian
----------------


 CONFIGURATION:
 --------------
 'rtgui' Debian package delivers preconfigured files as examples.
 These files can be found under /usr/share/doc/rtgui/examples folder.

 Adjust settings in these files to match your needs: 



 EXAMPLE CONFIGURATION:
 ---------------------

 The example file /usr/share/doc/rtgui/examples/rtorrent.rc.gz assumes
 the following directory structure. Adjust these settings according to
 your needs.


   Torrents	
   ├── Complete             : Files are moved here when complete (see "on_finished")                                       
   ├── Downloading          : Temporary location for torrents while downloading (see "directory")
   │   └── rtorrent.session : For storing rtorrent session information.
   └── TorrentFiles         : 
        └── Auto            : The 'autoload' directory for rtorrent to use.
                              Place a file in here, and rtorrent loads it #automatically.
                              (see "schedule = watch_directory")

  If ~/.torrent.rc file does not exist yet, you can use the example file
  /usr/share/doc/rtgui/examples/rtorrent.rc.gz



 File: ~/.torrent.rc:
 --------------------
 Adjust settings according to your needs. 

 Add the parameter:

    scgi_local = 127.0.0.1[:port]

  to avoid rtorrent log messages like:

  (10:17:58) The SCGI socket is bound to a specific network device yet may
  still pose a security risk, consider using 'scgi_local'



 File: /etc/rtgui/config.php:
 ----------------------------
 Set these variables to match your rtorrent.rc file


   // rtorrent 'watch' directory (used for upload torrent)
   $watchdir="~/Torrents/TorrentFiles/Auto";
 or
   $watchdir="<PATH_TO_YOUR_TORRENT_DIRECTORY>/Torrents/TorrentFiles/Auto";


   // Path to report disk usage
   $downloaddir="~/Torrents";
 or
   $downloaddir="<PATH_TO_YOUR_TORRENT_DIRECTORY>/Torrents";


  IMPORTANT: In order to allow rtgui web interface to calculate the disk stats, 
  '$downloaddir' directory must be readable by the user running apache,
  (normally: www-data)

  An example 'rtorrent.rc' configuration file is delivered with 'rtgui' Debian
  package and can be found under /usr/share/doc/rtgui/examples directory.



 Add torrents using the web interface:
 -------------------------------------
 The watch ($wathcdir) directory must be writable by the webserver in order to
 use "Add Torrent" feature available via the web interface.

 For values expressed in example files, you should run the following commands:

	Change permissions on your watch directory.

		$ chmod 664 ~/Torrents/TorrentFiles/Auto

	Change ownership on your watch directory.

		$ chgrp www-data ~/Torrents/TorrentFiles/Auto



 -- Dario Minnucci <midget@debian.org>  Sat, 19 Feb 2011 15:01:14 +0100
