Indexers

Torznab and Newznab sources that Luminarr searches for movie releases. Add as many as you need — Luminarr queries them in parallel and ranks the results by quality score.

Protocols

Supported Protocols

Torznab Torrents

The standard API for torrent indexers. Supported by Jackett, Prowlarr, and most private tracker frontends. Returns .torrent file links with extended attributes like seeders and leechers.

Newznab Usenet

The standard API for Usenet indexers. Supported by NZBgeek, DrunkenSlug, and most NZB index sites. Returns .nzb file links. Requires a Usenet provider in addition to a Newznab indexer.

Prowlarr as a proxy. If you already run Prowlarr, you can add all your trackers and indexers there and then add a single Torznab or Newznab endpoint per indexer from Prowlarr into Luminarr. This avoids duplicating API keys across applications.

Configuration

Configuration Fields

Field Description
Name Display name for this indexer. Used in logs, activity history, and the manual search results table.
URL Base URL of the indexer API. For Torznab this is typically the tracker's API endpoint (e.g. https://tracker.example.com/api). For Prowlarr, use the per-indexer Torznab URL shown in Prowlarr's settings.
API Key Authentication key for the indexer. Sent as a query parameter on every request. Stored encrypted at rest.
Enabled Toggle the indexer on or off without deleting it. Disabled indexers are skipped during RSS sync and manual searches.
Priority Numeric priority (lower = higher priority). When two releases are otherwise equal, the release from the higher-priority indexer is preferred. Default is 25.
Rate Limit Maximum requests per minute sent to this indexer. Set this to respect your tracker's API limits and avoid bans. 0 means unlimited.
Seed Ratio Torznab only. Minimum ratio to seed before a torrent is eligible for removal. Luminarr enforces this via the download client after the file is imported.
Seed Time Torznab only. Minimum seeding duration in minutes before removal eligibility. Applied alongside (not instead of) Seed Ratio — both conditions must be met.
Tags Restrict this indexer to movies with matching tags. Leave empty to search for all movies. See Tags for details.
Search Flow

How Searching Works

Both RSS sync (automatic, every 15 minutes) and manual searches follow the same query pipeline. Luminarr queries all applicable indexers in parallel and processes results together.

  1. 1

    Identify applicable indexers.

    Filter to enabled indexers only. Apply tag matching — if the movie has tags, only use indexers that share at least one tag (plus all untagged indexers).

  2. 2

    Search by TMDB ID first.

    Luminarr sends a t=movie&tmdbid=XXXXX query. This is the most accurate search method — the indexer returns only releases for that specific movie. All Torznab/Newznab-compliant indexers support this.

  3. 3

    Fall back to title + year if needed.

    If the TMDB ID query returns no results, Luminarr retries with a title+year text search: t=movie&q=Movie+Title&year=2008. Results from text searches are slightly less reliable — more filtering may be required.

  4. 4

    Query all indexers in parallel.

    Requests to all applicable indexers fire concurrently. Results from all indexers are aggregated into a single pool. The rate limit per indexer is respected independently.

  5. 5

    Parse quality from release title.

    Each result's title is parsed to extract resolution, source, codec, HDR flags, audio codec, release group, and other attributes. Parsing uses pattern matching — no external database required.

  6. 6

    Filter by quality profile and size definitions.

    Releases whose parsed quality is not in the movie's profile Qualities list are discarded. Releases outside the Min/Max size per minute for their quality tier are discarded.

  7. 7

    Calculate custom format score.

    Remaining releases are scored against all matching custom formats. Releases below the profile's Min CF Score threshold are discarded.

  8. 8

    Sort and select.

    Releases are sorted by quality score (descending), then custom format score (descending), then indexer priority (ascending). The top result is sent to the download client. During manual search, the full ranked list is displayed for your review.

RSS sync vs. interactive search. RSS sync queries the indexer's new-releases feed, not a per-movie query. Luminarr matches feed items against all monitored movies in the database — a single RSS poll covers your entire library. Interactive search (triggered manually or via Wanted) always does a direct per-movie query for the freshest results.

Troubleshooting

Testing and Troubleshooting

After adding an indexer, use the Test button in the indexer settings to verify connectivity and authentication. A successful test means Luminarr can reach the URL and the API key is accepted. It does not guarantee that searches will return results.

Common issues

Symptom Likely cause
Test fails with connection error Wrong URL, or Luminarr cannot reach the host. Check the URL and any proxy settings in App Settings.
Test fails with 401 / 403 API key is incorrect or has been revoked. Regenerate it on the indexer site.
Searches return 0 results The indexer may not carry movie content in the categories Luminarr requests. Check the indexer's supported categories in Prowlarr or the tracker's documentation.
Releases found but never grabbed Quality or size definitions are filtering out all results. Run a manual search to see the raw result list and inspect the rejection reasons.
Indexer returns stale results Rate limiting may be preventing full RSS polls. Increase the rate limit or reduce the number of monitored movies triggering searches simultaneously.