This site is still a work in progress. For the current docs, head to dictionarry.dev.
profilarr /docs
Ctrl K

Loading index...

↑↓ navigate ↵ open esc close
Home
Quick Start
Installation
Build
Test
Deploy
Arr Instances Sync Drift Cleanup Renames
Monitoring
FAQ
Community
Contributing
Sponsor
API Reference
Dictionarry
Dev Logs
Wiki

Quick Start

santiagosayshey santiagosayshey
Last updated

Before turning upgrades on, decide what you want them to fix. Have you changed quality profiles, added better indexers, or found files you want to replace? If you aren’t sure why you need upgrades, read Upgrades first, then come back with a goal.

Every upgrade run follows the same steps:

An upgrade run The schedule starts a run. Mode picks a filter, its rules find matching library items, cooldown tags exclude previously searched items, and the selector and count pick which items the Arr searches. Profilarr tags the searched items and waits for the next scheduled run. Wait for thenext run Pick a filter Find matchinglibrary items Exclude previouslysearched items Pick items usingselector Ask the Arrto search Tag thesearched items

Enable and Schedule Upgrades

Open your Arr instance in Profilarr and go to Upgrades. Set Status to Enabled, choose Hourly at 0 minutes, and leave Mode as Round Robin.

Add a Filter

Click + beside the filter search bar and choose Default to add a filter. Keep the default rules and Random method, then set Count to 10 for Radarr or 1 for Sonarr.

For Radarr, the default rules target monitored, released movies. Each run randomly selects up to ten matching movies and asks Radarr to search for upgrades.

Click Save to apply your settings.

Preview Your Filter

Click the eye icon beside your filter to preview the matching library items. Check that these are the movies you want Profilarr to search for upgrades.

That’s It

Profilarr will now select up to ten random monitored, released movies each hour and ask Radarr to search them again.

Upgrades can be as specific as you need them to be. If you just want to upgrade your library over time after changing profiles or adding an indexer, this setup is enough. You don’t need to learn every filter, selector, or field to get started.

Read on for a few example filters you can use or adapt for your library.

Example Filters

After choosing a filter below, click + beside the filter search bar and choose Import. Paste the JSON, preview the filter, and click Save. These examples use the hourly schedule above.

Below Target (Radarr)
After changing profiles, focus on monitored, released movies below their profile's custom format score target. Searches up to ten movies per run, starting with the lowest scores. This checks the score target, not the quality cutoff.
Banned Groups (Radarr)
Replace files from groups you no longer want, especially after adding an indexer with better alternatives. Searches up to ten monitored, released movies matching the Banned Groups custom format, starting with the lowest scores. Change the format name if yours is different.
Favourites (Radarr)
Give the movies you care about their own upgrade filter. Searches up to ten random monitored, released movies tagged favourites. Add that tag in Radarr or change the rule to a tag you already use.
Finished Shows (Sonarr)
Revisit completed shows when better releases or season packs become available. Searches one monitored, ended series per run, starting with the lowest average custom format score. Sonarr searches the whole series.
Help wanted

Have a filter you’d like to share? Open a pull request with your filter and a short description of what it does and when it’s useful.