arr-media-stack

Radarr, Sonarr, Prowlarr, Bazarr, and qBittorrent APIs for automated media management — search, add, monitor, and troubleshoot downloads

Quality

68%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

Securityby

High

Do not use without reviewing

Fix and improve this skill with Tessl

tessl review fix ./arr-media-stack/SKILL.md

Arr Media Stack

Manage your automated media stack: Radarr (movies), Sonarr (TV), Prowlarr (indexers), Bazarr (subtitles), and qBittorrent (downloads).

All APIs use X-Api-Key header for auth. Base URLs default to http://localhost:<port>/api/v3 (Radarr/Sonarr/Prowlarr) or http://localhost:<port>/api/v2 (Bazarr).

Radarr (Movies) — port 7878

Search and add a movie

# Search by name
curl -s -H "X-Api-Key: YOUR_RADARR_KEY" \
  "http://localhost:7878/api/v3/movie/lookup?term=inception" | jq '.[0] | {title, year, tmdbId}'

# Add movie (use tmdbId from lookup)
curl -s -X POST -H "X-Api-Key: YOUR_RADARR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "tmdbId": 27205,
    "title": "Inception",
    "qualityProfileId": 1,
    "rootFolderPath": "/movies",
    "monitored": true,
    "addOptions": {"searchForMovie": true}
  }' "http://localhost:7878/api/v3/movie"

List and manage movies

# List all movies
curl -s -H "X-Api-Key: YOUR_RADARR_KEY" \
  "http://localhost:7878/api/v3/movie" | jq '.[] | {id, title, year, monitored, hasFile}'

# Get specific movie
curl -s -H "X-Api-Key: YOUR_RADARR_KEY" \
  "http://localhost:7878/api/v3/movie/1"

# Delete movie (with files)
curl -s -X DELETE -H "X-Api-Key: YOUR_RADARR_KEY" \
  "http://localhost:7878/api/v3/movie/1?deleteFiles=true"

# Trigger search for missing movies
curl -s -X POST -H "X-Api-Key: YOUR_RADARR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name": "MissingMoviesSearch"}' \
  "http://localhost:7878/api/v3/command"

Queue and downloads

# View download queue
curl -s -H "X-Api-Key: YOUR_RADARR_KEY" \
  "http://localhost:7878/api/v3/queue" | jq '.records[] | {title, status, sizeleft, timeleft}'

# System health
curl -s -H "X-Api-Key: YOUR_RADARR_KEY" \
  "http://localhost:7878/api/v3/health" | jq '.[] | {type, message}'

# Root folders
curl -s -H "X-Api-Key: YOUR_RADARR_KEY" \
  "http://localhost:7878/api/v3/rootfolder" | jq '.[] | {path, freeSpace}'

# Quality profiles
curl -s -H "X-Api-Key: YOUR_RADARR_KEY" \
  "http://localhost:7878/api/v3/qualityprofile" | jq '.[] | {id, name}'

Sonarr (TV Shows) — port 8989

Search and add a series

# Search by name
curl -s -H "X-Api-Key: YOUR_SONARR_KEY" \
  "http://localhost:8989/api/v3/series/lookup?term=breaking+bad" | jq '.[0] | {title, year, tvdbId}'

# Add series
curl -s -X POST -H "X-Api-Key: YOUR_SONARR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "tvdbId": 81189,
    "title": "Breaking Bad",
    "qualityProfileId": 1,
    "rootFolderPath": "/tv",
    "monitored": true,
    "addOptions": {"searchForMissingEpisodes": true}
  }' "http://localhost:8989/api/v3/series"

List and manage series

# List all series
curl -s -H "X-Api-Key: YOUR_SONARR_KEY" \
  "http://localhost:8989/api/v3/series" | jq '.[] | {id, title, year, monitored, episodeFileCount, episodeCount}'

# Upcoming episodes
curl -s -H "X-Api-Key: YOUR_SONARR_KEY" \
  "http://localhost:8989/api/v3/calendar?start=$(date +%F)&end=$(date -d '+7 days' +%F)" | \
  jq '.[] | {series: .series.title, episode: .title, airDate: .airDate}'

# Missing episodes
curl -s -H "X-Api-Key: YOUR_SONARR_KEY" \
  "http://localhost:8989/api/v3/wanted/missing?pageSize=20" | jq '.records[] | {series: .series.title, episode: .title, airDate: .airDate}'

# Trigger search for missing episodes
curl -s -X POST -H "X-Api-Key: YOUR_SONARR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name": "MissingEpisodeSearch"}' \
  "http://localhost:8989/api/v3/command"

# Queue
curl -s -H "X-Api-Key: YOUR_SONARR_KEY" \
  "http://localhost:8989/api/v3/queue" | jq '.records[] | {title, status, sizeleft, timeleft}'

Prowlarr (Indexers) — port 9696

Manage indexers

# List indexers
curl -s -H "X-Api-Key: YOUR_PROWLARR_KEY" \
  "http://localhost:9696/api/v1/indexer" | jq '.[] | {id, name, enable, protocol}'

# Test indexer
curl -s -X POST -H "X-Api-Key: YOUR_PROWLARR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"id": 1}' \
  "http://localhost:9696/api/v1/indexer/test"

# Sync indexers to Radarr/Sonarr
curl -s -X POST -H "X-Api-Key: YOUR_PROWLARR_KEY" \
  "http://localhost:9696/api/v1/application/action/sync"

# List linked applications
curl -s -H "X-Api-Key: YOUR_PROWLARR_KEY" \
  "http://localhost:9696/api/v1/application" | jq '.[] | {id, name, syncLevel}'

# Search across all indexers
curl -s -H "X-Api-Key: YOUR_PROWLARR_KEY" \
  "http://localhost:9696/api/v1/search?query=inception&type=movie" | \
  jq '.[] | {title, indexer, size, seeders}'

FlareSolverr (Cloudflare bypass)

FlareSolverr runs alongside Prowlarr to bypass Cloudflare-protected indexers.

# Health check
curl -s http://localhost:8191/v1 -d '{"cmd": "sessions.list"}' -H "Content-Type: application/json"

Configure in Prowlarr: Settings → Indexer Proxies → Add → FlareSolverr → http://flaresolverr:8191

Bazarr (Subtitles) — port 6767

# List wanted subtitles (movies)
curl -s -H "X-Api-Key: YOUR_BAZARR_KEY" \
  "http://localhost:6767/api/movies/wanted" | jq '.data[] | {title, missing_subtitles}'

# List wanted subtitles (series)
curl -s -H "X-Api-Key: YOUR_BAZARR_KEY" \
  "http://localhost:6767/api/episodes/wanted" | jq '.data[] | {seriesTitle, episodeTitle, missing_subtitles}'

# Trigger search for wanted subtitles
curl -s -X POST -H "X-Api-Key: YOUR_BAZARR_KEY" \
  "http://localhost:6767/api/subtitles/wanted/movies"

# System health
curl -s -H "X-Api-Key: YOUR_BAZARR_KEY" \
  "http://localhost:6767/api/system/health"

qBittorrent — port 8080

qBittorrent uses cookie-based auth. Login first, then use the cookie.

# Login (save cookie)
curl -s -c /tmp/qbt-cookies.txt \
  -d "username=admin&password=YOUR_PASSWORD" \
  "http://localhost:8080/api/v2/auth/login"

# List all torrents
curl -s -b /tmp/qbt-cookies.txt \
  "http://localhost:8080/api/v2/torrents/info" | \
  jq '.[] | {name, state, progress, dlspeed, size}'

# List active downloads
curl -s -b /tmp/qbt-cookies.txt \
  "http://localhost:8080/api/v2/torrents/info?filter=downloading" | \
  jq '.[] | {name, progress: (.progress * 100 | round), dlspeed, eta}'

# Pause/resume torrent
curl -s -b /tmp/qbt-cookies.txt -d "hashes=TORRENT_HASH" \
  "http://localhost:8080/api/v2/torrents/pause"
curl -s -b /tmp/qbt-cookies.txt -d "hashes=TORRENT_HASH" \
  "http://localhost:8080/api/v2/torrents/resume"

# Delete torrent (with files)
curl -s -b /tmp/qbt-cookies.txt -d "hashes=TORRENT_HASH&deleteFiles=true" \
  "http://localhost:8080/api/v2/torrents/delete"

# Transfer info (global speeds)
curl -s -b /tmp/qbt-cookies.txt \
  "http://localhost:8080/api/v2/transfer/info" | jq '{dl_info_speed, up_info_speed}'

VPN container networking

qBittorrent commonly runs through a VPN container (nordvpn, gluetun, etc.):

services:
  vpn:
    image: bubuntux/nordlynx  # or qmcgaw/gluetun
    cap_add: [NET_ADMIN]
    ports:
      - "8080:8080"  # qBittorrent WebUI exposed through VPN
    environment:
      - PRIVATE_KEY=your-wireguard-key

  qbittorrent:
    image: lscr.io/linuxserver/qbittorrent
    network_mode: "service:vpn"  # Route all traffic through VPN
    depends_on: [vpn]

Overseerr (Media Requests) — port 5055

# Search
curl -s -H "X-Api-Key: YOUR_OVERSEERR_KEY" \
  "http://localhost:5055/api/v1/search?query=inception" | jq '.results[] | {title, mediaType, year}'

# Request a movie
curl -s -X POST -H "X-Api-Key: YOUR_OVERSEERR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"mediaType": "movie", "mediaId": 27205}' \
  "http://localhost:5055/api/v1/request"

# List pending requests
curl -s -H "X-Api-Key: YOUR_OVERSEERR_KEY" \
  "http://localhost:5055/api/v1/request?filter=pending" | jq '.results[] | {id, type: .type, status: .status, media: .media.tmdbId}'

Common storage layout

/opt/media/
├── downloads/      # qBittorrent download directory
├── movies/         # Radarr movie library
├── tv/             # Sonarr TV library
├── radarr/         # Radarr config
├── sonarr/         # Sonarr config
├── prowlarr/       # Prowlarr config
└── qbittorrent/    # qBittorrent config

Troubleshooting

Problem	Service	Fix
Download stuck at 100%	Radarr/Sonarr	Check import errors in Activity → Queue. Usually permissions or path mapping
No results from search	Prowlarr	Check indexer health. Test individual indexers. Try FlareSolverr for Cloudflare sites
"Path does not exist"	Radarr/Sonarr	Docker volume mounts don't match. Ensure paths inside container match config
Torrent stalled	qBittorrent	Check VPN connection. Restart VPN container. Verify port forwarding
Subtitle not found	Bazarr	Check provider API limits. Add more subtitle providers in Settings
Can't reach qBittorrent UI	qBittorrent	It's behind VPN container. Check VPN container ports, not qBittorrent's
Import failed	Radarr/Sonarr	Check PUID/PGID match between containers. Verify write permissions on library folder

Health check all services

for svc in "radarr:7878" "sonarr:8989" "prowlarr:9696"; do
  name="${svc%%:*}"; port="${svc##*:}"
  status=$(curl -s -o /dev/null -w "%{http_code}" -H "X-Api-Key: YOUR_KEY" \
    "http://localhost:$port/api/v3/system/status")
  echo "$name: $status"
done

Repository: ddnetters/homelab-agent-skills
Path: arr-media-stack/SKILL.md
Commit: 808c382

Last updated: 1 day ago
First committed: 5 months ago

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.