4.2 KiB
4.2 KiB
name, description
| name | description |
|---|---|
| arrman | 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>" # Search library by title
arrman --json tv list "<search>" --include-external # Search library + external (TVDB)
arrman --json films list # List all films in library
arrman --json films list "<search>" # Search library by title
arrman --json films list "<search>" --include-external # Search library + external (TMDB)
arrman --json tv add <term> --profile <id> --rootfolder <path> # Add TV series
arrman --json film add <term> --profile <id> --rootfolder <path> # Add film
arrman --json tv summary <term> # Detailed info about a TV series
arrman --json film summary <term> # 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
listwith no argument shows everything in the librarylist "<title>"searches the library by title (case-insensitive substring match)list "<title>" --include-externalalso searches external sources (TVDB for TV, TMDB for films)summaryshows 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
- 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)
- If you don't know either, run the
profilesandrootfolderscommands for the relevant domain (tv or film) and present the options - Once you have profile and rootfolder, run the
addcommand - Report back the result — either success confirmation or the error message