sonarr

---
name: sonarr
version: 1.0.0
description: Search and add TV shows to Sonarr. Supports monitor options, search-on-add.
metadata: {"clawdbot":{"emoji":"📺","requires":{"bins":["curl","jq"]}}}
---

# Sonarr

Add TV shows to your Sonarr library.

## Setup

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

## Workflow

1. **Search**: `search "Show Name"` - returns numbered list
2. **Present results with TVDB links** - always show clickable links
3. **Check**: User picks a number
4. **Add**: Add show and start search

## Important
- **Always include TVDB links** when presenting search results to user
- Format: `[Title (Year)](https://thetvdb.com/series/SLUG)`
- Uses `defaultQualityProfile` from config; can override per-add

## Commands

### Search for shows
```bash
bash scripts/sonarr.sh search "Breaking Bad"
```

### Check if show exists in library
```bash
bash scripts/sonarr.sh exists <tvdbId>
```

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

### Remove a show
```bash
bash scripts/sonarr.sh remove <tvdbId>                # keep files
bash scripts/sonarr.sh remove <tvdbId> --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/sonarr.sh config
```