Skip to content

README.md

Latest commit

 

History

History
102 lines (65 loc) · 5.07 KB

README.md

File metadata and controls

102 lines (65 loc) · 5.07 KB

Tagarr

Automated movie tagging for Radarr based on release groups, with release group recovery for both Radarr and Sonarr.

What Does This Do?

When you download movies through Radarr, each release comes from a release group (like FLUX, BHD, FraMeSToR, etc.). Some groups consistently deliver premium quality — lossless audio (TrueHD Atmos, DTS:X), high-bitrate encodes, or WEB-DLs from premium sources like Movies Anywhere.

Tagarr automatically tags movies in Radarr based on which release group made the file, with optional quality and audio filtering so only premium releases get tagged. It also recovers missing release groups in both Radarr and Sonarr by looking up the original grab in history.

Warning: These scripts modify Radarr/Sonarr metadata (tags, release groups) and can trigger file renames. Always run in dry-run mode first and review the output before using --live. Use at your own risk.

Guides

Guide Script(s) What It Covers
Batch Tagger tagarr.sh Library scanning, quality/audio filters, discovery, dual instance sync. Start here.
Recovery tagarr_recover.sh Batch release group recovery, 5-point safety chain, Radarr + Sonarr.
Import Handlers tagarr_import.sh, tagarr_import_sonarr.sh Real-time Connect handlers for tagging (Radarr) and recovery (Sonarr).
Migration & Auto-Update tagarr_migrate.sh Keep scripts and configs up to date. Opt-in auto-update, config migration, multi-directory support.
Troubleshooting All Common issues, screenshots, debug instructions, reporting.

New to Tagarr? Start with the Batch Tagger Guide — it explains the core concepts and includes the recommended workflow for setting up all scripts.

Quick Start

git clone https://github.com/prophetse7en/tagarr.git
cd tagarr && chmod +x tagarr*.sh

Requirements: Radarr v3+ and/or Sonarr v3+, bash 4+, jq, curl

# 1. Configure
cp tagarr.conf.sample tagarr.conf && nano tagarr.conf

# 2. Fix missing release groups in your backlog
./tagarr_recover.sh --live

# 3. Tag your library
./tagarr.sh

# 4. Set up Connect handlers for real-time (see Import Guide)
# 5. Schedule tagarr.sh + tagarr_recover.sh as a safety net

Scripts

Core Scripts

Script App Purpose Run As
tagarr.sh Radarr Scan all movies, tag by release group with filters, discovery Schedule or manual
tagarr_recover.sh Both Fix missing release groups from grab history Schedule or manual
tagarr_import.sh Radarr Tag + recover + discover on every import Radarr Connect
tagarr_import_sonarr.sh Sonarr Recover missing release groups on every import Sonarr Connect

Utility Scripts

tagarr_list.sh — Tags movies from TMDb or Trakt lists. Useful for curated collections like "Reference Audio", "Oscar Winners", or director filmographies. Define lists in tagarr_list.conf with format "source:list_id:tag_name:display_name". Runs on a schedule or manually.

tagarr_migrate.sh — Keeps your tagarr scripts and configs up to date. Two features:

  1. Config migration (always on) — Updates your .conf files when new settings are added. Downloads the latest sample from GitHub, adds new fields with safe defaults, and keeps all your existing values. Your original config is backed up to tagarr_backups/ with a date stamp.

  2. Script auto-update (opt-in) — Automatically updates your tagarr .sh scripts to the latest version from GitHub. Enable per script in tagarr_migrate.conf. Old scripts are backed up to tagarr_backups/ with a date stamp before replacement.

# Run everything — update scripts + migrate all configs
./tagarr_migrate.sh

# Migrate just one config
./tagarr_migrate.sh tagarr_import.conf

See the Migration & Auto-Update Guide for setup instructions.

tagarr_remove.sh — Bulk-removes one or more tags from all movies in one or both Radarr instances. Useful when you want to clean up old tags or start fresh. Dry-run by default.

tagarr_rename.sh — Renames a tag (old name → new name) and migrates all movies to the new tag. Useful when you want to change a tag's name without re-running the full tagger. Dry-run by default.

All scripts default to dry-run mode — no changes until you pass --live.

Support

License

MIT
⚡