Search and add TV shows to Sonarr. Supports monitor options, search-on-add.
Downloads
1.2k
Stars
1
Versions
3
Updated
2026-02-24
Install
npx clawhub@latest install sonarr
Documentation
Sonarr
Add TV shows to your Sonarr library.
Setup
Create ~/.clawdbot/credentials/sonarr/config.json:
{
"url": "http://localhost:8989",
"apiKey": "your-api-key",
"defaultQualityProfile": 1
}
- -
defaultQualityProfile: Quality profile ID (runconfigto 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
defaultQualityProfilefrom config; can override per-add
Commands
Search for shows
bash scripts/sonarr.sh search "Breaking Bad"
Check if show exists in library
bash scripts/sonarr.sh exists <tvdbId>
Add a show (searches immediately by default)
bash scripts/sonarr.sh add <tvdbId> # searches right away
bash scripts/sonarr.sh add <tvdbId> --no-search # don't search
Remove a show
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 scripts/sonarr.sh config
Launch an agent with Sonarr on Termo.