
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 #468 of 550 CLI & Terminal skills by installs in the Skillselion catalog
- Data as of Jul 31, 2026 (Skillselion catalog sync)
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
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
All commands support `--json` for scripting:
npx skills add https://github.com/avivsinai/sabx --skill sabxAdd your badge
Show developers this skill is listed on Skillselion. Paste this into your README.
| Installs | 1 |
|---|---|
| repo stars | ★ 5 |
| Last updated | July 30, 2026 |
| Repository | avivsinai/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
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
| Task | Command |
|---|---|
| Queue status | sabx queue list |
| Active downloads | sabx queue list --active |
| Add NZB from URL | sabx queue add url <url> |
| Add NZB file | sabx queue add file <path> |
| Pause queue | sabx queue pause |
| Resume queue | sabx queue resume |
| Set priority | sabx queue item priority <nzo_id> 2 |
| Delete item | sabx queue item delete <nzo_id> |
| History | sabx history list |
| Retry failed | sabx history retry <nzo_id> |
| Delete all history | sabx history delete --all |
| System status | sabx status |
| Full diagnostics | sabx status --full --performance |
| Speed status | sabx speed status |
| Set speed limit | sabx speed limit --rate 5M |
| Remove speed limit | sabx speed limit --none |
| Live dashboard | sabx 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 issuesAdd 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.nzbPriority 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 onlyPause/resume workflows
sabx queue pause # Pause all downloads
sabx queue resume # Resume downloads
sabx postprocess pause # Pause post-processing
sabx postprocess resume # Resume post-processingRSS 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 TVFeedScheduler 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 NightPauseServer management
sabx server list # News servers
sabx server stats # Per-server statistics
sabx server test primary # Test connectivity
sabx server disconnect # Disconnect from all serversTroubleshooting
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 diagnosticsOutput Modes
All commands support --json for scripting:
sabx queue list --json | jq '.slots[0].filename'
sabx speed status --jsonConfiguration
# 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 statusTroubleshooting
Connection refused
- Verify SABnzbd is running: check the web UI at the configured base URL
- Re-run
sabx loginif 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 statusto test connectivity
NZO ID not found
- The item may have been removed from queue or completed to history
- Re-check with
sabx queue listorsabx 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 --performancefor system load - Reduce concurrent operations if running batch commands
References
- Full command reference: See references/commands.md
SABnzbd CLI Command Reference
Complete command reference for sabx. Run sabx <command> --help for details.
Queue Commands
List and inspect
sabx queue list # All queue items
sabx queue list --active # Currently downloading
sabx queue list --search "term" # Filter by name
sabx queue list --limit 10 # Limit results
sabx queue list --json # JSON outputAdd downloads
sabx queue add url <url> # Add from URL
sabx queue add url <url> --cat movies # With category
sabx queue add url <url> --priority 2 # With priority (-1=low,0=normal,1=high,2=force)
sabx queue add file <path> # Add local NZB file
sabx queue add local <server-path> # Add file already on SAB serverAdd options: --cat, --priority, --script, --password, --name
Queue control
sabx queue pause # Pause all
sabx queue resume # Resume all
sabx queue purge --all # Remove all items
sabx queue purge --search "term" # Remove matching items
sabx queue sort <name|age|size|eta> # Sort queue
sabx queue sort name --desc # Sort descendingItem operations
sabx queue item show <nzo-id> # Show item details
sabx queue item pause <nzo-id> # Pause specific item
sabx queue item resume <nzo-id> # Resume specific item
sabx queue item delete <nzo-id> # Delete from queue
sabx queue item delete <nzo-id> --with-data # Also delete files
sabx queue item priority <nzo-id> <-1..2> # Set priority
sabx queue item move <nzo-id> top # Move to top
sabx queue item move <nzo-id> bottom # Move to bottom
sabx queue item move <nzo-id> up # Move up one position
sabx queue item move <nzo-id> down # Move down one position
sabx queue item move <nzo-id> to 0 # Move to specific position
sabx queue item set <nzo-id> --cat movies # Change category
sabx queue item set <nzo-id> --script pp.sh # Change script
sabx queue item set <nzo-id> --name "New Name" # Rename
sabx queue item files <nzo-id> # List files in NZBItem file operations
sabx queue item files <nzo-id> # List NZF files
sabx queue item files delete <nzo-id> <nzf-id> # Delete specific file
sabx queue item files move <nzo-id> --action top --id <nzf-id> # Move file to top
sabx queue item files move <nzo-id> --action up --id <nzf-id> --size 3 # Move up 3 positionsQueue completion action
sabx queue complete-action shutdown # Shutdown PC when done
sabx queue complete-action hibernate # Hibernate when done
sabx queue complete-action standby # Standby when done
sabx queue complete-action shutdown-program # Stop SABnzbd when done
sabx queue complete-action none # Clear completion actionHistory Commands
sabx history list # Recent history
sabx history list --limit 50 # More items
sabx history list --failed # Failed only
sabx history list --completed # Completed only
sabx history retry <nzo-id> # Retry failed download
sabx history retry --all # Retry all failed
sabx history delete <nzo-id> # Delete from history
sabx history delete --all # Delete entire history
sabx history delete --failed # Delete only failed items
sabx history mark-completed <nzo-id> # Mark as completedStatus & Diagnostics
sabx status # Basic status
sabx status --full # Full status with details
sabx status --performance # Include performance metrics
sabx status --full --performance # Everything
sabx status orphans list # List orphaned files
sabx status orphans delete <path> # Delete orphan
sabx status orphans delete-all # Delete all orphans
sabx status orphans add <path> # Add orphan to queue
sabx status orphans add-all # Add all orphans to queue
sabx warnings list # Runtime warnings
sabx warnings clear # Clear warnings
sabx logs list # Recent log entries
sabx logs list --lines 100 # More lines
sabx logs tail # Last entries
sabx logs tail --follow # Stream live
sabx doctor # Connectivity & health checksSpeed Control
sabx speed status # Current speed and limits
sabx speed status --json # For scripting
sabx speed limit --rate <value> # Set speed limit
sabx speed limit --rate 50% # Percentage of max
sabx speed limit --rate 800K # Kilobytes per second
sabx speed limit --rate 4M # Megabytes per second
sabx speed limit --rate 4MB/s # Alternative format
sabx speed limit --rate 10Mbps # Megabits per second
sabx speed limit --none # Remove limitPost-Processing
sabx postprocess pause # Pause all post-processing
sabx postprocess resume # Resume post-processing
sabx postprocess cancel <nzo-id> # Cancel specific job's PPServer Management
sabx server list # List news servers
sabx server stats # Per-server statistics (all servers)
sabx server test <server-name> # Test server connectivity
sabx server disconnect # Disconnect from all servers
sabx server unblock <server-name> # Unblock server
sabx server restart # Restart SABnzbd
sabx server shutdown # Shutdown SABnzbd
sabx server repair # Repair queueRSS Feeds
sabx rss list # List all feeds
sabx rss add <name> --url <url> # Add feed
sabx rss add <name> --url <url> --cat tv --priority 1
sabx rss set <name> --set uri=<new-url>
sabx rss set <name> --set enabled=1
sabx rss delete <name> # Delete feed
sabx rss run <name> # Manually run specific feed
sabx rss run # Run all feedsCategories
sabx categories list # List categories
sabx categories add <name> # Add category
sabx categories add <name> --dir /path --script pp.sh
sabx categories set <name> --set dir=/new/path
sabx categories delete <name> # Delete categoryScheduler
sabx schedule list # List scheduled tasks
sabx schedule add <name> --set command=<cmd> --set day=<days> --set hour=<HH> --set min=<MM>
# Commands: pause, resume, speedlimit, scan_folder, etc.
# Days: daily, weekdays, mon, tue, wed, thu, fri, sat, sun, mon-fri, etc.
sabx schedule set <name> --set hour=02
sabx schedule delete <name> # Delete taskConfiguration
sabx config get <section> # Get config section
sabx config get misc # General settings
sabx config get servers # Server configs
sabx config get <section> --key <keyword> # Get specific key
sabx config set <section> --set key=value
sabx config set <section> --name <item> --set key=value # Named item
sabx config delete <section> --key <keyword> # Delete by keyword
sabx config delete <section> --name <itemname> # Delete named item
# Special config operations
sabx config rotate-api-key # Generate new API key
sabx config rotate-nzb-key # Generate new NZB key
sabx config regenerate-certs # Regenerate SSL certs
sabx config backup # Create config backup
sabx config purge-logs # Purge log files
sabx config reset-default <key> # Reset to default
sabx config set-pause <minutes> # Set auto-resume timerFilesystem & Watched Folders
sabx browse / # Browse SAB server filesystem
sabx browse /downloads --files # Include files
sabx browse /downloads --json # JSON output
sabx watched scan # Trigger watched folder scan
sabx watched scan --json # JSON outputNotifications
sabx notifications test email # Test email notification
sabx notifications test pushover # Test Pushover
sabx notifications test apprise # Test Apprise
sabx notifications test prowl # Test Prowl
sabx notifications test pushbullet
sabx notifications test desktop # Desktop notification
sabx notifications test windows # Windows notification
sabx notifications test script # Notification scriptQuota
sabx quota reset # Reset download quota countersDebug & Development
sabx debug gc-stats # Go GC statistics
sabx debug eval-sort "<pattern>" --job "Show.Name" # Test sort pattern
sabx dump config # Export sanitized config
sabx dump state # Export current state
sabx translate <key> # Resolve UI translation keyScripts
sabx scripts list # Available post-processing scriptsExtensions
sabx extension list # List installed extensions
sabx extension install <repo> # Install from GitHub
sabx extension install avivsinai/sabx-tv-tools
sabx extension remove <name> # Remove extensionLive Dashboard
sabx top # Interactive Bubble Tea dashboardGlobal Options
All commands support:
--json— JSON output for scripting--quiet— Suppress non-error output--profile <name>— Use specific profile--base-url <url>— Override SABnzbd URL--api-key <key>— Override API key--help— Command help
Environment Variables
SABX_BASE_URL— SABnzbd server URLSABX_API_KEY— API key (prefer keyring)SABX_CONFIG_DIR— Config directory overrideSABX_ALLOW_INSECURE_STORE— Allow file-based credential storage
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.