Now liveThe Skillselion MCP - thousands of ranked skills, loaded into your agent mid-task. No install.Get it →
avivsinai avatar

Sabx

  • 1 installs
  • 5 repo stars
  • Updated July 30, 2026
  • avivsinai/sabx

sabx is a Claude Code skill for controlling the SABnzbd Usenet download manager from the terminal via the sabx CLI.

About

sabx is a Claude Code skill for controlling the SABnzbd Usenet download manager from the terminal through the sabx Go CLI. It covers checking the queue and history, adding NZBs, managing priorities and speed limits, pausing and resuming, configuring RSS feeds, and running scheduler tasks. A developer uses it to automate Usenet download workflows or inspect download status. All commands support a --json mode for scripting.

  • Controls the SABnzbd download manager from the terminal via the sabx Go CLI
  • Manages queue, history, priorities, speed limits, RSS feeds, and scheduler tasks
  • Supports --json output for scripting and multiple named connection profiles

Sabx by the numbers

  • 1 all-time installs (skills.sh)
  • Ranked #467 of 550 CLI & Terminal skills by installs in the Skillselion catalog
  • Data as of Jul 31, 2026 (Skillselion catalog sync)
At a glance

sabx capabilities & compatibility

Free CLI; requires a SABnzbd instance and its API key.

Capabilities
download automation · queue management · media management
Use cases
devops
Runs
Runs locally
Pricing
Bring your own API key
From the docs

What sabx says it does

Control SABnzbd download manager via CLI. Use when users need to check download queue/history, add NZBs, manage priorities, control speed limits, pause/resume downloads, configure RSS feeds, run sched
SKILL.md
All commands support `--json` for scripting:
SKILL.md
npx skills add https://github.com/avivsinai/sabx --skill sabx

Add your badge

Show developers this skill is listed on Skillselion. Paste this into your README.

Listed on Skillselion
Installs1
repo stars5
Last updatedJuly 30, 2026
Repositoryavivsinai/sabx

What it does

Automating and monitoring SABnzbd Usenet downloads from the terminal via the sabx CLI.

Who is it for?

Automating SABnzbd download queue, history, priorities, speed limits, RSS feeds, and scheduled tasks from the CLI.

Skip if: Tasks unrelated to SABnzbd or Usenet download management.

When should I use this skill?

You need to check the download queue or history, add NZBs, manage priorities or speed, or automate Usenet workflows.

What you get

Scriptable control of the SABnzbd queue, speed, RSS, and scheduler directly from the terminal.

  • download queue automation
  • scripted download status

By the numbers

  • priority range -1 to 2
  • requires Go 1.24+

Files

SKILL.mdMarkdownGitHub ↗

SABnzbd CLI (sabx)

Control SABnzbd from the terminal. Covers common SABnzbd API operations.

Prerequisites

# Install (Go 1.24+)
go install github.com/avivsinai/sabx/cmd/sabx@latest

# Authenticate (stores API key in OS keyring)
sabx login --base-url http://localhost:8080 --api-key <key>

Quick Command Reference

TaskCommand
Queue statussabx queue list
Active downloadssabx queue list --active
Add NZB from URLsabx queue add url <url>
Add NZB filesabx queue add file <path>
Pause queuesabx queue pause
Resume queuesabx queue resume
Set prioritysabx queue item priority <nzo_id> 2
Delete itemsabx queue item delete <nzo_id>
Historysabx history list
Retry failedsabx history retry <nzo_id>
Delete all historysabx history delete --all
System statussabx status
Full diagnosticssabx status --full --performance
Speed statussabx speed status
Set speed limitsabx speed limit --rate 5M
Remove speed limitsabx speed limit --none
Live dashboardsabx top

Priority Values

Priority is -1 to 2: -1=low, 0=normal, 1=high, 2=force

Common Patterns

Check and manage downloads

sabx queue list --active          # What's downloading now
sabx status --full                # Overall system health
sabx speed status                 # Current speed and limits
sabx warnings list                # Any runtime issues

Add downloads

sabx queue add url https://example.com/file.nzb
sabx queue add file ./local.nzb --cat movies
sabx queue add local /path/on/server/file.nzb

Priority and queue management

sabx queue item priority <nzo_id> 2    # Force (2=force priority)
sabx queue item move <nzo_id> top      # Move to top
sabx queue item move <nzo_id> to 0     # Move to position 0
sabx queue sort name                   # Sort by name
sabx history delete --all              # Clear entire history
sabx history delete --failed           # Clear failed items only

Pause/resume workflows

sabx queue pause                  # Pause all downloads
sabx queue resume                 # Resume downloads
sabx postprocess pause            # Pause post-processing
sabx postprocess resume           # Resume post-processing

RSS feed automation

sabx rss list                           # List configured feeds
sabx rss add TVFeed --url <rss-url> --cat tv
sabx rss run TVFeed                     # Manually trigger specific feed
sabx rss run                            # Run all feeds
sabx rss delete TVFeed

Scheduler tasks

sabx schedule list
sabx schedule add NightPause --set command=pause --set day=mon-sun --set hour=01 --set min=00
sabx schedule set NightPause --set hour=02
sabx schedule delete NightPause

Server management

sabx server list                  # News servers
sabx server stats                 # Per-server statistics
sabx server test primary          # Test connectivity
sabx server disconnect            # Disconnect from all servers

Troubleshooting

sabx doctor                       # Health checks
sabx warnings list                # Runtime warnings
sabx logs list --lines 50         # Recent logs
sabx logs tail --follow           # Stream logs
sabx debug gc-stats               # GC diagnostics

Output Modes

All commands support --json for scripting:

sabx queue list --json | jq '.slots[0].filename'
sabx speed status --json

Configuration

# Multiple profiles
sabx login --profile home --base-url http://home:8080 --api-key <key>
sabx login --profile server --base-url http://server:8080 --api-key <key>

# Switch profiles
sabx --profile server queue list

# Environment overrides
SABX_BASE_URL=http://alt:8080 SABX_API_KEY=xxx sabx status

Troubleshooting

Connection refused

  • Verify SABnzbd is running: check the web UI at the configured base URL
  • Re-run sabx login if the base URL changed
  • Check firewall rules if connecting to a remote instance

Authentication failed

  • Re-authenticate: sabx login --base-url <url> --api-key <key>
  • API key may have been regenerated in SABnzbd settings
  • Try sabx status to test connectivity

NZO ID not found

  • The item may have been removed from queue or completed to history
  • Re-check with sabx queue list or sabx history list
  • NZO IDs change if SABnzbd is restarted

Rate limit / timeout

  • SABnzbd may be busy with post-processing; wait and retry
  • Check sabx status --full --performance for system load
  • Reduce concurrent operations if running batch commands

References

  • Full command reference: See references/commands.md

Related skills

FAQ

How do I install and authenticate sabx?

Install with go install github.com/avivsinai/sabx/cmd/sabx@latest, then run sabx login with the base URL and API key, which stores the key in the OS keyring.

Can sabx output be scripted?

Yes. All commands support a --json flag, for example sabx queue list --json piped through jq.

CLI & Terminalinframonitoring

This week in AI coding

Five minutes, every Monday - the tools, releases and tactics for developers.

unsubscribe anytime.