SABnzbd

SABnzbd 다운로드 진행 상황을 iPhone 잠금 화면의 실시간 현황으로 추적하세요. 파일 이름, 속도, ETA, 후처리 단계를 실시간으로 확인할 수 있습니다.

How It Works

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

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

Setup

1. Get Your Integration Key

PushWard 앱의 설정 → 연동 키에서 기본 연동 키를 복사하세요. 이 키는 로그인 시 자동으로 생성됩니다. 키를 이 연동으로 제한하려면 범위가 제한된 키 만들기를 참고하세요.

2. Deploy the Bridge

docker-compose.yml

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/api
      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:

Go to Config > Notifications
Under Notification Script, add a script that calls the webhook
Enable notifications for Added NZB

Alternatively, use a curl-based script:

notify.sh

#!/bin/bash
curl -X POST http://pushward-sabnzbd:8090/webhook \
  -H "X-Webhook-Secret: your-secret"

The secret is defined on the bridge container (the PUSHWARD_SABNZBD_WEBHOOK_SECRET env var in the Configuration table below) and sent by this script; SABnzbd itself has no field for it.

Configuration

환경 변수	설명	기본값
`PUSHWARD_URL`	PushWard server URL	--
`PUSHWARD_API_KEY`	Integration key (`hlk_` prefix)	--
`PUSHWARD_SABNZBD_URL`	SABnzbd API URL	--
`PUSHWARD_SABNZBD_API_KEY`	SABnzbd API key	--
`PUSHWARD_SABNZBD_WEBHOOK_SECRET`	Optional shared secret. When set, `POST /webhook` requires a matching `X-Webhook-Secret` header.	--
`PUSHWARD_SERVER_ADDRESS`	HTTP listen address	`:8090`
`PUSHWARD_PRIORITY`	Activity priority (0-10)	`1`
`PUSHWARD_POLL_INTERVAL`	Poll interval during tracking (min 1s)	`5s`
`PUSHWARD_CLEANUP_DELAY`	Delay before cleanup after completed	`15m`
`PUSHWARD_STALE_TIMEOUT`	Ends activity if no updates received	`30m`
`PUSHWARD_SABNZBD_TEMPLATE`	Display template (`generic` or `timeline`)	`generic`

Download Phases

Phase	Live Activity	Color
Starting	Starting...	Blue
Downloading	12.3 MB/s	Blue
Paused	Paused	Blue
Verifying	Verifying...	Orange
Repairing	Repairing...	Orange
Extracting	Extracting...	Orange
Complete	1.2 GB · 45 MB/s avg · unpack 2m 3s	Green

💡 팁

The bridge automatically resumes tracking if it detects active downloads on startup, so it recovers gracefully from restarts.

Templates

SABnzbd supports two display templates, configured via PUSHWARD_SABNZBD_TEMPLATE:

Template	Display
`generic` (default)	Progress bar with speed, ETA, and file name
`timeline`	Sparkline chart showing download speed over time, with speed (MB/s) as the primary metric

Activity Slug Format

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