NZBGet Queue & Post-Processing Script

This is the official NZBClient Script for NZBGet, it supports both Queue & Post-Processing in one script and will need to be enabled for all categories you want to receive post-processing notifications from and enabled as an Extension script to get queue notifications.

Please see the Ultra Setup page for installation instructions.

Requirements

• Python 3 to be installed on your system that runs NZBGet.
• Access to your NZBGet setup to install a Queue/Post-Processing script.
• NZBClient version 2023.3 or greater

Installation

Follow the instructions here to setup this NZBGet script.

Latest Versions

2.1.0 - NZBClient.py or 1.2.0 - NZBClient.py

2.0 Script History

1.0 Script History (Legacy)

Legacy version is for NZBGet 22.0 or earlier. For NZBGet 23.0 or later, please use version 2.0.

Radarr Script

Experimental Version

Beta 1 - 0.1.1 - NZBClient-Radarr.sh

Instructions

1. Edit the Script Settings

• Open the .sh file in a text editor.
• Find the following lines:

APP_TOKEN="<Replace with your app token>"
USER_KEY="<Replace with your user key>"

• Replace these values with the ones provided in the NZBClient app.
• Save and close the file.

2. Open Radarr

• Go to Settings → Connect.
• Make sure Advanced Settings is turned on (top-right toggle).

3. Add Custom Script

• Click + and select Custom Script.

4. Configure Script

• Name: Enter something like NZBClient Notify.
• Path: Enter the full path to your script file (e.g., /home/user/scripts/NZBClient-Radarr.sh).
• Arguments: Leave blank (unless your script requires custom arguments).
• On Grab / On Download / On Upgrade: Enable the events you want to trigger notifications on.

5. Save & Test

• Click Save.
• Use the Test button in Radarr to confirm the script runs without errors.

6. Verify Output

• Check Radarr’s logs (System → Logs → Log Files) to confirm the script is being executed.
• You should see notification events logged when downloads are grabbed or completed.

⚠️ Final Step (optional): Ensure the script is executable:

chmod +x /home/user/scripts/NZBClient-Radarr.sh

Sonarr Script

Experimental Version

Beta 2 - 0.5.0 - NZBClient.sh

Instructions

1. Edit the Script Settings

• Open the .sh file in a text editor.
• Find the following lines:

APP_TOKEN="<Replace with your app token>"
USER_KEY="<Replace with your user key>"

• Replace these values with the ones provided in the NZBClient app.
• Save and close the file.

2. Open Sonarr

• Go to Settings → Connect.
• Make sure Advanced Settings is turned on (top-right toggle).

3. Add Custom Script

• Click + and select Custom Script.

4. Configure Script

• Name: Enter something like NZBClient Notify.
• Path: Enter the full path to your script file (e.g., /home/user/scripts/NZBClient.sh).
• Arguments: Leave blank (unless your script requires custom arguments).
• On Grab / On Download / On Upgrade: Enable the events you want to trigger notifications on.

5. Save & Test

• Click Save.
• Use the Test button in Sonarr to confirm the script runs without errors.

6. Verify Output

• Check Sonarr’s logs (System → Logs → Log Files) to confirm the script is being executed.
• You should see notification events logged when downloads are grabbed or completed.

⚠️ Final Step (optional): Ensure the script is executable:

chmod +x /home/user/scripts/NZBClient.sh