Downpour is a web-based BitTorrent client. It supports auto-downloading from RSS feeds and automatic importing and renaming of downloads into a media library, making it ideal for use on a home media server.
- Background downloading of files via BitTorrent and HTTP
- Remote web interface for managing downloads, with realtime download queue status updates via JSON
- Monitor RSS feeds for new media and automatically add new items to the download queue
- Intelligent detection of media metadata
- Automatic import of completed downloads into a local media library following your own file organization and renaming rules (based on media metadata)
- Local media library browser
- Rate, connection and concurrent download limiting
- Ability to bind to specific network interface (only on Linux), such as a VPN interface.
- Multiple user support for shared servers
- Integrated multi-provider search engine
- FTP downloads
- GNOME mimetype handler to remotely add torrent files to a Downpour server
- Language translations
Current release: Downpour v0.2
There are no binary packages of Downpour yet.
Downpour is also available from PyPI
Downpour is written in Python.
- Twisted 8.2.0+
- Storm 0.14+
- Jinja 2
- libtorrent 0.14+
- feedparser 4.1+
- dateutil >= 1.4.1
Installation from PyPI
Downpour is available from PyPI, so if you use easy_install or pip, installation is as easy as running one of the following commands:
pip install Downpour
You will need to manually install libtorrent, since it is not available on PyPI. Most linux distributions have this packaged for you (python-libtorrent on Ubuntu).
After installation, create a configuration file in /etc/downpour.cfg (sample) and ensure that the directories listed in the config file are writable by the downpour user.
To install manually, download the source package above and perform the following steps:
- Verify that python-setuptools is installed
- Unpack the source package into a local directory
- Download and manually install libtorrent. Most linux distributions have this packaged for you (python-libtorrent on Ubuntu). Other dependencies will be downloaded and installed automatically during setup.
- Run the following command in the directory you unpacked Downpour into:
sudo python setup.py install
If you do not have root access, you can install it in your user directory with:
python setup.py install --user
- Copy cfg/downpour.cfg to /etc/downpour.cfg and customize it, ensuring the directories listed in it are writable by the downpour user.
To start the downpour daemon, run the following command:
downpourd -c [config-file]
(Note: the daemon does not run on Windows yet; Windows users can only launch it in debug mode (see below). If anyone wants to create a real launcher for Windows, please email it to me at firstname.lastname@example.org.)
When launching as root, you can specify the user or group to run as with “–user” and “–group”. Specifying a user or group on the command line is unnecessary if you have already specified one in downpour.cfg, since Downpour will automatically drop privileges after setup (useful if you want to use port 80 for the web interface.) User and group options are not available on Windows.
Run “downpourd –help” to view additional runtime options.
You can access the web interface at http://localhost:6280 (or whatever address/port you configured in downpour.cfg.) The default login is “admin” / “password”. You can change the admin password in “My Account” once logged in, or setup additional users in the “Users” section.
To stop the daemon, run the following command:
It may take a few seconds to stop while it cleanly closes all bittorrent connections.
To prevent Downpour from detaching from the console (and to view debugging messages), run the following command:
downpourd -c [config-file] -d
This is currently the only way to run Downpour on Windows.
To report a bug found in Downpour, please go to the Launchpad bug tracker.
You can get a current development snapshot from SVN at http://home.jongsma.org/svn/downpour/trunk.
The main module code is in downpour/. You can immediately view your changes by running ./downpour-debug.sh in the main directory.