Home

TorrentQueue: The Fully Automatic BitTorrent Client

This program aims to make setting up and tearing down the torrent sessions as painless as possible. Unlike most automatic torrent downloaders, it has a feature to stop after reaching a specific ratio (default of 10:1 upload to download) or after enough time passes once you finish downloading the torrent (default of one week). There is also a commandline interface with access to extremely detailed information on all running torrents and control over the queued torrents. The intention is that you simply download the .torrent file to a directory and find it complete later. No further manual management is necessary.

This project is still pretty raw, but it's usable enough that I've been testing it and have had generally good results.

There is one major pre-req: libtorrent-rasterbar libtorrent-rasterbar is actively maintained and tracks the feature set of popular torrent clients like utorrent reasonably well.

You will also need boost (required for libtorrent-rasterbar) and a c++ compiler (I use g++).

This software was developed on FreeBSD, but it should compile fine on Linux and probably even on Windows with MinGW if you can get libtorrent working there.

The interface uses raw console commands, allowing it to interact nicely with screen or FreeBSD watch interfaces. The intended use is to have it running on a physical console somewhere and only interacted with when necessary. The configuration file is completely optional, as the program ships with sane defaults.

The defaults are:
~/bt/queue : Drop new torrents here to be picked up by tqueue
~/bt/run : Currently active .torrent files are here
~/bt : Downloaded and downloading files are here, in directories named after the torrent files
~/bt/done : Completed .torrent files are dropped off here
~/bt/torrentqueue.log : Log file for the program
~/bt/.torrentstate.dat : Save file created when the program is shut down to allow it to restart quickly.

The console will show a help screen if you type 'h'.