This page is the provider control surface: 22 native providers shipped, plus marketplace plugins, plus transcription as a last-resort fallback. Each row is one provider with health, credentials, priority, and rate-limit state.
Each provider row shows:
| Column | Effect |
|---|
| Name + badge | Provider name; badge for Free / API Key / Login. |
| Status | enabled / disabled / auto-disabled / not configured. |
| Priority | Numeric rank in the search order. Lower = tried first. |
| Health | Recent success rate over the last 200 calls. |
| Last response | Average latency. |
| Downloads | Successful subtitle downloads from this provider, lifetime. |
Click a row to open the editor panel — credentials, priority drag handle, test button, cache controls.
| Provider | Type | Account | Best for |
|---|
| OpenSubtitles | API key | required (free tier) | Largest dataset; reliable backbone of any setup. |
| Jimaku | API key | required (free) | Anime — direct partnership with translator groups. |
| SubDL | API key | required (free) | Curated, fast, strong on anime. |
| AnimeTosho | none | none | Aggregator of anime fansub releases. |
| Provider | Languages | Account |
|---|
| Podnapisi | Slavic + EU | none |
| Kitsunekko | Japanese (ASS) | none |
| Napisy24 | Polish | none |
| Titrari | Romanian | none |
| LegendasDivx | Portuguese (PT) | required |
| Subscene | broad | none |
| Addic7ed | TV series specialist | optional |
| Gestdown | Spanish | none |
| TVSubtitles | TV series multi-lang | none |
| Provider | Languages | Account |
|---|
| Zimuku | Chinese | none |
| Assrt | Chinese (rated) | none |
| Turkcealtyazi | Turkish | required |
| OpenSubtitlesVIP | broad | required (paid) |
| OpenSubtitles.com (REST) | broad | required |
| Provider | Type | Local | Account |
|---|
| Whisper (built-in) | transcription | yes | none |
| WhisperAI (OpenAI) | transcription | no | required |
| Subgen | transcription | yes (separate service) | optional |
Transcription providers run last in the priority chain — they’re computational, not search-based, so use them only when no real subtitle exists. Configure under Settings → Providers → Transcription.
Clicking a provider opens an inline editor with:
| Section | What’s there |
|---|
| Enabled toggle | On / off without losing config. |
| Credentials | API key / username / password where applicable. Multi-key pool for providers that support rotation. |
| Test | Round-trips a known query; reports auth + reachability. |
| Health stats | Success rate, last response time, average response time, consecutive failures, auto-disable status. |
| Cache | Per-provider cached search results count + clear button. |
| Stats | Lifetime downloads. |
Drag rows in the list to reorder. Lower index = tried earlier. The default ordering favors big-dataset providers (OpenSubtitles, Jimaku, SubDL) with niche providers as fall-throughs.
| Setting | Default | Values | Effect |
|---|
| Auto-prioritise providers | on | toggle | Re-rank dynamically based on recent success rate. Manual order still respected as the seed. |
| Provider delay (ms) | 0 | 0–5000 | Sleep between consecutive calls to the same provider. Some throttle aggressively per-IP. |
Sublarr protects upstream providers with a circuit breaker per provider:
| Setting | Default | Values | Effect |
|---|
| Rate limiting enabled | on | toggle | Honor per-provider quotas declared in the provider config. |
| Circuit-breaker threshold | 5 | 1–20 | Consecutive failures before opening the breaker. |
| Circuit-breaker cooldown (min) | 15 | 1–1440 | How long the breaker stays open before retrying. |
| Auto-disable cooldown (min) | 60 | 1–10080 | Hard auto-disable after persistent failures (separate from breaker). |
See Circuit Breaker for the full state-machine reference.
| Setting | Default | Values | Effect |
|---|
| Cache TTL (min) | 5 | 1–1440 | Per-provider search-result cache lifetime. |
| Per-provider cache count | shown in row | n/a | Click row’s cache section → Clear to drop. |
| Clear all caches | header button | n/a | Drops every provider’s cache. |
| Setting | Default | Values | Effect |
|---|
| Max concurrent provider searches | 4 | 1–32 | Global cap on parallel provider calls. |
| Per-provider concurrency | varies | per-provider override | Some providers handle higher parallelism; others throttle. |
| Search timeout (s) | 30 | 5–300 | Global fallback timeout when a provider doesn’t declare its own. |
The Marketplace tab on this page opens the Plugin Marketplace — install community-maintained providers from a curated list or sideload your own ZIPs.
If you’ve added a provider you don’t want shown in the search but you don’t want to delete (preserving config + history), hide it:
| Setting | Effect |
|---|
| Hidden providers | Comma-separated provider names. Hidden providers don’t appear in search dropdowns or in the priority list. |
Useful for providers tied to obsolete accounts that you might re-activate later.
After the initial provider list comes back, Sublarr can apply a re-ranking pass using extra signals (download counts, age, reviewer ratings). Configurable on this page:
| Setting | Default | Values | Effect |
|---|
| Provider reranking | on | toggle | Master switch for the rerank pass. |
| Min downloads for boost | 100 | 0–10000 | Candidates with fewer downloads don’t get the recency boost. |
| Max modifier | +1.0 | 0.0–3.0 | Cap on how much rerank can move a score up. |
| Setting | Default | Values | Effect |
|---|
| Max subtitle size (KB) | 200 | 10–10240 | Reject subtitles above this size. Protects against malicious uploads and bandwidth abuse. |
