--- name: arrman description: Manage TV series (Sonarr) and films (Radarr) using the arrman CLI. Use this skill whenever the user mentions adding, listing, searching, or getting details about TV shows, series, films, or movies in their media library — including phrases like "add this show", "is X in my library", "what films do I have", "add the movie Y", "show me my TV series", "what quality profiles are available", or any reference to Sonarr, Radarr, TVDB, or IMDB IDs. --- # arrman — Media Library Manager arrman is a CLI tool at `/home/steve/src/arrman/arrman` that manages Steve's TV series (via Sonarr) and films (via Radarr). It talks to the Sonarr and Radarr APIs. ## Commands **Always pass `--json` for structured output.** This gives you clean JSON instead of human-formatted text. ``` arrman --json tv list # List all TV series in library arrman --json tv list "" # Search library by title arrman --json tv list "" --include-external # Search library + external (TVDB) arrman --json films list # List all films in library arrman --json films list "" # Search library by title arrman --json films list "" --include-external # Search library + external (TMDB) arrman --json tv add --profile --rootfolder # Add TV series arrman --json film add --profile --rootfolder # Add film arrman --json tv summary # Detailed info about a TV series arrman --json film summary # Detailed info about a film arrman --json tv profiles # List available TV quality profiles arrman --json film profiles # List available film quality profiles arrman --json tv rootfolders # List available TV root folders arrman --json film rootfolders # List available film root folders ``` ## How to use ### Searching and listing - `list` with no argument shows everything in the library - `list ""` searches the library by title (case-insensitive substring match) - `list "<title>" --include-external` also searches external sources (TVDB for TV, TMDB for films) - `summary` shows detailed info — use a title or an ID (TVDB for TV, IMDB for films) - Fuzzy matching is built in — close-enough titles will match ### Adding media The `add` command requires **both** `--profile` and `--rootfolder`. These tell Sonarr/Radarr which quality to download and where to store files. **Before adding anything, you need to know the profile ID and root folder path.** If the user hasn't already specified these (either in conversation or via a memory/instruction), you must ask. To help them choose, run: ``` arrman tv profiles # for TV arrman film profiles # for films arrman tv rootfolders # for TV arrman film rootfolders # for films ``` Present the options to the user and let them pick. Do not guess or assume defaults. ### Identifying media for add - **TV series by TVDB ID**: if the term is all digits, arrman looks it up as a TVDB ID (e.g. `arrman tv add 81189 --profile 4 --rootfolder /media/tv`) - **TV series by name**: fuzzy-matched against search results (e.g. `arrman tv add "Breaking Bad" --profile 4 --rootfolder /media/tv`) - **Film by IMDB ID**: if the term starts with `tt`, arrman looks it up as an IMDB ID (e.g. `arrman film add tt1160419 --profile 6 --rootfolder /media/movies`) - **Film by name**: fuzzy-matched against search results (e.g. `arrman film add "Dune" --profile 6 --rootfolder /media/movies`) ### Safety - arrman checks if something is already in the library before adding and will refuse with a clear message - If fuzzy matching can't find a confident match, it shows suggestions with IDs so the user can be more specific ## Workflow for adding 1. If the user asks to add something, first check whether you already know the quality profile and root folder (from conversation context, user instructions, or memory) 2. If you don't know either, run the `profiles` and `rootfolders` commands for the relevant domain (tv or film) and present the options 3. Once you have profile and rootfolder, run the `add` command 4. Report back the result — either success confirmation or the error message