radarr

name	radarr
description	This skill should be used when the user wants to manage movies in Radarr. Triggers include: "add a movie", "search Radarr", "find a film", "download a movie", "remove a movie", "add movie collection", "check if movie exists", "is [film] in my library", "monitor a film", "check download queue", "Radarr library", or any mention of movie management or TMDB integration.

Radarr Movie Management Skill

Search and add movies to your Radarr library with support for collections, quality profiles, and search-on-add.

Purpose

This skill enables management of your Radarr movie library:

• Search for movies by name
• Add individual movies or entire collections
• Check if movies already exist
• Remove movies (with optional file deletion)
• View quality profiles and root folders

Operations include both read and write actions. Always confirm before removing movies with file deletion.

Setup

Credentials are configured in the plugin settings (userConfig). A SessionStart hook writes them to ~/.config/lab-radarr/config.env, which the scripts load automatically — no manual file editing. Variables used:

RADARR_URL="http://localhost:7878"
RADARR_API_KEY="your-api-key"
RADARR_DEFAULT_QUALITY_PROFILE="1"  # Optional (defaults to 1)

• RADARR_URL: Your Radarr server URL (no trailing slash)
• RADARR_API_KEY: API key from Radarr (Settings → General → API Key)
• RADARR_DEFAULT_QUALITY_PROFILE: Quality profile ID (optional, run config command to see options)

Commands

Run commands from this skill directory. The helper prints human-readable output for interactive commands and offers search-json when raw lookup JSON is needed.

Search for Movies

bash scripts/radarr.sh search "Inception"
bash scripts/radarr.sh search "The Matrix"

Output: Numbered list with TMDB IDs, titles, years, and overview.

Search for Movies (raw JSON)

bash scripts/radarr.sh search-json "Inception"

Output: Raw Radarr lookup JSON (for scripting / exact field access).

Check if Movie Exists

bash scripts/radarr.sh exists <tmdbId>

Output: Boolean indicating if movie is in library.

Add a Movie

bash scripts/radarr.sh add <tmdbId>              # Searches immediately (default)
bash scripts/radarr.sh add <tmdbId> <profileId>  # Use a specific quality profile
bash scripts/radarr.sh add <tmdbId> --no-search  # Add without searching

Add Full Collection

bash scripts/radarr.sh add-collection <collectionTmdbId> "<search term>"
bash scripts/radarr.sh add-collection <collectionTmdbId> --no-search

Adds all movies in a collection (e.g., all Lord of the Rings movies). Provide a search term when Radarr has not already indexed the collection name.

Remove a Movie

bash scripts/radarr.sh remove <tmdbId>                # Keep files
bash scripts/radarr.sh remove <tmdbId> --delete-files # Delete files too

Important: Always ask the user if they want to delete files when removing!

Get Configuration

bash scripts/radarr.sh config

Output: Available root folders and quality profiles with their IDs.

Collection Info

bash scripts/radarr.sh collection-info <collectionTmdbId>

Output: Radarr's stored details for a TMDB collection (members, monitoring).

Workflow

When the user asks about movies:

1. "Add Inception to Radarr" → Run search "Inception", present results with TMDB links, then add <tmdbId>
2. "Is Dune in my library?" → Run exists <tmdbId>
3. "Add all Star Wars movies" → Search for collection, then add-collection <collectionId>
4. "Remove The Matrix" → Ask about file deletion, then run remove <tmdbId> with appropriate flag
5. "What quality profiles do I have?" → Run config

Presenting Search Results

Always include TMDB links when presenting search results:

• Format: [Title (Year)](https://themoviedb.org/movie/ID)
• Show numbered list for user selection
• Include year and brief overview

Adding Movies

1. Search for the movie
2. Present results with TMDB links
3. User picks a number
4. Collection check: If movie is part of a collection, ask if they want the whole collection
5. Add movie or collection (searches immediately by default)

Parameters

add command

• <tmdbId>: TMDB ID of the movie (required)
• <profileId>: optional Radarr quality profile ID
• --no-search: Don't search for movie after adding

add-collection command

• <collectionTmdbId>: TMDB ID of the collection (required)
• <search term>: optional movie search term used to discover collection members
• --no-search: Don't search for movies after adding

remove command

• <tmdbId>: TMDB ID of the movie (required)
• --delete-files: Also delete media files (default: keep files)

Notes

• Requires network access to your Radarr server
• Uses Radarr API v3
• Use search-json or direct API calls from references/ when JSON output is required
• Quality profile IDs vary by installation — use config to discover yours
• The RADARR_DEFAULT_QUALITY_PROFILE from config is used when adding movies
• Collections are TMDB-specific and include related movies (sequels, franchises)

Reference

• Radarr API Documentation
• TMDB — The Movie Database

For detailed local reference, see:

• API Endpoints - Complete endpoint reference with parameters
• Quick Reference - Common operations with copy-paste examples
• Troubleshooting - Authentication, connection, and error solutions

---