openclaw-workspace/skills/nzb-download/SKILL.md

name, version, description, metadata

name	version	description	metadata
nzb-download	1.0.0	Download movies/TV via NZBGeek API. Use when user asks to download or get a movie/show.	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\nCRITICAL: 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\nBEFORE 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