NZBGet
The nzbget
platform will allow you to monitor and control your downloads with NZBGet from within Home Assistant and setup automation based on the information.
Configuration
Adding NZBGet to your Home Assistant instance can be done via the user interface, by using this My button:
If the above My button doesn’t work, you can also perform the following steps manually:
-
Browse to your Home Assistant instance.
-
In the sidebar, select Settings.
-
From the configuration menu, select Devices & Services.
-
In the bottom right, select the Add Integration button.
-
From the list, search and select NZBGet.
-
Follow the instructions on screen to complete the setup.
Sensor
This component will create these sensors:
-
nzbget_article_cache
: Article cache size in MB. -
nzbget_average_speed
: Average download rate since server start in MB/s. -
nzbget_download_paused
: Whether downloading is paused. -
nzbget_speed
: Current download rate in MB/s. -
nzbget_queue_size
: Remaining size to download in MB. -
nzbget_disk_free
: Free disk space at the storage location of NZBGet. -
nzbget_post_processing_jobs
: Number of Par-Jobs or Post-processing script jobs in the post-processing queue. -
nzbget_post_processing_paused
: Whether post processing is paused. -
nzbget_uptime
: NZBGet server uptime. -
nzbget_size
: Amount of data downloaded since server start in MB. -
nzbget_speed_limit
: Download queue speed limit in MB/s.
Event Automation
The NZBGet integration continuously monitors nzbget’s download history. When a download completes, an event usable for automation is triggered on the Home Assistant Bus.
Possible events are:
nzbget_download_complete
The event includes the name, category, and status of the downloaded nzb.
Example automation to send a Telegram message on a completed download:
- alias: "Completed Torrent"
trigger:
platform: event
event_type: nzbget_download_complete
- event_data:
category: tv
action:
service: notify.telegram_notifier
data:
title: "Download completed!"
message: "{{trigger.event.data.name}}"
Services
Available services:
-
pause
: Pause the download queue. -
resume
: Resume the download queue. -
set_speed
: Set the download queue speed limit.
Service nzbget/set_speed
Service data attribute | Optional | Description |
---|---|---|
speed |
yes | Sets the download speed limit, specified in Kb/s. 0 disables the speed limit. Defaults to 1000. |