Glossary

Key terms used in the Nudgarr UI and documentation.

---

Acquired An import type indicating a first-time grab — the item did not exist in the library before and was successfully downloaded. Appears as a green badge in the Imports tab. Triggered by the Backlog pipeline.

Apprise A Python library that provides a unified interface to over 80 push notification services. Nudgarr uses Apprise to deliver notifications via a single URL configuration. See Notifications.

Auto-Exclusion A title that Nudgarr has automatically added to the exclusions list after its search count reached the configured threshold with no confirmed import. Auto-excluded entries are stored with source=auto and display an amber badge in the Exclusions view. Configure thresholds per app in the Advanced tab.

Auto-Unexclude The automatic removal of auto-excluded titles after a configured number of days. Runs at the start of each sweep. When a title is auto-unexcluded its search count resets to 0. Only affects entries with source=auto — manual exclusions are never touched.

Backlog One of the three Nudgarr pipelines. Searches for monitored items that have never been successfully grabbed. Off by default. Appears as Backlog in the History tab and Acquired in the Imports tab. See Radarr & Sonarr Backlog.

Batch Size The number of items included in a single search API call to Radarr or Sonarr. Larger batches reduce the number of API calls per sweep but may be more likely to trigger indexer rate limits.

CF Score One of the three Nudgarr pipelines. Finds monitored files where the custom format score is below the quality profile cutoff and tells the Arr to search for a better-scored release. Off by default. Requires cutoffFormatScore to be set in quality profiles (Sonarr especially). Appears as CF Score in the History and Imports tabs. See CF Score.

Cooldown The minimum number of hours Nudgarr waits before searching the same item again. Applies to all three pipelines. Default is 48 hours. 0 disables cooldown entirely.

Cutoff Unmet One of the three Nudgarr pipelines. Finds items that have a file but have not reached the quality profile cutoff and tells the Arr to search for a better version. On by default. Appears as Cutoff in the History tab and Upgraded in the Imports tab.

Eligible An item that has passed all filters (not excluded, not filtered by tag/profile, not queued, not on cooldown) and is available to be picked for searching in a given sweep.

Exclusion A title that has been explicitly removed from all future Nudgarr searches. Exclusions are matched by title (case-insensitive) and apply globally across all instances and both Radarr and Sonarr.

Import A confirmed successful download and import of a previously searched item. Tracked via the import check loop. Appears in the Imports tab.

Import Check Interval How often (in minutes) the import check loop runs independently of the sweep schedule. Default is 120 minutes.

Intel Tab A read-only lifetime performance dashboard. Shows Import Summary (turnaround, searches per import, pipeline breakdown), Instance Performance, Upgrade History, CF Score Health, and Exclusion Intel. All numbers are hard facts derived directly from the database. See Intel.

Intel Aggregate A protected single-row database table that accumulates lifetime Intel metrics. Never cleared by Clear History, Clear Imports, or retention pruning. Only Reset Intel resets it.

Instance A single Radarr or Sonarr installation configured in Nudgarr. Multiple instances of the same app are supported. Each instance is processed independently.

Instance Health A per-instance indicator showing whether Nudgarr was able to successfully communicate with that instance during the last sweep.

Jitter A random additional delay added on top of the sleep between batches. Prevents predictable API timing patterns.

Maintenance Window A configurable time window during which scheduled sweeps are suppressed. Manual Run Now is never affected.

Max per Run The maximum number of items Nudgarr will search in a single sweep per instance. Separate caps exist for Cutoff Unmet (Max Movies/Episodes per Run), Backlog (Missing Max), and CF Score (CF Score Max per Run).

Missing Added Days A Backlog filter for Radarr only. Only movies added to the library at least this many days ago are eligible for backlog searches. 0 disables the filter. Does not apply to Sonarr.

On Cooldown Items skipped during a sweep because they were searched too recently (within the cooldown window).

Pipelines The three independent search modes Nudgarr runs each sweep: Cutoff Unmet, Backlog, and CF Score. Each pipeline has its own toggle, cap, sample mode, and history entries. They run in sequence during the same sweep but do not affect each other.

Queued Items already present in the Radarr or Sonarr download queue at the time of a sweep. Queued items are silently skipped and do not consume a search slot.

Run Now A button that triggers an immediate sweep regardless of the cron schedule.

Sample Mode The ordering strategy used to pick items for searching. Options are: Random, Alphabetical, Oldest Added, Newest Added, Round Robin. CF Score additionally offers Largest Gap First. Set independently for each pipeline and each app.

Sleep A fixed wait (in seconds) between batches during a sweep. Combined with Jitter to pace API calls.

State Retention The number of days Nudgarr keeps history and cooldown records. Default is 180 days. 0 disables pruning.

Sweep One full pass of Nudgarr across all enabled instances, running all enabled pipelines. Sweeps run on the cron schedule or on demand via Run Now.

Turnaround The time between the first search Nudgarr triggered for an item and the confirmed import. Displayed in human-readable units (30m, 3h, 1d 12h, 8d etc) in the Imports tab and Intel tab.

Upgraded An import type indicating a quality replacement — the item already existed in the library and a better version was found and imported. Appears as a blue badge in the Imports tab. Triggered by both the Cutoff Unmet and CF Score pipelines.