NZB Monkey

NZBLNK™ download helper

View the Project on GitHub nzblnk/nzb-monkey

Downloads

Home

The NZB download solution you were waiting for.

NZB Monkey makes your live much easier by supporting the search/‌download/‌rename/‌apply process of NZB files into your favorite download tool.

Let's have a look to the regular process:

  1. You are at your favorite download portal website.
  2. Click one of the "search engine" buttons to open a NZB search engine with prefilled search term.
  3. Hopefully the search term was unique, you see only one result. Click on download to get the NZB file.
  4. The downloaded file is often named after the search term. So you have to rename it to a proper name.
  5. Apply the renamed NZB file to your favorite download tool by moving it to a scan dir or uploading it into a web interface.
  6. If necessary copy and apply a unpack password.

How does the NZB Monkey makes your life easier? See by yourself:

  1. Click the NZBLNK™-Link on your favorite download portal website.
  2. Done! The rest of the process written above is done automatically.

A running NZB Monkey looks like this:

Installation

The NZB Monkey is at the moment only available for Windows and Linux platform. For macOS user we are working hard on a solution to bring you the same experience like the other OSs.

Windows Platform

Please create a folder where you finally want to locate the NZB Monkey. Copy the contents of the downloaded ZIP archive (the nzbmonkey.exe) into this folder and start the nzbmonkey.exe (by double clicking it).

If a error appears the system asking for MSVCR100.DLL please download the Microsoft Visual C++ 2010 Redistributable Package (x86) and install it.

After the first start is a configuration in the registry saved, which enables the monkey to catch all clicks on a NZBLNK™ link.

Important: Please do not move the EXE file after the first start. If you want to move the exe somewhere else on your computer please remove your CFG file (rename it or move it somewhere else) and start the monkey on its new location. The configuration in the registry is now updated. Copy your config back afterwards.

If everything went right there should be a nzbmonkey.cfg nearby the EXE file and it opened automatically with Notepad. Please continue reading with the configuration.

Linux platform

Please create a folder where you finally want to locate the NZB Monkey. Move the downloaded tar file into this folder and extract it with tar -xzf <tar filename> e.g. tar -xzf nzbmonkey_source_0.1.8.tar.gz.
Execute the config script ./nzblnkconfig.py, which enables the monkey to catch all clicks on a NZBLNK™ link and checks all dependencies.

Dependencies output example:

Missing module(s)!
To use NZB-Monkey you have to install the missing module(s) use

pip3 install --user pyperclip requests configobj colorama
to install the missing module(s) in your home directory,

sudo -H pip3 install pyperclip requests configobj colorama
to install the missing module(s) globally to your client/server

or use your package manager to install the missing Python3 module(s): pyperclip requests configobj colorama.

To have a working pyperclip module you have to install xsel or xclip, see also pyperclip doku:
https://pyperclip.readthedocs.io/en/latest/introduction.html

Resolve all dependencies before you continue.

Important: Please do not move the NZB Monkey files after this NZBLNK™ registration.
If you want to move them somewhere else on your computer, please execute the config script ./nzblnkconfig.py on the new location to update the NZBLNK™ registration.

Now start NZB-Monkey ./nzbmonkey.py. This creates a default configuration file nzbmonkey.cfg and opened it with the default editor.

Please continue reading with the configuration.

Configuration

The configuration file (ending .cfg) is in the same folder like the main application. Open it with your favorite editor.

It contains so called "sections" witch are marked by square brackets.

GENERAL section

The GENERAL section has only two options:

[GENERAL]
target = EXECUTE
categorize = off

The first key here is target. It can have four values:

The second one is categorize which switches the categorisation modes. Options are here:

EXECUTE section

[EXECUTE]
passtofile = True
passtoclipboard = True
nzbsavepath = c:\path\to\your\nzb\files\
dontexecute = False
clean_up_enable = False
clean_up_max_age = 1

Here is everything specified which belongs to the local handling of NZB files. This brings some handy options making the lives easier even without a downloading solution like NZBGet or SABnzbd.

SABNZBD section

For SABnzbd users is the section

[SABNZBD]
host = localhost
port = 8080
ssl = False
nzbkey =
basicauth_username =
basicauth_password =
basepath = sabnzbd
category =
addpaused = False

interesting. Here are all the parameters specific to SABnzbd set up:

NZBGET section

For NZBGet users is the section

[NZBGET]
host = localhost
port = 6789
ssl = False
user = nzbget
pass = tegbzn
category =
basepath = xmlrpc
addpaused = False

interesting. Here are all the parameters specific to NZBGet set up:

SYNOLOGYDLS section

Owner of a Synology DiskStation Manager can use the Download Station. To configure it this section is used.

[SYNOLOGYDLS]
host = localhost
port = 5000
ssl = False
user = 
pass = 
basepath = webapi

Known bugs: The monkey also pushes the "unzip password" to the Download Station. There is a bug in their API so it doesn't use the password. Please add it manually.

NZBCheck section

The NZBCheck section lets you configure the NZB verification mechanism.

[NZBCheck]
skip_failed = True
max_missing_segments_percent = 2.0
max_missing_files = 2
best_nzb = True

Searchengines section

In the Searchengines section are the order and the use of search engines configurable.

[Searchengines]
binsearch = 1
binsearch_alternative = 2
nzbking = 3
nzbindex = 4

All keys are the corresponding search engines. A value of 0 means disabled. A value bigger than 0 means enabled. Bigger numbers mean a lower priority. A search engine with a 3 is checked after one with a 2. Default for all search engines is 1.

CATEGORIZER section

The CATEGORIZER section defines the "searchterms" for a category guessing. It looks like this:

[CATEGORIZER]
series = (s\d+e\d+|s\d+ complete)
movies = (x264|xvid|bluray|720p|1080p|untouched)

There weird characters are Regular Expressions. Each value of this entries is tested against the current tagline. A positive finding stops the testing and the keyword (ex. "series") is used as category.

Finally

After successful installation you can click a link like this and the NZB Monkey should open.