= rTorrent on Windows =

 * [#install Installing rTorrent on Windows]
  * [#cygwin Installing Cygwin]
  * [#libtorrent Installing libTorrent]
  * [#xmlrpc Installing XMLRPC-C (optional)]
  * [#rtorrent Installing rTorrent]
 * [#use Using rTorrent on Windows without installing Cygwin]
  * [#download Download rTorrent on Windows binaries]
   * [#direct Direct download (zip archive)]
   * [#direct7z Direct download (7z archive)]
   * [#bittorrent BitTorrent download (preferred)]
  * [#configure Configure rTorrent on Windows]
 * [#screenshots Screenshots]

== Installing rTorrent on Windows == #install

To be able to run [http://libtorrent.rakshasa.no/ rTorrent] on Windows, you are going to need [http://www.cygwin.com/ Cygwin].

'''Precompiled binaries''' which do not require [http://www.cygwin.com/ Cygwin] can be found in the [http://static.jmk.hu/rtwi/downloads/rtow/ download section].

=== Installing Cygwin === #cygwin

Download Cygwin 1.7 (or newer) from the [http://www.cygwin.com/ Cygwin page] (direct links to the installers: [http://cygwin.com/setup-x86.exe x86], [http://cygwin.com/setup-x86_64.exe x86_64]).

Start the installer, choose "Install from internet", select a directory to install Cygwin and one for the packages to be downloaded to, then set up your connection and pick a mirror.

You're going to need at least the following packages in order to compile and run [http://libtorrent.rakshasa.no/ rTorrent]:

 * git
 * subversion
 * automake
 * libtool
 * cppunit
 * gcc-core
 * gcc-g++
 * openssl-devel
 * pkg-config
 * make
 * libncurses-devel
 * libcurl-devel

These might require some other packages, let them be installed. Wait until the installer downloads and installs the necessary packages, check wherever you want shortcuts and close the installer. When you're done, start Cygwin (if you choose not create any shortcuts, you can start Cygwin with the cygwin.bat in your installation directory).

=== Preparation ===

By default, [http://www.cygwin.com/ Cygwin] has no /usr/localr/src, so create one.

{{{
mkdir -p /usr/local/src
}}}

=== Installing libTorrent === #libtorrent

Download the latest windows fork of the [http://libtorrent.rakshasa.no/ libTorrent] source from the [https://github.com/ghudiczius/libtorrent git repository], compile and install it.

{{{
cd /usr/local/src/
git clone https://github.com/ghudiczius/libtorrent libtorrent-git
cd /usr/local/src/libtorrent-git
git checkout feature/cygwin_compilation_fix
./autogen.sh
./configure --disable-mincore
make
make install
cd ..
}}}

=== Installing XMLRPC-C (optional) === #xmlrpc

If you want to be able to control [http://libtorrent.rakshasa.no/ rTorrent] via [http://xmlrpc-c.sourceforge.net/ XMLRPC-C], let's say by [wiki:WikiStart rTWi]. For that, you need to install [http://xmlrpc-c.sourceforge.net/ XMLRPC-C], preferably something over version 1.07.

{{{
cd /usr/local/src/
svn co https://svn.code.sf.net/p/xmlrpc-c/code/stable/ xmlrpc-c-svn
cd /usr/local/src/xmlrpc-c-svn
./configure
make
make install
cd ..
}}}

=== Installing rTorrent === #rtorrent

Now download the latest [http://libtorrent.rakshasa.no/ rTorrent] source from the [https://github.com/rakshasa/rtorrent git repository].

{{{
cd /usr/local/src/
git clone https://github.com/ghudiczius/rtorrent rtorrent-git
cd /usr/local/src/rtorrent-git
git checkout feature/cygwin_compilation_fix
./autogen.sh
./configure --with-xmlrpc-c
make
make install
cd ..
}}}

If `./configure` or `make` fails with not finding the package 'libtorrent' you might need to set the PKG_CONFIG_PATH environmental variable:

{{{
export PKG_CONFIG_PATH=/usr/local/lib/pkgconfig
}}}

If `make` fails, with the message ''"fatal error: ncurses.h: No such file or directory"'' you might need to run ./configure with the CXXFLAGS option, i.e.:

{{{
./configure --with-xmlrpc-c CXXFLAGS=-I/usr/include/ncurses
}}}

You are now ready to run [wiki:rTorrentOnWindows rTorrent on Windows], just type rtorrent into your Cygwin window.

== Using rTorrent on Windows without installing Cygwin == #use

=== Download rTorrent binaries for Windows === #download

You can find all (including 32 bit and 64 bit) releases in the [http://static.jmk.hu/rtwi/downloads/rtow/ download section].

==== Direct download (zip archive) ==== #direct

Download and extract the [http://static.jmk.hu/rtwi/downloads/rtow/rtow-latest.zip rtow-latest.zip] archive to a directory of your choice.

==== Direct download (7z archive) ==== #direct7z

Download and extract the [http://static.jmk.hu/rtwi/downloads/rtow/rtow-latest.7z rtow-latest.7z] archive to a directory of your choice.

You can download the [http://www.7-zip.org/ 7-Zip] software from [http://www.7-zip.org/ http://7-zip.org/].

==== !BitTorrent download ==== #bittorrent

Download the [http://static.jmk.hu/rtwi/downloads/rtow/rtow-latest.torrent .torrent] file and feed it to your current [http://www.bittorrent.org/introduction.html BitTorrent] client. After the download is complete, move/rename the directory as you wish.

=== Configure rTorrent on Windows === #configure

The ''.rtorrent.rc'' configuration file can be found in the ''bin'' directory. There are some settings already set up for ease of usage, please do not modify them, unless you know what you are doing.

The default session directory is ''.session'' and the default download directory is ''torrent''.

You can access your partitions thru the ''cygdrive'' directory from [http://libtorrent.rakshasa.no/ rTorrent].

You are now ready to run [wiki:rTorrentOnWindows rTorrent on Windows], just create a shortcut pointing to the ''rTorrent.cmd'' file, or start it directly.

== Screenshots == #screenshots

[[myImage(http://static.jmk.hu/rtwi/screenshots/rtorrent_on_windows/rtorrent_on_windows_startup.th.png, http://static.jmk.hu/rtwi/screenshots/rtorrent_on_windows/rtorrent_on_windows_startup.png, rTorrent on Windows (startup))]]
[[myImage(http://static.jmk.hu/rtwi/screenshots/rtorrent_on_windows/rtorrent_on_windows.th.png, http://static.jmk.hu/rtwi/screenshots/rtorrent_on_windows/rtorrent_on_windows.png, rTorrent on Windows)]]