[App][Pro] SABNZbd

An app for SABnzbd already existed, but it’s for older Homey models (2019 or older) and there doesn’t seem to be any app support. If you have an older device, by all means use that version if you want. Sabnzbd | Homey

But I have a newer version, so I created a new SABnzbd app and intend to support it as well.
You can find the app here: SABnzbd | Homey


SABnzbd for Homey

Control and monitor your SABnzbd usenet download manager from Homey. Get notified when downloads finish, pause or resume downloading based on time or other conditions, and build flows around your download activity.

Features

Device monitoring

Each SABnzbd instance is added as a Homey device that continuously reports:

  • Downloading (on/off) — Toggle to instantly pause or resume SABnzbd
  • Download Speed — Current speed in MB/s
  • Statusidle, downloading, paused, or error
  • Queue Size — Remaining data to download in MB
  • Queue Items — Number of items in the queue
  • Free Disk Space — Available disk space on the SABnzbd download folder in GB

Flow triggers

  • A download completed — Fires when an individual download finishes successfully. Provides the download name as a flow token.
  • Queue became empty — Fires when the last item in the queue finishes and SABnzbd goes idle.
  • Status changed — Fires whenever the status changes between idle, downloading, paused, or error. Provides the new status as a flow token.

Flow conditions

  • Queue is paused — True when SABnzbd is paused.
  • Is actively downloading — True when SABnzbd is actively downloading.
  • Download speed is above X MB/s — True when the current speed exceeds the given value.
  • Download speed is below X MB/s — True when the current speed is under the given value.
  • Queue size is above X GB — True when the remaining queue exceeds the given size.
  • Free disk space is below X GB — True when the available disk space on the SABnzbd server drops below the given value.

Flow actions

  • Pause downloading — Pause all downloading.
  • Resume downloading — Resume downloading.
  • Set speed limit — Throttle download speed to a given MB/s. Set to 0 for unlimited.
  • Add NZB by URL — Send an NZB URL directly to SABnzbd’s download queue.

Setup

  1. Open HomeyMoreAppsSABnzbdAdd device
  2. Enter the full URL of your SABnzbd instance, including scheme and port — e.g. http://192.168.1.100:8080
  3. Enter your SABnzbd API key (found in SABnzbd → Config → General)
  4. Click Test connection, then Add device

Multiple SABnzbd instances can be added as separate devices.

Device settings

  • URL — Full SABnzbd URL (http or https)
  • API Key — SABnzbd API key
  • Poll interval — How often Homey checks SABnzbd status, in seconds (default: 10, range: 5–300)

Example flows

  • Night throttle — When it’s 23:00 → Set speed limit to 50 MB/s. When it’s 07:00 → Set speed limit to 0 (unlimited).
  • Download done notification — When a download completed → Send a push notification with the download name.
  • Pause on arrival — When I arrive home and SABnzbd is downloading → Pause, to free up bandwidth.
  • Queue cleared — When queue is empty → Turn off the NAS.
  • Low disk space alert — When status changed and free disk space is below 10 GB → Send a push notification.

You could already publish the link to the code?

Here’s the app: https://homey.app/nl-nl/app/net.ladenius.sabnzbd/SABnzbd/

I get the following message during the installation: connect econnrefused

When are you getting this error? When adding a SABnzbd device? Be sure to use an internal IP address ? And get the API key from SABnzbd.

When testing the connection.

Are you sure sabnzbd is on the same host as Homey (and in a subfolder)? Did you install Homey (SHS?)/SAB in a docker container or as executable?

Homey pro, Sab, is on a mini PC. no SHS

Then Sab will definitely not be on 127.0.0.1 which means “localhost”. Your sab instance will be on another local IP address, usually starting with 192.168.x.x or 10.0.x.x. It will usually be the same URL you use in the browser to connect to sab. I guessing, you got this IP address while on the mini-pc, so look for the URL from a different machine than the mini-pc.

Solution found: Thnx..

Hi Jurjen74,
Loving the app! Would it be possible to add a free space monitor as a feature? This would allow SABnzbd to pause when space is low and automatically resume once enough space in a flow.

@Mr-Explore Good idea. I’ve added it, it is now in testing and should be in production soon.

@Mr-Explore It’s in production now, if you update the app (which should happen automagically), you can now do a trigger/condition based on that.