starr-manager

name	starr-manager
description	Search Prowlarr indexers, monitor Radarr/Sonarr libraries, identify missing/stalled items, see release alternatives, request media via Seerr, and grab them.
version	1.0.0
author	Antigravity
license	MIT
metadata	{"hermes":{"tags":["media","torrents","usenet","self-hosted","automation"],"category":"productivity"}}
required_environment_variables	[{"name":"PROWLARR_URL","prompt":"Prowlarr URL (e.g. http://localhost:9696)","required_for":"Searching indexers and grabbing torrents/NZBs"},{"name":"PROWLARR_API_KEY","prompt":"Prowlarr API Key","required_for":"Authenticating with Prowlarr API"},{"name":"RADARR_URL","prompt":"Radarr URL (e.g. http://localhost:7878)","required_for":"Monitoring movie collection and alternative release grabbing"},{"name":"RADARR_API_KEY","prompt":"Radarr API Key","required_for":"Authenticating with Radarr API"},{"name":"SONARR_URL","prompt":"Sonarr URL (e.g. http://localhost:8989)","required_for":"Monitoring series/episode collection and alternative release grabbing"},{"name":"SONARR_API_KEY","prompt":"Sonarr API Key","required_for":"Authenticating with Sonarr API"},{"name":"SEERR_URL","prompt":"Seerr URL (e.g. http://localhost:5055)","required_for":"Searching and requesting media on Overseerr/Jellyseerr"},{"name":"SEERR_API_KEY","prompt":"Seerr API Key","required_for":"Authenticating with Seerr API"}]

Starr Manager

A unified skill to manage self-hosted media servers via Prowlarr, Radarr, Sonarr, and Seerr (Overseerr/Jellyseerr). It lists missing library content, identifies stalled downloads, searches indexers for release alternatives, requests content, and downloads them.

---

When to Use

• When the user wants to search for torrents/NZBs generally across Prowlarr indexers.
• When the user requests a status check on their movie or series downloads.
• When a download is stalled, blocked, or slow, and you need to delete/blocklist it and choose a better alternative release.
• When checking which monitored movies or TV episodes are missing from the collection.
• When the user wants to search for and request movies or TV shows on Seerr (Overseerr/Jellyseerr).

---

Quick Reference

Prowlarr Commands

Task	Command
Search Indexers	python3 ${HERMES_SKILL_DIR}/scripts/prowlarr.py --url "$PROWLARR_URL" --api-key "$PROWLARR_API_KEY" search "<query>"
Grab Search Result	python3 ${HERMES_SKILL_DIR}/scripts/prowlarr.py --url "$PROWLARR_URL" --api-key "$PROWLARR_API_KEY" grab <index>

Radarr (Movies) Commands

Task	Command
List Missing Monitored	python3 ${HERMES_SKILL_DIR}/scripts/radarr.py --url "$RADARR_URL" --api-key "$RADARR_API_KEY" list-missing
List Stalled Queue	python3 ${HERMES_SKILL_DIR}/scripts/radarr.py --url "$RADARR_URL" --api-key "$RADARR_API_KEY" list-stalled
Remove & Blocklist Stalled	python3 ${HERMES_SKILL_DIR}/scripts/radarr.py --url "$RADARR_URL" --api-key "$RADARR_API_KEY" remove-stalled <queue_id>
Search for Alternatives	python3 ${HERMES_SKILL_DIR}/scripts/radarr.py --url "$RADARR_URL" --api-key "$RADARR_API_KEY" search-alternatives <movie_id>
Grab Selected Alternative	python3 ${HERMES_SKILL_DIR}/scripts/radarr.py --url "$RADARR_URL" --api-key "$RADARR_API_KEY" grab <index>

Sonarr (TV Shows) Commands

Task	Command
List Missing Episodes	python3 ${HERMES_SKILL_DIR}/scripts/sonarr.py --url "$SONARR_URL" --api-key "$SONARR_API_KEY" list-missing
List Stalled Queue	python3 ${HERMES_SKILL_DIR}/scripts/sonarr.py --url "$SONARR_URL" --api-key "$SONARR_API_KEY" list-stalled
Remove & Blocklist Stalled	python3 ${HERMES_SKILL_DIR}/scripts/sonarr.py --url "$SONARR_URL" --api-key "$SONARR_API_KEY" remove-stalled <queue_id>
Search for Alternatives	python3 ${HERMES_SKILL_DIR}/scripts/sonarr.py --url "$SONARR_URL" --api-key "$SONARR_API_KEY" search-alternatives <episode_id>
Grab Selected Alternative	python3 ${HERMES_SKILL_DIR}/scripts/sonarr.py --url "$SONARR_URL" --api-key "$SONARR_API_KEY" grab <index>

Seerr (Overseerr/Jellyseerr) Commands

Task	Command
Search Movies/TV	python3 ${HERMES_SKILL_DIR}/scripts/seerr.py --url "$SEERR_URL" --api-key "$SEERR_API_KEY" search "<query>"
Request Movie/TV	python3 ${HERMES_SKILL_DIR}/scripts/seerr.py --url "$SEERR_URL" --api-key "$SEERR_API_KEY" request <index> [--seasons "<seasons>"]

---

Procedure

1. General Search via Prowlarr

1. Perform the search query:

   python3 ${HERMES_SKILL_DIR}/scripts/prowlarr.py --url "$PROWLARR_URL" --api-key "$PROWLARR_API_KEY" search "Show Name or Movie Name"
   

2. Select the best release from the printed table.
3. Grab the release by its index number:

   python3 ${HERMES_SKILL_DIR}/scripts/prowlarr.py --url "$PROWLARR_URL" --api-key "$PROWLARR_API_KEY" grab <index>
   

2. Inspecting and Fixing Stalled/Missing Radarr (Movies) Collection

1. Find missing items: Run list-missing to see monitored movies without files.

   python3 ${HERMES_SKILL_DIR}/scripts/radarr.py --url "$RADARR_URL" --api-key "$RADARR_API_KEY" list-missing
   

2. Find stalled queue items: Run list-stalled.

   python3 ${HERMES_SKILL_DIR}/scripts/radarr.py --url "$RADARR_URL" --api-key "$RADARR_API_KEY" list-stalled
   

3. Handle stalled downloads: If an item in the queue is stalled (e.g. no peers or bad release): a. Note the Queue ID and Movie ID. b. Delete and blocklist the release using:

   python3 ${HERMES_SKILL_DIR}/scripts/radarr.py --url "$RADARR_URL" --api-key "$RADARR_API_KEY" remove-stalled <queue_id>
   

4. Find and grab alternatives: a. Run the interactive search:

   python3 ${HERMES_SKILL_DIR}/scripts/radarr.py --url "$RADARR_URL" --api-key "$RADARR_API_KEY" search-alternatives <movie_id>
   

   b. Note the releases in the output table. Look for items marked as "Approved" with high seeders. c. Grab your preferred release index:

   python3 ${HERMES_SKILL_DIR}/scripts/radarr.py --url "$RADARR_URL" --api-key "$RADARR_API_KEY" grab <index>
   

3. Inspecting and Fixing Stalled/Missing Sonarr (TV) Collection

1. Find missing items: Run list-missing to view missing monitored aired episodes.

   python3 ${HERMES_SKILL_DIR}/scripts/sonarr.py --url "$SONARR_URL" --api-key "$SONARR_API_KEY" list-missing
   

2. Find stalled queue items: Run list-stalled.

   python3 ${HERMES_SKILL_DIR}/scripts/sonarr.py --url "$SONARR_URL" --api-key "$SONARR_API_KEY" list-stalled
   

3. Handle stalled downloads: a. Note the Queue ID and Episode ID. b. Delete and blocklist the release using:

   python3 ${HERMES_SKILL_DIR}/scripts/sonarr.py --url "$SONARR_URL" --api-key "$SONARR_API_KEY" remove-stalled <queue_id>
   

4. Find and grab alternatives: a. Run the interactive search:

   python3 ${HERMES_SKILL_DIR}/scripts/sonarr.py --url "$SONARR_URL" --api-key "$SONARR_API_KEY" search-alternatives <episode_id>
   

   b. Look for "Approved" alternatives with seeders. c. Grab the release:

   python3 ${HERMES_SKILL_DIR}/scripts/sonarr.py --url "$SONARR_URL" --api-key "$SONARR_API_KEY" grab <index>
   

4. Searching and Requesting via Seerr (Overseerr/Jellyseerr)

1. Search for a movie or TV show:

   python3 ${HERMES_SKILL_DIR}/scripts/seerr.py --url "$SEERR_URL" --api-key "$SEERR_API_KEY" search "Search Query"
   

2. Select the index of the item you want to request.
3. Request the item:
   • For a Movie or to request all seasons of a TV show:

     python3 ${HERMES_SKILL_DIR}/scripts/seerr.py --url "$SEERR_URL" --api-key "$SEERR_API_KEY" request <index>
     

   • For a TV show, to request specific seasons (e.g. seasons 1 and 2):

     python3 ${HERMES_SKILL_DIR}/scripts/seerr.py --url "$SEERR_URL" --api-key "$SEERR_API_KEY" request <index> --seasons "1,2"
     

---

Pitfalls

• Authentication Errors: Ensure environment variables (*_URL and *_API_KEY) match exactly.
• Network Timeouts: Live searches can query dozens of indexers and might take 30+ seconds. Allow the command to finish.
• Caching: The grab/request commands depend on the cache JSON files (prowlarr_last_search.json, radarr_last_search.json, sonarr_last_search.json, seerr_last_search.json). Always run the corresponding search or search-alternatives command before a grab/request action.
• Category Mismatch: In general Prowlarr searches, if the torrent/NZB doesn't match standard category rules of your download client, download clients might dump them in default directories. Use Radarr/Sonarr commands where possible for automated matching.

---

Verification

• Run python3 ${HERMES_SKILL_DIR}/scripts/radarr.py --url "$RADARR_URL" --api-key "$RADARR_API_KEY" list-stalled (or sonarr) to verify the queue is updated.
• Validate that a grabbed release appears in the client/queue with a healthy progress bar or peer count.