blacksap 1.8.0

Track torrent RSS feeds

blacksap is a Python based RSS tracker that is designed to watch multiple RSS feeds from torrent sites and download any new torrent files to a specified location. If you have your torrent client configured to watch the same directory the files will be automatically picked up!

License

blacksap is released under the GNU General Public License v3.0, see the file LICENSE for the license text.

Installation

As of version 1.8, blacksap is supported the latest versions of Python3 and PyPy3!

The most straightforward way to get blacksap working for you is:

pip install blacksap

NOTE:

By default, the blacksap executable gets put in /usr/local/bin/

Getting Started

You can get help from blacksap by running:

blacksap --help

Tracking a new feed

To track a new RSS feed run:

blacksap track "https://example.com/search?q=latest_torrents&fmt=rss"

Viewing tracked feeds

To view all the feeds being tracked, run:

blacksap tracking

Untracking a feed

To untrack a feed type:

blacksap untrack "https://example.com/search?q=latest_torrents&fmt=rss"

Run blacksap

To get blacksap to check all RSS fees and download any new torrent files, simply run:

blacksap run --output ~/Downloads/

NOTE:

On its first check of a new feed, blacksap will only download the most recent torrent file. If you would like to download more files (or none at all), override the number of files to download with the --count flag! Don't forget to specify the URL of the new RSS feed or you will force that number of files to download from every tracked feed!

Extras

Preferences

The feeds that blacksap tracks are stored in ~/.blacksap.cfg. If you want to reset blacksap you can simply delete this file. It is also stored in JSON format, so feel free to edit the file in place if needed.

App Settings

App specific settings are also stored in this file in an "app" hash. The following settings are currently available for configuration

• threads - Integer for number of threads to use (Default is None)
• proxies - Hash of proxies to use for 'http' and 'https' (Default is None)
• ipv6 - Boolean (Default is True)

Feed Settings

In version 1.5 and later of blacksap you can add a special "rules" key to each feed that contains a list of regular expressions that torrent files in the feed must match in order to be downloaded by blacksap. The regular expressions are processed in order and when the first match is found no other rules are applied. If no "rules" key exists then any new files will be downloaded.

Example Settings

Below is an example blacksap configuration file:

{
	"app": {
		"threads": 4,
		"ipv6": false,
		"proxies": {
			"http": "socks5://user:pass@fqdn:port",
			"https": "socks5://user:pass@fqdn:port"
		}
	},
	"feeds": [{
		"url": "https://example.com/search?q=latest_torrents&fmt=rss",
		"name": "Example Torrents",
		"hash": "51930c6ea13972d61d7783da0910aa89",
		"enabled": true,
		"new": false,
		"last": "My_Awesome_File.torrent",
		"rules": [
			"Awesome_File"
		]
	}]
}

Mac OSX LaunchAgent

If you are running OSX please check out the LaunchAgent in the git repo extras folder. You can add it to your ~/Library/LaunchAgents/ directory and that way blacksap will run every hour and download new torrents automatically!

UNIX/Linux Cronjob!

Add the following to your user's crontab (using crontab -e command as your user) to schedule blacksap to run every hour (downloading to a ~/torrents/ directory):

# Blacksap cronjob
0 * * * * /usr/local/bin/blacksap run -o ~/torrents/

Contributing

Comments and enhancements are very welcome.

Report any issues or feature requests on the BitBucket bug tracker. Please include a minimal (not-) working example which reproduces the bug and, if appropriate, the traceback information. Please do not request features already being worked towards.

Code contributions are encouraged: please feel free to fork the project and submit pull requests to the develop branch.