Rangarr

v0.9.0 Breaking

This release includes 1 breaking change for platform teams planning a safe upgrade.

Published 10d Media Servers

View tool

✓ No known CVEs patched

Read the diff → Tool health → What is this tool? →

✓ No known CVEs patched in this version

Affected surfaces

breaking_upgrade

ReleasePort's take

Light signal

editorial:auto 10d

`type: whisparr` now defaults to Whisparr v3; existing v2 users must change their configuration to `type: whisparr_v2`.

Why it matters: If you run Whisparr v2 instances, update the config before upgrading to v0.9.0 or the service will treat them as v3 and fail validation.

Summary

AI summary

Breaking change: type: whisparr now maps to Whisparr v3, requiring existing Whisparr v2 users to update config to type: whisparr_v2.

Changes in this release

Type	Severity	Summary	CVE
Breaking	Medium	`type: whisparr` now maps to Whisparr v3; existing v2 users must update config to `type: whisparr_v2`. `type: whisparr` now maps to Whisparr v3; existing v2 users must update config to `type: whisparr_v2`. Source: llm_adapter@2026-05-24 Confidence: high	—
Feature
Feature	Medium	Adds Readarr support for managing book libraries. Adds Readarr support for managing book libraries. Source: llm_adapter@2026-05-24 Confidence: low	—
Feature	Medium	Adds explicit `type: whisparr_v2` for Sonarr-based Whisparr client. Adds explicit `type: whisparr_v2` for Sonarr-based Whisparr client. Source: llm_adapter@2026-05-24 Confidence: low	—
Feature	Medium	Adds `type: whisparr_v3` support with Radarr‑style API, custom format score awareness, tag filtering. Adds `type: whisparr_v3` support with Radarr‑style API, custom format score awareness, tag filtering. Source: llm_adapter@2026-05-24 Confidence: low	—
Bugfix	Medium	Unsupported instance types now log an error and skip the instance instead of aborting startup. Unsupported instance types now log an error and skip the instance instead of aborting startup. Source: llm_adapter@2026-05-24 Confidence: high	—

Full changelog

Added

Readarr support. Add instances of type readarr to manage book libraries alongside existing Radarr, Sonarr, and Lidarr instances.
Whisparr v3 support via type: whisparr_v3. Whisparr v3 is the current scene/movie-based version and uses a Radarr-style API — custom format score awareness, tag filtering, and all other settings apply identically to Radarr instances. Log output uses Studio - Scene Title format. type: whisparr is also accepted as an alias for whisparr_v3.
type: whisparr_v2 — explicit type value for the Sonarr-based Whisparr client. Existing Whisparr v2 users must migrate from type: whisparr to type: whisparr_v2; see the breaking change below.

Changed

Unsupported instance types (e.g. an unrecognized type: value) now log an error and skip the instance rather than aborting startup.
Breaking: type: whisparr now maps to Whisparr v3 (the current, scene/movie-based version). Existing Whisparr v2 users must update their config to type: whisparr_v2 to continue using the Sonarr-based client. type: whisparr_v2 is new in this release.

Breaking Changes

`type: whisparr` now maps to Whisparr v3 (scene/movie-based) instead of v2; existing Whisparr v2 users must change config to `type: whisparr_v2`.

View diff on GitHub

Weekly OSS security release digest.

The CVE patches and breaking changes that affected production tools this week. One email, every Sunday.

No spam, unsubscribe anytime.

Share this release

Share on X Share on Bluesky

Track Rangarr

Get notified when new releases ship.

About Rangarr

Automate media searches across the *arr stack

All releases →