From ArchWiki
Revision as of 11:19, 21 August 2012 by Esdf (Talk | contribs) (Manual installation)

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


Using pacman

# pacman -S rtorrent apache php php-apache php-sqlite php-curl

Install mod_scgiAUR from the AUR.

Manual installation

You need to install: subversion, apache, php, libtorrent-git, rtorrent-git, and xmlrpc-c-svn packages

you cannot use the version of rtorrent from the core it is not compiled with rpc support!


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

$ sudo vi /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 (:wq)

Enabling SQLite in php.ini

$ sudo vi /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


 # pacman -S 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:

$ sudo netstat -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.