Search Providers
Configure Newznab, Torznab, Usenet retention, and provider search priority.
Search providers tell Comicarr where to look for releases. Comicarr supports Newznab (Usenet indexers) and Torznab (torrent indexers via Jackett, Prowlarr, or native Torznab APIs).
Newznab Providers
Newznab is the standard API for Usenet indexers such as NZBgeek, DrunkenSlug, and NZBFinder.
| Setting | Type | Default | Description |
|---|---|---|---|
NEWZNAB | string | — | Primary Newznab provider in the format name, host, apikey, categories, enabled. |
EXTRA_NEWZNABS | string | — | Additional Newznab providers. Comma-separated entries using the same format as NEWZNAB. |
Newznab Entry Format
Each provider is defined as a comma-separated string:
ProviderName, https://indexer.example.com, YOUR_API_KEY, 7030, 1| Position | Value | Description |
|---|---|---|
| 1 | Name | Display name for the provider. |
| 2 | Host | Full URL to the Newznab API endpoint. |
| 3 | API Key | Your API key for the indexer. |
| 4 | Categories | Newznab category IDs (e.g. 7030 for comics). |
| 5 | Enabled | 1 = enabled, 0 = disabled. |
Torznab Providers
Torznab provides a Newznab-compatible API for torrent indexers. Prowlarr and Jackett both expose Torznab endpoints.
| Setting | Type | Default | Description |
|---|---|---|---|
ENABLE_TORZNAB | bool | False | Enable Torznab provider support. |
EXTRA_TORZNABS | string | — | Torznab providers. Comma-separated entries. |
TORZNAB_NAME | string | — | Display name for the primary Torznab provider. |
TORZNAB_HOST | string | — | Torznab API URL. |
TORZNAB_APIKEY | string | — | API key for the Torznab endpoint. |
TORZNAB_CATEGORY | string | — | Category IDs to search (e.g. 8010 for comics in Jackett). |
TORZNAB_VERIFY | bool | True | Verify TLS certificates. |
Usenet Retention
| Setting | Type | Default | Description |
|---|---|---|---|
USENET_RETENTION | int | 3500 | Maximum age in days for Usenet articles. Results older than this are filtered out. Most major providers retain 3500+ days. |
Provider Priority
| Setting | Type | Default | Description |
|---|---|---|---|
PROVIDER_ORDER | string | — | Comma-separated list of provider names in search priority order. Providers listed first are queried first. |
Search Tiers
Comicarr uses a tiered search strategy to reduce unnecessary API calls.
| Setting | Type | Default | Description |
|---|---|---|---|
SEARCH_TIER_CUTOFF | int | 14 | Number of days after release before Comicarr escalates to lower-priority providers. |
Tier 1 -- Recent releases
For issues released within the last SEARCH_TIER_CUTOFF days, Comicarr searches only the highest-priority providers in PROVIDER_ORDER. This keeps API usage low for new releases that are widely available.
Tier 2 -- Older releases
Once an issue is older than SEARCH_TIER_CUTOFF days without a match, Comicarr expands the search to all configured providers. This gives the best chance of finding back issues.
Set SEARCH_TIER_CUTOFF to 0 to always search all providers. This increases API usage but ensures the widest coverage from day one.