Recyclarr

Recyclarr is a command-line tool that automatically syncs recommended quality profiles, custom formats, and other settings from the TRaSH Guides to your…

  • Automation
  • Media Applications
  • Media Servers
  • Other
  • Tools & Utilities
Recyclarr is a command-line tool that automatically syncs recommended quality profiles, custom formats, and other settings from the TRaSH Guides to your Sonarr and Radarr instances, keeping media libraries aligned with the community's best-practice recommendations.

Platform availability

Available on 4 of 10 platforms

Health score?A 0-100 score computed nightly from four factors: maintained (40%: recent commits and steady activity), popular (25%: GitHub stars, log scale), easy to install (20%: platforms, install notes, setup guides, Docker image) and light to run (15%: minimum RAM, ARM support). When the source code has been checked, a fifth factor, security check (20%: automated scan for committed secrets, unsafe desktop-app settings, known-vulnerable dependencies and project hygiene; any serious finding caps it at 20), is added. Factors without data are left out and the rest are rescaled.

85/100 Excellent

Maintained
100last commit 24 days ago
Popular
672,147 GitHub stars
Easy to install
654 install platforms, install notes, Docker image
Light to run
No data
Security check
95no serious findings, CI, tests

Based on 4 of 5 factors.

Availability: platform listings confirmed today, links checked 10 days ago

GitHub stars
2,147
Open issues
17
Last commit
2026-10-28
Latest release
v8.8.1
License
MIT
Activity
rising

Checked 23 days ago - source: GitHub (recyclarr/recyclarr)

Resources & Compatibility

ARM (e.g. Raspberry Pi) is supported.

Checked 54 days ago - source: Docker Hub image tags and published docs

First-install notes

  • Connect Recyclarr to each *arr app For every Sonarr or Radarr instance, set base_url (the address Recyclarr can reach, including the port) and api_key. If the address, port, or key is wrong, Recyclarr cannot connect, so profiles and custom formats won't be updated. source
  • Tell Recyclarr which profiles to manage In each Sonarr or Radarr section, list quality_profiles using the exact profile names that already exist in that app, and include trash_id (the Trash Guide profile identifier, like trash-4k) for the guide profile you use. If the names or trash_id do not match, Recyclarr will not update the right profile, so downloads may not be ranked the way you want. source
  • Choose whether old custom formats are deleted Set delete_old_custom_formats for each app to true only if you want Recyclarr to remove custom formats (rules that score how desirable a download is) it no longer manages; otherwise leave it false. If it is true, Recyclarr can delete rules you made yourself, which may leave your quality profiles with missing or lower scores. source
  • Rootless Docker deployment Since v2.3.0 the image is rootless: pass the user via the Extra Parameter '--user="99:100"' and remove the PUID and PGID environment variables. Since v8.4.0 the ':latest' tag is no longer supported; pin a specific version tag. source

Fetched 45 days ago - each note links to its source

Alternatives

No alternatives collected yet.

Common questions

What Docker tag and user settings should I use for Recyclarr?

Use a specific or major version tag instead of :latest, which is not supported. The image is rootless since v2.3.0, so pass the Nobody user with --user="99:100". Remove PUID and PGID from the container environment.

What must I set so Recyclarr can connect to Sonarr or Radarr and update the right profiles?

For each instance, set base_url including the port and api_key, then list quality_profiles with exact existing profile names and trash_id. If the connection, profile names, or trash_id do not match, Recyclarr will not update the intended profile.

Will delete_old_custom_formats remove custom formats I made manually?

Yes, if set to true it can remove custom formats Recyclarr no longer manages, including rules you made yourself. Leave it false unless you want Recyclarr to delete old custom formats.

Should I back up Radarr before running Recyclarr?

One user recommends backing up the Radarr instance before running Recyclarr. This lets you see whether its changes are useful.

Can Recyclarr break after Radarr/Sonarr or TRaSH guide updates?

Yes, it may stop working at any time due to guide updates or changes in Radarr or Sonarr.

Answers sourced from github.com, github.com, recyclarr.dev, www.reddit.com

Community

Collected 54 days ago - public community threads