thwap-sonarr: Sonarr Utilities

A Python package for managing Sonarr shows and root folders.

Installation

From source

git clone <repository>
cd thwap-sonarr
pip install -e .

As a standalone script

You can run sonarr-mover.py directly:

chmod +x sonarr-mover.py
./sonarr-mover.py --help

Configuration

Set environment variables:

• SONARR_API_KEY: Your Sonarr API key (required)
• SONARR_URL: Sonarr base URL (default: http://localhost:8989)

Usage

Command Line

# List available root folders
sonarr-mover -l

# List shows in a specific folder
sonarr-mover -l "/path/to/root/folder"

# Move all shows from one root folder to another
sonarr-mover "/source/share" "/target/share"

# Move a specific show by its exact path
sonarr-mover "/path/to/show" "/target/share"

Options

• -v, --verbose: Enable verbose debug output
• -n, --dry-run: Perform a dry run without making changes
• -y, --assume-yes: Assume "yes" to all prompts (use with caution!)
• -l [FOLDER]: List root folders, or shows in a given folder

Python API

from thwap.sonarr import SonarrClient, get_sonarr_config

# Get configuration from environment
base_url, api_key = get_sonarr_config()

# Create client
client = SonarrClient(base_url, api_key, verbose=True)

# Get root folders
folders = client.get_root_folders()

# Get all series
series = client.get_series()

Development

Project follows Python conventions as described in conventions/python.md.

Run tests (if any) with pytest:

pytest

License

MIT