Recyclarr is a command-line application that synchronises the recommended settings from the TRaSH Guides into your Sonarr and Radarr instances. Instead of clicking through quality profiles, custom formats and naming schemes by hand and re-doing the work after every guide update, you describe your instances once in a YAML config and Recyclarr pushes the guide’s current recommendations to them. It runs as a single binary or a Docker container, keeps its own state between runs, and supports any number of Sonarr and Radarr instances from one configuration. The latest release is v8.8.1.

Key Features

• Quality profiles — Creates and updates TRaSH quality profiles, including qualities and quality groups, in the order the guide specifies.
• Custom formats — Syncs individual custom formats or whole groups of them, with scores taken from the guide or set manually.
• Quality definitions — Applies the guide’s file-size limits, so upgrades are triggered on real quality gains rather than larger files.
• Media naming formats — Pushes standard and folder naming schemes to each instance.
• Media management settings — Keeps propers and repacks handling in line with the guide.
• Multi-instance support — One config file drives several Sonarr and Radarr servers, each with its own profile list and API key.
• Starter templates — config create --template generates a working config from 22 Sonarr and 35 Radarr templates, so a first sync does not need a blank file.
• Preview and state handling — A preview mode shows what a sync would change, and the state system lets you repair or reset tracked custom formats without starting over.
• Container and bare-metal — Ships as a Docker image (major-version tags such as 8) plus a self-contained binary for Linux, Windows and macOS.

Why Use Recyclarr?

The TRaSH Guides are the de-facto reference for getting good results out of Sonarr and Radarr, but the recommendations live in documentation, not in the apps. Applying them by hand is slow, easy to get subtly wrong, and impossible to keep current as the guides evolve. Recyclarr makes the guide the source of truth: your configuration records which profiles and custom formats you want, and each run reconciles the instances against it. That means consistent scoring across a whole library, no missed settings after a rebuild, and one command to bring a new instance up to the same standard as the rest.

Use Cases

• Applying TRaSH quality profiles and custom-format scores to an existing Sonarr/Radarr setup.
• Keeping several instances (1080p and 4K, or separate servers) on identical scoring rules.
• Rebuilding a stack from scratch: point Recyclarr at the new containers and let it re-apply every setting.
• Scheduled runs in cron or a container scheduler so guide updates reach the apps without manual work.
• Previewing a guide change with a dry run before it lands on a working library.

source at github.com/recyclarr/recyclarr