home / skills / openclaw / skills / radarr

radarr skill

safe

/skills/jordyvandomselaar/radarr

This skill helps you search, verify, and add movies to Radarr with collection support and TMDB links.

npx playbooks add skill openclaw/skills --skill radarr

Review the files below or copy the command above to add this skill to your agents.

Files (3)

SKILL.md

1.9 KB

---
name: radarr
version: 1.0.1
description: Search and add movies to Radarr. Supports collections, search-on-add option.
metadata: {"clawdbot":{"emoji":"🎬","requires":{"bins":["curl","jq"]}}}
---

# Radarr

Add movies to your Radarr library with collection support.

## Setup

Create `~/.clawdbot/credentials/radarr/config.json`:
```json
{
  "url": "http://localhost:7878",
  "apiKey": "your-api-key",
  "defaultQualityProfile": 1
}
```
- `defaultQualityProfile`: Quality profile ID (run `config` to see options)

## Workflow

1. **Search**: `search "Movie Name"` - returns numbered list
2. **Present results with TMDB links** - always show clickable links
3. **Check**: User picks a number
4. **Collection prompt**: If movie is part of collection, ask user
5. **Add**: Add movie or full collection

## Important
- **Always include TMDB links** when presenting search results to user
- Format: `[Title (Year)](https://themoviedb.org/movie/ID)`
- Uses `defaultQualityProfile` from config; can override per-add

## Commands

### Search for movies
```bash
bash scripts/radarr.sh search "Inception"
```

### Check if movie exists in library
```bash
bash scripts/radarr.sh exists <tmdbId>
```

### Add a movie (searches immediately by default)
```bash
bash scripts/radarr.sh add <tmdbId>           # searches right away
bash scripts/radarr.sh add <tmdbId> --no-search  # don't search
```

### Add full collection (searches immediately by default)
```bash
bash scripts/radarr.sh add-collection <collectionTmdbId>
bash scripts/radarr.sh add-collection <collectionTmdbId> --no-search
```

### Remove a movie
```bash
bash scripts/radarr.sh remove <tmdbId>              # keep files
bash scripts/radarr.sh remove <tmdbId> --delete-files  # delete files too
```
**Always ask user if they want to delete files when removing!**

### Get root folders & quality profiles (for config)
```bash
bash scripts/radarr.sh config
```

Overview

This skill lets you search for and add movies to a Radarr library, with first-class support for collections and configurable search-on-add behavior. It uses your Radarr instance credentials and a default quality profile, and always presents search results with direct TMDB links for easy verification. The interface provides commands to check existence, add single movies or whole collections, and remove items with optional file deletion.

How this skill works

The skill queries Radarr and TheMovieDB to return a numbered list of matching titles and includes clickable TMDB links in every result. After you pick a result, the skill checks whether the movie is part of a collection and prompts whether to add just the movie or the entire collection. Adding operations use your configured default quality profile by default and support an override to skip the immediate search behavior.

When to use it

Add a single movie to Radarr while preserving correct metadata via TMDB links
Bulk-add a movie collection to ensure all related titles are imported
Confirm whether a movie already exists in your Radarr library before adding
Remove a movie and optionally delete the media files with a confirmation
Retrieve root folders and quality profiles when setting up or updating config

Best practices

Create ~/.clawdbot/credentials/radarr/config.json with url, apiKey, and defaultQualityProfile before using commands
Always inspect TMDB links presented in results to confirm the correct release and year
Use --no-search when you want to add an entry but defer immediate search/monitoring
When removing, always confirm whether to delete files; the tool will prompt but verify first
Run config to view available root folders and quality profile IDs before changing defaults

Example use cases

Quickly add a newly released movie by searching its title and selecting the correct TMDB entry
Import an entire collection after discovering a franchise you want to track
Automate checks in scripts to skip adding titles that already exist in your library
Switch to a different quality profile for a single add without changing the global config
Safely remove a mistaken add while deciding whether to keep or delete the actual files

FAQ

How do I configure the skill to talk to my Radarr server?

Create ~/.clawdbot/credentials/radarr/config.json with your Radarr URL, apiKey, and defaultQualityProfile ID; run the config command to list valid profile and folder IDs.

What does search-on-add mean and how do I disable it?

By default adds trigger an immediate search/monitor in Radarr. Use the --no-search flag on add or add-collection commands to add without searching right away.