arr_scripts

Random collection of scripts and configuration files used by *arr tools in my setup

auto_quality_switch.sh

Automatically switches movies from a Remux-only profile to a WebDL-enabled profile when no physical release appears within a statistically determined threshold (P95 of the web-to-physical gap, computed from your own library).

Movies that wait longer than the threshold for a physical release are unlikely to ever get one. The script switches their profile so Radarr can grab a WebDL release instead of leaving them in permanent limbo.

Prerequisites

• curl and jq 1.6+ (installed by default on most systems)
• Radarr API URL and key configured in scripts.conf

Install jq if missing:

# FreeBSD
pkg install jq

# Debian / Ubuntu
apt install jq

# Fedora / RHEL
dnf install jq

# macOS
brew install jq

Quick start

1. Copy and edit the config:

cp radarr/connect/scripts.conf.sample radarr/connect/scripts.conf

2. Set RADARR_API_URL and RADARR_API_KEY in scripts.conf. Set SOURCE_PROFILE_NAME and TARGET_PROFILE_NAME to match your Radarr quality profile names exactly (case-sensitive).

3. Run in dry-run mode (default) to preview what would switch:

./radarr/auto_quality_switch.sh

4. Run with --apply to actually switch profiles:

./radarr/auto_quality_switch.sh --apply

Migration mode

After initial setup, run --migrate once to fix existing movies that already have downloaded files on the wrong profile:

# Preview what migration would do
./radarr/auto_quality_switch.sh --migrate

# Apply migration
./radarr/auto_quality_switch.sh --migrate --apply

Migration checks each movie's file quality source:

• WebDL/WebRip files — switches profile automatically
• Other files (Bluray, Remux, HDTV, etc.) — logged to stderr for manual review

Migration never triggers search — review the logged movies first.

Flags

Flag	Effect
--apply	Actually switch profiles (overrides DRY_RUN config)
--migrate	One-time library migration mode
-n, --dry-run	Preview mode, no changes (default)
-j, --json	Output machine-readable JSON
-q, --quiet	Only errors and counts, no per-movie list
-d, --debug	Verbose debug logging to stderr

Scheduling

Add to crontab for daily automated runs:

# Dry-run first — review the log for a week
0 6 * * * /path/to/radarr/auto_quality_switch.sh >> /var/log/quality-switch.log 2>&1

# Then switch to apply mode
0 6 * * * /path/to/radarr/auto_quality_switch.sh --apply >> /var/log/quality-switch.log 2>&1

---

auto_quality_switch_reverse.sh

Switches movies back to Remux-only profiles when physical release dates appear for movies previously switched by the forward script. Uses a Radarr tag (auto-switched) to track which movies were switched.

Run weekly — physical releases don't appear daily.

Quick start

1. Uses the same scripts.conf as the forward script.
2. Preview candidates:

./radarr/auto_quality_switch_reverse.sh

3. Apply reverse switch:

./radarr/auto_quality_switch_reverse.sh --apply

The reverse script switches the profile and triggers a search for the Remux release. Radarr handles the rest — downloads the Remux, removes the old WebDL file.

Scheduling

# Weekly, Sunday at 7am
0 7 * * 0 /path/to/radarr/auto_quality_switch_reverse.sh --apply >> /var/log/quality-switch-reverse.log 2>&1

Flags

Same as the forward script (see table above), except --migrate is not available on the reverse script.

---

fix_quality_profiles.sh

Fixes movies that carry the wrong quality profile. Detects movies with a physical release date attached to a "wrong" profile (default [SQP] SQP-3 (Audio)) and switches them to the correct Remux-only profile (default SQP-3-RemuxOnly).

This complements the reverse script: the reverse script only reverts movies tagged auto-switched by the forward script, while this script catches manually-assigned wrong profiles.

Quick start

1. Uses the same scripts.conf as the other scripts. Override the default profile names if your Radarr uses different ones:

   WRONG_PROFILE_NAME="[SQP] SQP-3 (Audio)"
   CORRECT_PROFILE_NAME="SQP-3-RemuxOnly"

2. Preview candidates:

   ./radarr/fix_quality_profiles.sh

3. Apply the fix:

   ./radarr/fix_quality_profiles.sh --apply

The script switches the profile and triggers a search for the Remux release.

Flags

Same as the reverse script (see table above).

Scheduling

# Weekly, Sunday at 7am
0 7 * * 0 /path/to/radarr/fix_quality_profiles.sh --apply >> /var/log/quality-profile-fix.log 2>&1

---

scripts.conf.sample

Configuration file used by all Connect scripts and the auto quality switch scripts. Copy to scripts.conf and edit:

cp radarr/connect/scripts.conf.sample radarr/connect/scripts.conf

See the sample file for all available settings with documentation.

---

fetch_physical_dates.sh

Searches Blu-ray.com for physical release dates missing from Radarr. Useful when TMDB hasn't listed a release date yet (e.g. Supergirl 2026 had a Blu-ray planned for Sep 08 2026 before TMDB had it).

Outputs results as table, JSON, or CSV for manual TMDB submission.

Quick start

# Preview — check 3 movies, show debug output
./radarr/fetch_physical_dates.sh --limit 3 --debug

# Check all movies without physical release dates
./radarr/fetch_physical_dates.sh

# Export to JSON file
./radarr/fetch_physical_dates.sh --export dates.json

# Export to CSV
./radarr/fetch_physical_dates.sh --export dates.csv --csv

Flags

Flag	Effect
--limit N	Process max N movies per run (batch size)
--export <file>	Write results to file (JSON or CSV)
--csv	Export as CSV (default: JSON)
-j, --json	Output machine-readable JSON to stdout
-q, --quiet	Suppress table output
-d, --debug	Verbose debug logging to stderr
--country <code>	Override country filter (default: US)

Scheduling

Run periodically to catch new releases:

# Weekly, check 50 movies at a time
0 8 * * 1 /path/to/radarr/fetch_physical_dates.sh --limit 50 --export /var/log/physical-dates.json >> /var/log/fetch-physical-dates.log 2>&1

---

tmdb_login.sh

Playwright-based TMDB login script that exports session cookies for curl-based automation. Solves AWS WAF JavaScript challenge that blocks automated requests.

Run once on a machine with a display (or Xvfb). The exported cookie file works with both push_physical_to_tmdb.sh and yt-dlp.

Quick start

# Login and export cookies
./radarr/tmdb_login.sh

# Export to custom location
./radarr/tmdb_login.sh --cookies /path/to/cookies.txt

Prerequisites

• Node.js with Playwright package installed
• Chromium browser (installed by Playwright)
• Display server or Xvfb for headed mode

npm install playwright
npx playwright install chromium

Flags

Flag	Effect
--cookies <file>	Output cookie file path (default: ~/.tmdb_cookies.txt)
-d, --debug	Verbose debug logging to stderr

---

push_physical_to_tmdb.sh

Pushes physical release dates to TMDB via their website's Kendo grid REST API. Uses session cookies from tmdb_login.sh.

Accepts single movies via arguments or batch processing via pipe from fetch_physical_dates.sh.

Quick start

# Single movie
./radarr/push_physical_to_tmdb.sh 123456 2026-09-08 "Movie Title"

# Pipeline from fetch_physical_dates.sh
./radarr/fetch_physical_dates.sh --json --quiet | ./radarr/push_physical_to_tmdb.sh

# Dry-run mode
./radarr/push_physical_to_tmdb.sh --dry-run 123456 2026-09-08 "Movie Title"

Prerequisites

• curl, jq, grep, sed (POSIX tools)
• Cookie file from tmdb_login.sh (default: ~/.tmdb_cookies.txt)

Set TMDB_COOKIE_FILE in scripts.conf to use a custom path:

TMDB_COOKIE_FILE="/path/to/cookies.txt"

Flags

Flag	Effect
--dry-run	Show what would be submitted, don't POST
--country <code>	ISO 3166-1 country code (default: US)
--language <code>	ISO 639-1 language code (default: en)
--type <N>	Release type 1-7 (default: 5 = Physical)
--note <text>	Note field (default: "Physical release")
--cookies <file>	Cookie file path (default: ~/.tmdb_cookies.txt)
--rate-limit <s>	Seconds between requests in pipe mode (default: 1)
-d, --debug	Verbose debug logging to stderr

Scheduling

Run after fetch_physical_dates.sh to push found dates:

# Weekly, push dates to TMDB
0 9 * * 1 /path/to/radarr/fetch_physical_dates.sh --json --quiet | /path/to/radarr/push_physical_to_tmdb.sh >> /var/log/push-physical.log 2>&1

---

Contributing

This project follows Conventional Commits and the conventions documented in AGENTS.md.

Looking for more extensive Radarr taggers?

If you need more features or better maintained taggers, check out the Radarr DV HDR Tagarr from TRaSH-. It offers more extensive functionality and active development.

radarr/connect

Script and supporting files to be used as Connect / postprocess scripts in radarr.

tag_dvfelmel.sh

Script to be run with:

• On File Import
• On File Upgrade
• On Movie File Delete

Script will tag the movie with fel or mel if the file contains a Dolby Vision Enhancement Layer, and whether the EL is minimal or full. If the imported file has no Enhancement Layer, and the movie has one of those two tags, it will be removed.

The script can also be run as:

$ ./tag_dvfelmel.sh bulk

If run like this, it will loop over all movies in radarr and add/remove the tags where needed. Can be used to backfill all the tags for an existing library.

download_trailer.sh

Script to be run with:

• On Movie Add
• On File Import
• On File Upgrade

Script will search TMDB for official trailers for the movie and download them in the best available quality using yt-dlp. Trailers are saved in a Trailers/ subdirectory inside the movie folder.

By default it downloads trailers in the movie's original language and Brazilian Portuguese (pt-BR), with Brazilian Portuguese subtitles for original-language trailers. These preferences can be configured in scripts.conf.

Requires a TMDB API key (set TMDB_API_KEY in scripts.conf). Get one at https://www.themoviedb.org/settings/api

For age-restricted content, YouTube cookie authentication is supported. See cookie extraction guide for setup.

The script can also be run as:

$ ./download_trailer.sh bulk

If run like this, it will loop over all movies in radarr and download trailers where needed. Can be used to backfill trailers for an existing library.