Skip to main content

nzbget-file-opener allows you to download *.nzb files with just a double click

Project description

NZBget file opener

This scripts sends .nzb files to the specified host. You can specify many options, like deleting the files after upload. Also, it ensures that NZBGet is running before sending the files, launching it if necessary (Auto-detected on macOS. Windows users have to manually specify app path).


pip install nzbget-file-opener


nzbget-file-opener [-h]
                   [-n HOSTNAME] [-u USERNAME] [-p PASSWORD]
                   [-l CONFIG] [-d DOMAIN]
                   [-c CATEGORY] [-P PRIORITY]
                   [--add-top] [--add-paused]
                   [--app-path NZBGET_PATH]
                   files [files ...]

positional arguments:

  files                 the files to send

optional arguments:

  -h, --help            show this help message and exit

  -n HOSTNAME, --hostname HOSTNAME
                        the nzbget hostname to reach
  -u USERNAME, --username USERNAME
                        your nzbget username
  -p PASSWORD, --password PASSWORD
                        your nzbget password

  -l CONFIG, --load-config CONFIG
                        your nzbget config
  -d DOMAIN, --domain DOMAIN
                        the domain target defined in your nzbget config

  -c CATEGORY, --category CATEGORY
                        the category to use for the nzb files download
  -P PRIORITY, --priority PRIORITY
                        the category to use for the nzb files download

  --add-top             add the files to the top of queue
  --add-paused          add the files in pause state

  --app-path NZBGET_PATH
                        specify the nzbget app path to launch it if not
                        already running

  -D, --delete-files    to delete the files sent to NZBget


Available pipenv run scripts :

  • install - installs the package in pipenv
  • app - runs the application
  • test - runs the tests with pytest
  • build - build the app artifacts
  • clean - clean the artifacts created with the build script
  • deploy-test - deploy to test.pypi
  • deploy - deploy to pypi

In order to properly run the deploy scripts, you should :

  • have twine installed.
  • have a ~/.pypirc file filled according to the template below

Configurations templates

~/.nzbgetrc configuration (recommended) :

username = local-username
password = local-password

port = 6790
username = remote-username
password = remote-password

you can use defaut by not mentioning the field

.env configuration :


url scheme and port are optional

you can also set these variables in your environment



username: your_username
password: your_password

username: your_username
password: your_password

Note: and uses two distinct databases for user accounts. You need to create an account for both domains

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

nzbget-file-opener-1.0.3.tar.gz (7.2 kB view hashes)

Uploaded source

Built Distribution

nzbget_file_opener-1.0.3-py3-none-any.whl (7.6 kB view hashes)

Uploaded py3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page