# arrman

A CLI tool for managing Sonarr (TV) and Radarr (films) libraries.

Single self-contained Go binary with no external dependencies. Talks to the Sonarr and Radarr v3 APIs using API tokens.

## Setup

Create a `.env` file in the project root:

```
SONARR_URL=https://your-sonarr-instance
SONARR_API_KEY=your-sonarr-api-key
RADARR_URL=https://your-radarr-instance
RADARR_API_KEY=your-radarr-api-key
```

Set `ARRMAN_TLS_SKIP_VERIFY=true` to skip TLS certificate verification (e.g. for self-signed certs).

## Build

```bash
go build -ldflags "-X main.Version=$(cat VERSION)" -o arrman .
```

Or use the publish script, which handles version incrementing:

```bash
./publish.sh              # interactive — asks whether to increment
./publish.sh --increment  # non-interactive — auto-increments patch version
```

## Usage

```
arrman <domain> <action> [args...]
```

Domains: `tv`, `film` (or `films`)

### List library

```bash
arrman tv list                          # all TV series
arrman tv list "breaking"               # filter by title
arrman tv list "breaking" --include-external  # include results from TheTVDB

arrman films list                       # all films
arrman films list "matrix"              # filter by title
arrman films list "matrix" --include-external  # include results from Radarr sources
```

### Add to library

Search and add use fuzzy matching, so you don't need an exact title:

```bash
arrman tv add "brking bad" --profile 1 --rootfolder /tv       # fuzzy matches "Breaking Bad"
arrman tv add 81189 --profile 1 --rootfolder /tv              # by TheTVDB ID

arrman film add "the matrx" --profile 1 --rootfolder /movies  # fuzzy matches "The Matrix"
arrman film add tt0133093 --profile 1 --rootfolder /movies    # by IMDB ID
```

If the match isn't confident enough, arrman shows suggestions with IDs so you can be more specific.

Use `profiles` and `rootfolders` to find valid values:

```bash
arrman tv profiles
arrman tv rootfolders
arrman film profiles
arrman film rootfolders
```

### Show details

```bash
arrman tv summary "Breaking Bad"
arrman tv summary 81189              # by TheTVDB ID

arrman film summary "The Matrix"
arrman film summary tt0133093        # by IMDB ID
```

## Agent Skill

A [SKILL.md](SKILL.md) file is included for use with [Claude Code](https://claude.ai/code) and other SKILL compatible AI agents. It provides structured instructions so the agent can operate arrman on your behalf — searching, listing, and adding media through natural conversation.