Media & StreamingDocumentedScanned

sonarr

Search and add TV shows to Sonarr.

Share:

Installation

npx clawhub@latest install sonarr

View the full skill documentation and source below.

Documentation

Sonarr

Add TV shows to your Sonarr library.

Setup

Create ~/.clawdbot/credentials/sonarr/config.json:

{
  "url": "",
  "apiKey": "your-api-key",
  "defaultQualityProfile": 1
}

  • defaultQualityProfile: Quality profile ID (run config to see options)


Workflow

  • Search: search "Show Name" - returns numbered list

  • Present results with TVDB links - always show clickable links

  • Check: User picks a number

  • Add: Add show and start search
  • Important

    • Always include TVDB links when presenting search results to user
    • Format: [Title (Year)]()
    • Uses defaultQualityProfile from 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