Italiano · English

Check for audio language discrepancies across episodes within a season, or across seasons of a TV series, using the Sonarr v4 API.

• 🔍 Scans all series and seasons in Sonarr (v4)
• 🎧 Detects episodes or seasons with mixed audio languages (e.g., half Italian, half English)
• 📦 Outputs either human‑readable text or JSON
• 🧰 Works smoothly with uv for fast, isolated Python environments
• 🧩 Normalizes audio languages: order‑insensitive and common synonyms unified (e.g., en→eng, fra/fre→fra, unknown/undetermined→und)
• 🎯 Wanted languages coverage: report seasons missing or partially supporting your desired languages

❗ Compatible only with Sonarr v4 (/api/v3). Sonarr v3 or lower is not supported.

• uv installed (e.g., brew install uv or the official install script)
• Python 3.8+

git clone https://github.com/alsd4git/sonarr-lang-checker.git cd sonarr-lang-checker

uv run ./main.py --apikey <API_KEY> --url <https://host> [options]

Basic scan:

uv run ./main.py --apikey abc123 --url https://sonarr.example.org

JSON output:

uv run ./main.py --apikey abc123 --url https://sonarr.example.org --json

Save output to file:

uv run ./main.py --apikey abc123 --url https://sonarr.example.org --output risultati.json

Wanted languages (list missing/partial seasons):

uv run ./main.py --apikey abc123 --url https://sonarr.example.org --wanted-langs ita,eng

Show also fully supported seasons (100% episodes match wanted):

uv run ./main.py --apikey abc123 --url https://sonarr.example.org --wanted-langs ita --show-all

For convenience:

./run.sh --apikey abc123 --url https://sonarr.example.org --output out.json

You can define the API key and URL in a .env file:

API_KEY=abc123 SONARR_URL=https://sonarr.example.org 

The script will automatically load these values if not provided via CLI.

sonarr-lang-checker/ ├── main.py # Main script (Sonarr v4 only) ├── pyproject.toml # Dependencies for uv ├── run.sh # Convenience wrapper ├── .env.example # Example env vars ├── language_flags.py # Map language codes → emoji └── README.md

• cron support for scheduled runs
• Dockerfile for containerization
• Web UI or interactive CLI with advanced filtering
• Telegram/email notifications for detected mismatches
• Language code normalization and flags
• CSV export
• .env support already included ✅

Pull requests and suggestions are welcome!

MIT License - Do what you want, just credit the author :) © Alessandro Digilio