Automatically migrated from Gitolite
You cannot select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
Sven Slootweg 41666ddabc Keep an autoskip list 10 years ago
sources Fix bugs, set correct headers, etc. 10 years ago
.gitignore Code so far 10 years ago Allow for a list of to-be-skipped release names 10 years ago
config.json.example Add example configuration 10 years ago Keep an autoskip list 10 years ago Fix bugs, set correct headers, etc. 10 years ago
structure.sql Include database structure 10 years ago


Takes input in the form of either a list of release names or a configuration file (matching database entries), and then searches for and downloads the corresponding NZBs.


Currently uses and Shouldn't be hard to extend. Contributions welcome.


You'll need to pip install oursql requests (this will require having the MySQL development libraries installed). Other than that, just run


You can use nzbspider with either a release list or a configuration file.

Using --iplist you can specify a newline-delimited file that contains all the available IPs on your machine. nzbspider will randomly pick one for every search query. If not specified, the OS default is used.

Using --skip you can specify a newline-delimited file that contains all release names that should be skipped, no matter what. This works in both modes.

Release list

This is a text file, specified with the --list parameter, that contains a newline-delimited list of release names to search for. You will need to use the --target parameter to specify what directory to download the NZBs to.

Configuration file

This is a text file using a specific configuration syntax to select specific releases from a pre-filled MySQl database, to search for. Use the --config parameter to specify the path of the configuration file you wish to use.

To use this mode, you will need to copy config.json.example to config.json and change the database details to match yours. A (basic) database schema is included. Only results that are at least 24 hours old will be matched, regardless of your configuration.

The configuration file format is as follows:

  • Newline-delimited, a new predicate on every line.
  • Three whitespace-delimited fields: release name, section, and target directory.
  • Enter - for any or both of the first two fields to match regardless of the release name or section (depending on which you fill in as -).
  • The % character is used to denote a multi-character wildcard anywhere in the first two fields.
  • The first two fields are enclosed in wildcard characters by default.
  • The target directory does not have to exist; it will be created if it doesn't.
  • You must enclose a field value in " quotes if it contains a space.

An example configuration file (the real configuration format doesn't allow comments, so don't copy this verbatim!):

- MP3 ./mp3s             # Will select everything in section 'MP3'
- - ./everything         # Will select absolutely everything
IMMERSE - ./immerse      # Will select everything labeled 'IMMERSE'
Mad.Men%720p - ./madmen  # Will select every 720p episode of Mad Men

Note that these searches are run against your own database, not directly against the NZB indexing sites! You'll still need a list of valid release names pre-filled in your database.

Using --limit you can override the default limit of matched results. The default is the 250 newest results.


The script will assume that all releasenames in your database are safe as a filename. No sanitation or conversion of the filenames will take place.


Licensed under the WTFPL or, if you take issue with that for some reason, the CC0. Attribution (to Sven Slootweg) appreciated, not required.


If you like this, you can donate here.