SABnzbd

Track download progress on your Lock Screen. See file names, speed, ETA, and post-processing phases in real-time.

How It Works

The pushward-sabnzbd bridge container runs an HTTP server that receives webhooks from SABnzbd and tracks download and post-processing progress.

1. Webhook -- SABnzbd notifies the bridge when a download is added
2. Download tracking -- polls SABnzbd every 1s, showing progress, speed (MB/s), ETA, and file name
3. Post-processing -- tracks Verifying, Repairing, Extracting, and Moving phases
4. Queue continuation -- if more downloads appear, continues tracking
5. Summary -- shows total size, duration, and average speed before cleanup

Setup

1. Get Your Integration Key

Open the PushWard app → Settings → Integration Key to find your default hlk_ key.

To create a dedicated key for this integration:

1. Go to Settings → Manage Keys
2. Tap +
3. Set name (e.g. "SABnzbd"), choose scope, and optionally restrict tosabnzbd
4. Copy the generated hlk_ key

2. Deploy the Bridge

services:
  pushward-sabnzbd:
    image: ghcr.io/mac-lucky/pushward-sabnzbd:latest
    ports:
      - "8090:8090"
    environment:
      PUSHWARD_URL: https://api.pushward.app
      PUSHWARD_API_KEY: hlk_YOUR_INTEGRATION_KEY
      PUSHWARD_SABNZBD_URL: http://sabnzbd:8080
      PUSHWARD_SABNZBD_API_KEY: your-sabnzbd-api-key
    restart: unless-stopped

3. Configure SABnzbd Notification Script

In SABnzbd, configure a notification script that sends a POST request to the bridge webhook:

1. Go to Config > Notifications
2. Under Notification Script, add a script that calls the webhook
3. Enable notifications for NZB added

Alternatively, use a curl-based script:

#!/bin/bash
curl -X POST http://pushward-sabnzbd:8090/webhook

Configuration

Download Phases

Templates

SABnzbd supports two display templates, configured via PUSHWARD_SABNZBD_TEMPLATE:

Activity Slug Format

Uses a fixed slug: sabnzbd. All downloads are tracked under a single activity.