-
Notifications
You must be signed in to change notification settings - Fork 0
Exclusions
The Exclusions list lets you permanently prevent specific titles from being searched by Nudgarr. Excluded titles are silently skipped in every future sweep — both Cutoff Unmet and Backlog searches.
Exclusions are matched by title (case-insensitive, exact string match). When a sweep runs, Nudgarr removes any item whose title appears on the exclusions list before the cooldown check, queue check, or search selection. Excluded items are never counted against the run's maximum — they are removed from consideration entirely.
Exclusions are global — they apply across all instances and both Radarr and Sonarr.
The most common way to add an exclusion is directly from History:
- Open the History tab
- Find the title you want to exclude
- Click the ⊘ icon in that row
- The title is immediately added to the exclusions list
On mobile, Exclusions are managed from within the History tab:
- Tap History in the bottom nav
- Tap the Exclusions inner tab
- Tap Add from History to see recently searched titles
- Tap the + button next to any title to exclude it
Open the History tab, click the Exclusions pill to activate the exclusions filter, and click Remove on any row. The title is immediately eligible for future searches.
In the Exclusions inner tab within History, all active exclusions are listed. Each has a Remove button. The row fades and collapses before the removal is confirmed.
Exclusions are useful for titles you have a deliberate reason not to improve or acquire:
- Content you own physically and don't want a digital copy of
- Items with no reliable indexer releases — repeatedly searching wastes slots
- Content you've decided isn't worth the quality upgrade at this time
- Items that repeatedly trigger false positives in your indexer results
Exclusions are not the right tool for temporarily pausing a title — that's what the cooldown handles naturally. If you just searched something and don't want it re-searched soon, the cooldown already prevents that without an explicit exclusion.
Nudgarr excludes by title only. For Sonarr, this means excluding a show title will skip all episode searches for that show — but it won't remove it from your Sonarr library or un-monitor it.
If you want to stop Nudgarr from ever touching a show again and stop Sonarr from looking for it in RSS, the right approach is to un-monitor the show (or specific seasons/episodes) in Sonarr directly. Nudgarr only searches monitored content.
Exclusions are stored in the SQLite database at /config/nudgarr.db. They are persisted across restarts and container upgrades.
Auto-exclusion lets Nudgarr exclude titles automatically after a configured number of searches with no confirmed import. This prevents Nudgarr from searching endlessly for content that consistently produces no result.
After each import check cycle, Nudgarr evaluates all titles that meet the following four conditions:
- Search count is at or above the configured threshold for that app
- No confirmed import on record
- Not currently in the download queue
- Not already excluded
If all four conditions are met, the title is written to the exclusions table with source=auto and a notification fires if Auto-Exclusion notifications are enabled.
The queue check (condition 3) protects against excluding items that were just grabbed and are still downloading — if a title is in the queue it is not yet confirmed imported but it is actively being fetched, so it is skipped.
Timing note: Auto-exclusion runs inside the import check loop, not during the sweep. A title will not be evaluated until the import check interval elapses after the sweep that pushed it over the threshold. If your import check interval is longer than your cron schedule, a title could accumulate multiple searches before the check fires. See FAQ & Troubleshooting for details.
Auto-exclusion is configured independently for Radarr (movies) and Sonarr (shows).
Desktop: Open Advanced → page 2. Four fields are available:
| Field | Description |
|---|---|
| Exclude After X Searches (Radarr) | Auto-exclude a movie after this many searches with no confirmed import. 0 disables auto-exclusion for movies. |
| Unexclude After X Days (Radarr) | Automatically remove a movie from auto-exclusions after this many days, making it eligible again. 0 means it stays excluded until manually removed. |
| Exclude After X Searches (Sonarr) | Same as above for shows. |
| Unexclude After X Days (Sonarr) | Same as above for shows. |
Setting a threshold to 0 greys out the corresponding Unexclude Days field — it has no effect when auto-exclusion is disabled for that app.
Mobile (portrait): Open the Settings tab. The Radarr and Sonarr cards each have two new steppers — Auto-Exclude and Unexclude Days — sitting alongside Cutoff Max and Sample Mode. The Unexclude Days stepper greys out automatically when Auto-Exclude is 0.
If Unexclude Days is set above 0, Nudgarr runs an auto-unexclude pass at the start of each sweep. Any auto-excluded title older than the configured threshold is removed from the exclusions table and its search count is reset to 0, making it eligible for searching again immediately in that sweep.
Auto-unexclude only affects entries with source=auto. Manual exclusions are never touched.
The Exclusions tab shows a Source column when the exclusions filter is active. Auto-excluded entries show an amber Auto badge. Manual exclusions show a muted Manual badge.
On mobile, auto-excluded titles in the Excluded inner tab render in amber to distinguish them from manually excluded titles at a glance.
The desktop status bar gains a leftmost segment showing the count of unacknowledged auto-exclusions. Clicking it navigates to the History tab with the exclusions filter active and clears the badge.
The History nav item shows a red count badge when unacknowledged auto-exclusions exist. Tapping History navigates to the History tab, activates the Excluded inner tab, and clears the badge.
If you save with a threshold changing from a non-zero value to 0 and auto-exclusions currently exist, a popup appears asking what to do with the existing entries. Cancel leaves them in place — re-enable by setting the threshold above 0. Clear removes all auto-exclusion rows immediately.
A Reset Auto-Exclusions button in the Advanced tab Danger Zone removes all auto-excluded entries in one action. Manual exclusions are not affected. A confirmation dialog appears before the action runs.
A separate Auto-Exclusion notification trigger is available in the Notifications tab, between Import Confirmed and Error. When enabled, a notification fires each time a title is auto-excluded, including the title, search count, and instance name.