sonarr-fixed

What This Skill Does

The sonarr-fixed skill is a specialized agent capability designed to automate the management of your media library through Sonarr. Serving as a robust fork of the original jordyvandomselaar/sonarr skill, this version resolves critical metadata issues, ensuring a reliable interface between OpenClaw and your Sonarr instance. It allows you to search for new television shows, verify if they currently exist in your library, add them with custom quality profiles, and perform library cleanup operations. The skill is built to integrate seamlessly into your media server workflow, providing direct TVDB links for every search result so that you can verify the correct series before triggering an add command.

Installation

To get started, first install the skill via the OpenClaw CLI: clawhub install openclaw/skills/skills/frannunpal/sonarr-fixed. Once installed, you must authenticate the agent by creating a configuration file at ~/.openclaw/credentials/sonarr/config.json. The file should contain your Sonarr base URL, API key, and your preferred default quality profile ID. Alternatively, you can export these settings as environment variables SONARR_URL and SONARR_API_KEY. It is recommended to run the config command provided by the script to list available root folders and quality profiles specific to your Sonarr instance before attempting to add content.

Use Cases

This skill is perfect for users who want to manage their media collections via natural language. Typical use cases include: quickly adding a new show that just premiered by searching via the agent, verifying if a show is already being tracked to avoid duplicates, or pruning your library by removing old shows. The ability to toggle the "search-on-add" feature makes it ideal for users who want to trigger an immediate download for current episodes or simply add the show to the monitor list to wait for future arrivals.

Example Prompts

• "Hey OpenClaw, search for the show 'Severance' and show me the details so I can add it."
• "Check if I have 'The Wire' in my library already. If not, add it using the default quality profile."
• "I'm running out of space; can you remove 'Old TV Show' and make sure you delete the files as well?"

Tips & Limitations

Always verify the TVDB link provided in the results to ensure you are adding the intended series, as common names can often lead to incorrect matches. When performing deletions, the agent is configured to default to keeping files for safety; always explicitly confirm whether you want to delete associated media files when the agent prompts you. Ensure your Sonarr instance is reachable at the specified URL and that the API key provided has sufficient permissions to modify your library.