From ArchWiki
< RTorrent
Revision as of 07:08, 11 July 2013 by Kynikos (talk | contribs) (Installation: use AUR template)
Jump to: navigation, search

Template:Article summary start Template:Article summary text Template:Article summary end

wTorrent is a web interface to rtorrent, a high performance console based BitTorrent client. It uses rtorrent's build-in xmlrpc server to communicate with it.

wTorrent is programmed in php using Smarty templates and XMLRPC for PHP library. wTorrent also uses javascript for rendering the page with AJAX, Scriptaculous and ShadedBorders.

wTorrent with Apache


Install the dependencies: rtorrent, apache, php, php-apache, php-sqlite, php-curl, mod_scgiAUR.

Note: Wtorrent is now available in the AUR with the wtorrent-svnAUR package.


After you install the packages you need to install the mod_scgi module for Apache:

$ wget http://quixote.python.ca/releases/scgi-1.13.tar.gz 


$ wget http://python.ca/scgi/releases/scgi-1.13.tar.gz
$ tar xf scgi-1.13.tar.gz
$ cd scgi-1.13/apache2
$ sudo apxs -i -c mod_scgi.c


Adding mod_scgi to httpd.conf

Edit /etc/httpd/conf/httpd.conf.

Locate the LoadModule lines and add:

LoadModule scgi_module modules/mod_scgi.so

Add to the end of the file:


Save the file and quit.

Enabling SQLite in php.ini

Edit /etc/php/php.ini.

Locate & un-comment the following:



PHP is practically available out of the box now.

  • Add these lines in /etc/httpd/conf/httpd.conf:

NOTE: Place them at the end of "LoadModule" list or bottom of the file.

LoadModule php5_module modules/libphp5.so
Include conf/extra/php5_module.conf
  • Restart the Apache service to make changes take effect (as root):

Restart Apache

$ sudo /etc/rc.d/httpd restart

Final steps

Add the following to your ~/.rtorrent.rc:

scgi_port = localhost:5000

Get the latest version of wtorrent & install to your web directory:

# cd /srv/http
# svn co http://svn.wtorrent-project.org/wtorrent/trunk/wtorrent/
# chmod -R 777 wtorrent

Start rtorrent (most common to open a screen and type rtorrent)

Point your browser to http://localhost/wtorrent/install.php and add a username & password. After you click the "Try configuration" and it gives you no errors click the "Save configuration"

wTorrent with lighttpd


Install rtorrent, lighttpd, php, sqlite3.




1. Apache refuses to start when I use "sudo /etc/rc.d/httpd restart", why?

Use the following to watch out whether your 80 port has been taken by other apps:

# ss -tnap | grep ':80'

And terminate that apps then you should start your apache now. You can use the following to screen the errors of apache:

$ tail -f /var/log/httpd/error_log

2. Why, when I turn to http://localhost/wtorrent/install.php, it returns not the wtorrent setup page but a plain text page?

You should check whether or not php is working on your apache. Add following lines to /etc/httpd/conf/httpd.conf: In LoadModule Section, add:

LoadModule php5_module modules/libphp5.so

In Supplemental configuration section add:

# php5
Include conf/extra/php5_module.conf

And make sure that


is added after the Supplemental configuration section.