---
name: nzb-download
version: 1.0.0
description: Download movies/TV via NZBGeek API. Use when user asks to download or get a movie/show.
metadata:
  clawdbot:
    emoji: "🎬"
    requires:
      bins: []
---

# NZB Download

Download movies and TV shows via NZBGeek API.

## Setup

Create ~/.clawdbot/credentials/nzbgeek/config.json:
{
  "apiKey": "your-api-key",
  "watchFolder": "pirate/"
}

## Workflow

1. Search - Query NZBGeek API with title + year
2. Filter - Apply preferences from memory/nzb-preferences.md
3. Select - Pick best match (size, quality, audio)
4. Download - Save NZB to watch folder (pirate/)
5. Notify - Confirm download location

## Preferences

Automatically loaded from memory/nzb-preferences.md:
- Language: English only
- Size limit: Under 10GB (unless specified)
- Audio: Atmos preferred

## API Query Format

https://api.nzbgeek.info/api?apikey=KEY&t=movie-search&q=TITLE+YEAR&cat=2040&limit=30

Categories:
- 2040 = Movies HD
- 2050 = Movies BluRay
- 5040 = TV HD

## Important

- Always check memory/nzb-preferences.md before downloading
- Filter results by English language and size limit
- Prefer Atmos/DDP audio when available
- Download NZB file to pirate/ folder for SABnzbd pickup
\n## Download Verification (Added 2026-04-08)\n\n**CRITICAL:** After downloading NZB, verify download actually completes.\n\n### Steps:\n1. Download NZB to pirate/ folder\n2. Wait ~2 minutes for SABnzbd to pick it up\n3. Query SABnzbd queue: `http://192.168.0.32:8282/api?apikey=KEY&mode=queue&output=json`\n4. Confirm status is \"Downloading\" with real file size (not 0)\n5. Schedule completion check via cron (~40 min for ~8GB)\n6. Verify history shows \"Completed\" status\n\n### SABnzbd API:\n- URL: http://192.168.0.32:8282\n- API Key: 40bf61729f1c4701ac55cf36cfb5171a\n- Queue endpoint: mode=queue\n- History endpoint: mode=history\n\n### Trap NZB Detection:\n- Valid metadata but 0 articles downloaded\n- SABnzbd shows \"Completed\" with 0 bytes\n- Multiple release groups = safer bet\n- Check NZBGeek comments/feedback before downloading\n
\n## Plex Library Check (Added 2026-04-08)\n\n**BEFORE downloading, check if movie already exists in Plex.**\n\n### Plex API:\n- URL: http://192.168.0.100:32400\n- Token: kx9sEHxUhvxAXoi3td1f\n- Movies Library ID: 1 (682 movies)\n- 4K Movies Library ID: 4\n\n### Workflow:\n1. Get request to download movie\n2. Query Plex: `/library/sections/1/all?X-Plex-Token=TOKEN`\n3. Search response for `<Video title=\"Movie Title\" year=\"YEAR\">`\n4. If found, warn user and ask to confirm\n5. If not found, proceed with NZB search\n\n### API Example:\n```\nGET http://192.168.0.100:32400/library/sections/1/all?X-Plex-Token=kx9sEHxUhvxAXoi3td1f\n```\n\nReturns XML with all movies. Match on `title` attribute (case-insensitive).\n