nTorrent is a graphical user interface client (GUI) to rtorrent written in java using the apache xmlrpc library. nTorrent can administer a rtorrent process over a network and allows several clients.
Here are some key features of "nTorrent":
· Simple graphical user interface.
· Connect to an rtorrent process on the local machine or on a network.
· Supports basic user authentication. (you can have several users controlling one rtorrent process)
· Add torrents from url or files.
· Associate ntorrent with torrent files
· Erase, close, open or hash check torrents.
· View torrent info/files.
· Change torrents priority
· Uses apache's xmlrpc library to communicate with rtorrent.
Requirements:
Client-side:
· Java Runtime Environment (JRE) >= 1.6
Server-side
· Webserver - Apache (requires scgi) or lighttpd (builtin scgi)
· xmlrpc-c >= 1.07 (for Integer 64bit support, bug #11)
· rtorrent >= 0.7.8/0.11.8
Quickstart guide (Debian/Ubuntu)
Server-side
Firstly were going to need a webserver, in my case i had a linux box with debian. Open up a terminal window get root permissions.
$ su -
Password:
# whoami
root
Now that you have root permissions you can go ahead with installing the webserver, installation method depends on your linux distribution. In my case im using apt to install packages.
# apt-get install apache2 libapache2-mod-scgi
When thats done we have to configure apache to use mod_scgi
# a2enmod scgi
or
# cd /etc/apache2/
# ln -s mods-available/scgi.load mods-enabled/scgi.load
Apache is now configured to use scgi, lets configure apache to setup a scgi socket to a local process.
# nano /etc/apache2/httpd.conf
now write "SCGIMount /RPC2 127.0.0.1:5000" at the end of the file.
hit ctrl+x and save.
Congratulations, you are done with configuring the apache webserver.
if you are installing lighttpd instead, all you need to do to configure the sever is adding theese following lines to your lighttpd.conf.
scgi.server = (
"/RPC2" => (
"127.0.0.1" => (
"host" => "127.0.0.1",
"port" => 5000,
"check-local" => "disable"
)
)
)
Now lets download and compile xmlrpc, rtorrent and libtorrent.
# cd /usr/src
install svn if you dont have it installed.
# apt-get install svn
# svn co svn://rakshasa.no/libtorrent/trunk/libtorrent
Checked out revision .....
# svn co svn://rakshasa.no/libtorrent/trunk/rtorrent
Checked out revision .....
Now for xmlrpc, which can be a bit hairy. Not all versions will compile, so you will have probably have to try a few versions. You want xmlrpc >= 1.07 for 64bit integer support.
xmlrpc-c 1.11 has been reported to compile on debian etch with the flag --disable-cplusplus.
#cvs -d :pserver:anonymous@xmlrpc-c.cvs.sourceforge.net:/cvsroot/xmlrpc-c login
[hit ENTER at password prompt]
#cvs -d :pserver:anonymous@xmlrpc-c.cvs.sourceforge.net:/cvsroot/xmlrpc-c checkout xmlrpc-c
now you have all the sources needed, but note that if xmlrpc fails to compile you will have to "try and fail" other versions.
before compiling you should read the installation documentation for the software and make sure you have the prerequisites needed.
# cd xmlrpc-c
# ./configure
if there is no configure file, you have to run the command or commands aclocal/autoconf/automake to generate one.
# make
if compile fails, try to download another version. and/or consult installation documentation for xmlrpc-c
# make install
done with xmlrpc, next up, libtorrent.
# cd ../libtorrent
# ./autogen.sh
# ./configure
# make
# make install
done with libtorrent, next up, rtorrent.
# cd ../rtorrent
# ./autogen.sh
# ./configure --with-xmlrpc-c
# make
# make install
all done.
now you can configure rtorrent to listen to a socket by adding the line "scgi_port = 127.0.0.1:5000" to ~/.rtorrent.rc, for more information about this, consult rtorrent documentation.
you might want to configure the webserver to provide access control. With apache you can provide basic authentication with the < Location /RPC2 > directive.
Ok, lets fire up the server.
restart apache.
# /etc/init.d/apache2 restart
now as a normal user start rtorrent.
$ rtorrent
Client-side
open up a new terminal window and go to the directory where you downloaded ntorrent.
$ mkdir ntorrent
$ cd ntorrent
$ tar xvjf nTorrent*
now start nTorrent with
$ java -jar nTorrent.jar
or
$ sh nTorrent.sh (on linux/mac?)
if you dont have java installed, consult sun's installation documentation.
Now you should see a nTorrent window prompting you for host, username and password. the host should according to this example look something like http://127.0.0.1:80/RCP2. Notice that we are using port 80 and not 5000.
Product's homepage
Find us on Google+
