| name | nzbget-list |
| description | List the NZBGet download queue (active groups) and recent history (last 10 entries) via the JSON-RPC API with HTTP Basic auth. |
| version | 0.1.0 |
| author | dobry-ops |
| license | MIT |
| metadata | {"hermes":{"tags":["media","nzbget","usenet","downloads"],"category":"media-ordering","related_skills":["arr-search","qbit-list"]}} |
nzbget-list
Read-only view of NZBGet's current queue and recent history.
When to use
User asks about Usenet download status — "what's in nzbget", "anything
stalled on usenet", "is the new episode done downloading", etc.
Env vars
$NZBGET_URL
$NZBGET_USERNAME (the hale restricted user — add/list/monitor only)
$NZBGET_PASSWORD
How
NZBGet uses HTTP Basic auth on a single JSON-RPC endpoint.
Active queue (current downloads):
curl -sf -u "$NZBGET_USERNAME:$NZBGET_PASSWORD" \
-H 'Content-Type: application/json' \
-d '{"method":"listgroups","params":[0]}' \
"$NZBGET_URL/jsonrpc" \
| jq '.result | map({NZBName, Status, RemainingSizeMB, Category})'
Recent history (completed / failed / parked):
curl -sf -u "$NZBGET_USERNAME:$NZBGET_PASSWORD" \
-H 'Content-Type: application/json' \
-d '{"method":"history","params":[false]}' \
"$NZBGET_URL/jsonrpc" \
| jq '.result[0:10] | map({Name, Status, Category, DestDir})'
Output format for the user
Queue:
[1] some.show.s01e02.1080p.WEB-DL.x265
Status: DOWNLOADING Remaining: 412 MB Category: sonarr
History (last 10):
[1] some.movie.2024.1080p.BluRay.x265 ✓ SUCCESS/HEALTH movies
Rules
- READ-ONLY for this skill (the hale user is anyway restricted to
add+list+monitor by NZBGet's role — no config-changing methods would
succeed if you tried).
- Reference env vars by NAME; never paste values into chat.
- If you get HTTP 401, password is wrong — say so, don't retry.