Versions¶
Versions are quality profiles — they define exactly what cli_debrid should look for when scraping. Each content source is assigned a version, and cli_debrid will only accept results that match the profile's criteria.
You can create as many versions as you need and assign different ones to different content sources.
Default versions¶
cli_debrid ships with a Default version pre-configured for balanced quality (1080p WEB-DL). You can edit this or create new ones.
Creating a version¶
- Go to Settings → Content Sources → Versions tab
- Click Add Version
- Give it a name (e.g.
4K HDR,1080p,Anime 720p) - Configure the settings below
- Save
Resolution settings¶
| Setting | Options | Default | Description |
|---|---|---|---|
| Max Resolution | 2160p, 1080p, 720p, SD |
1080p |
The target resolution |
| Resolution Wanted | ==, <=, >= |
== |
How strictly to match the resolution |
Resolution Wanted explained:
==— Exactly this resolution. A 1080p version will only accept 1080p files.<=— This resolution or lower. A 1080p version will accept 1080p, 720p, or SD.>=— This resolution or higher. A 1080p version will also accept 4K.
HDR¶
| Setting | Default | Description |
|---|---|---|
| Enable HDR | Off | Prefer HDR content (HDR10, HDR10+, Dolby Vision, HLG) |
| HDR Weight | 1.0 |
How much to boost the score for HDR results (higher = stronger preference) |
File size¶
| Setting | Default | Description |
|---|---|---|
| Min Size (GB) | 0.0 |
Reject files smaller than this. Useful to avoid low-quality small encodes. |
| Max Size (GB) | (no limit) | Reject files larger than this. Useful to keep storage under control. |
Bitrate¶
| Setting | Default | Description |
|---|---|---|
| Min Bitrate (Mbps) | 0.01 |
Reject files below this bitrate |
| Max Bitrate (Mbps) | (no limit) | Reject files above this bitrate |
Scoring weights¶
These control how much each factor contributes to the final quality score. Higher value = more important.
| Setting | Default | Description |
|---|---|---|
| Resolution Weight | 1.0 |
How much resolution matching affects the score |
| Similarity Weight | 1.0 |
How much title similarity affects the score |
| Size Weight | 1.0 |
How much file size preference affects the score |
| Bitrate Weight | 1.0 |
How much bitrate preference affects the score |
| Year Match Weight | 3 |
How much the release year matching affects the score (default higher because wrong year = wrong content) |
Title matching¶
| Setting | Default | Description |
|---|---|---|
| Similarity Threshold | 0.85 |
Minimum title match score (0.0–1.0). Below this, the result is rejected. 0.85 = 85% similar. |
| Similarity Threshold (Anime) | 0.80 |
Lower threshold for anime titles, which often have different romanisations. |
Content type filter¶
| Setting | Options | Default | Description |
|---|---|---|---|
| Anime Filter Mode | None, Anime Only, Non-Anime Only |
None |
Restrict this version to only anime or only non-anime content |
| Require Physical Release | Off | — | Only accept results that have had a physical (BluRay) release |
Filter terms¶
Use these to require or exclude specific words in torrent titles.
| Setting | Default | Description |
|---|---|---|
| Filter In | (empty) | Torrent title MUST contain at least one of these terms |
| Filter Out | (empty) | Torrent title must NOT contain any of these terms |
| Preferred Filter In | (empty) | Boost score if title contains these terms (soft preference) |
| Preferred Filter Out | (empty) | Reduce score if title contains these terms |
Examples:
- Filter Out:
CAM, TS, HDCAM— reject all cam rips - Filter In:
REMUX— only accept remux files - Preferred Filter In:
DV, DoVi— prefer Dolby Vision when available - Filter Out:
dubbed, DUBBED— reject dubbed audio releases
Patterns are regular expressions. (?i) makes a pattern case-insensitive, \b matches a word boundary and \. matches a literal dot — e.g. (?i)\bHDTS\b or \.CAM\..
Each filter has a source: Both (default), Debrid or Usenet. A filter only applies to results of that type — for example, filter out generic WEB-DL releases for Debrid only so those come from Usenet, while still allowing them from Usenet.
See the example 1080p version for a full, importable filter list.
Language settings¶
| Setting | Default | Description |
|---|---|---|
| Language Code | en |
Preferred language (ISO 639-1 code, e.g. en, fr, ja) |
| Enable Spanish Episode Parsing | Off | Converts Spanish episode naming (Cap.XXYY) to standard format |
| Use Alternative Titles | Off | Search using translated/alias titles for international content |
| Foreign Language Penalty | 30 |
Score penalty for releases tagged with a different audio language than the Language Code (e.g. GERMAN for an en version), multiplied by Language Weight. Subtitle-only tags (e.g. SWESUB, VOSTFR) and multi-audio releases (MULTi, Dual Audio, DL) aren't penalised, and neither are untagged releases or a tag for the title's own original language (KOREAN on a Korean film). For a title whose original language isn't the Language Code (e.g. a Korean show on an en version), releases tagged DUAL or with the Language Code's language get a small tiebreaker bonus instead: this value × Language Weight, at most 50 (half for a bare MULTi/DL). Set 0 to turn both off. |
Scraper priorities¶
| Setting | Default | Description |
|---|---|---|
| Enable Scraper Priorities | Off | Use different priority scores per scraper for this version |
| Scraper Priorities | (empty) | Per-scraper priority multipliers. Format: scraper name → score. Higher score = higher priority. |
Example use: Give Zilean a higher priority than Jackett for a 4K version, since Zilean is faster and checks the cache directly.
Fallback version¶
| Setting | Default | Description |
|---|---|---|
| Fallback Version | None | If no results are found for this version, try this other version instead |
Example: Set a 4K version's fallback to 1080p — cli_debrid first looks for 4K, and if nothing is found, tries 1080p.
| Setting | Default | Description |
|---|---|---|
| Fallback At Scrape Time | Off | Normally the fallback is only tried after this version has used up its retries and the item is blacklisted (which can take a day or more). With this on, the fallback is tried as soon as a scrape finds nothing; if the fallback finds results, the original item is blacklisted and the fallback item takes over. |
| Fallback After Attempts | 0 |
With Fallback At Scrape Time on: how many failed scrapes before trying the fallback. 0 or 1 = on the first failure. |
Wake count¶
| Setting | Default | Description |
|---|---|---|
| Wake Count | (global setting) | How many times a sleeping item is retried before giving up. Leave empty to use the global default. Set -1 to disable sleeping for this version entirely. |
Global scraping settings¶
Settings that apply to every version (uncached handling, Minimum Scrape Score, upgrading, scraper timeout) used to be at the bottom of this page under Other Scraping Settings. They're now on their own page: Settings → Scraping.
Assigning versions to content sources¶
Each content source has a Versions checkbox list. Check all versions that should apply to that source.
When multiple versions are checked, cli_debrid tries each one in priority order and uses the best match found.
Version actions¶
At the top of the Versions page:
| Button | Description |
|---|---|
| Import | Import a version profile from a .json file |
| Add New Version | Create a blank version from scratch |
| Add Default Version | Add a pre-configured version with recommended default settings |
| Add Separate 1080p/4K Versions | Add two versions at once — one optimised for 1080p and one for 4K HDR |
On each individual version:
| Button | Description |
|---|---|
| Export | Download this version as a .json file to back up or share |
| Rename | Rename the version |
| Duplicate | Create a copy of the version |
| Delete | Permanently delete the version |
Example profiles¶
Here are some real-world configurations from the community to show how the settings work together.
Good starting point. Accepts 1080p and above, prefers quality groups, blocks cam rips and low-quality sources.
| Setting | Value |
|---|---|
| Max Resolution | 1080p |
| Resolution Wanted | >= (1080p or higher) |
| HDR | On |
| Min Size | 0.01 GB |
| Similarity Threshold | 0.8 |
| Filter Out | CAM, HDTS, TS, dubbed, 3D, 720p, 480p, MP4, scene site watermarks |
| Preferred Filter In | REMUX (1000), 2160p (500), FGT/FraMeSToR (quality groups), HDR variants |
| Preferred Filter Out | Upscaled, torrenting site watermarks |
Exact 1080p only — no 4K, no HDR, no x265. High weight on size and bitrate. Falls back to 720p if nothing found.
| Setting | Value |
|---|---|
| Max Resolution | 1080p |
| Resolution Wanted | == (exact) |
| HDR | Off |
| Min Size | 0.2 GB |
| Fallback Version | 720p |
| Similarity Threshold | 0.9 |
| Filter Out | HDR, 3D, YTS, MULTI, x265/HEVC, AV1, dubbed audio groups |
| Preferred Filter In | Premium release groups (FraMeSToR 800, FLUX/FGT 600), streaming sources (AMZN, NF, ATVP) |
| Preferred Filter Out | AV1 (500), x265/HEVC (400+), foreign dub groups |
Strict 4K remux only. Requires REMUX in the title. High size weight to prefer larger, higher quality files. Zilean and Jackett get priority.
| Setting | Value |
|---|---|
| Max Resolution | 2160p |
| Resolution Wanted | == (exact) |
| HDR | On |
| Min Size | 0.1 GB |
| Filter In | REMUX (required) |
| Preferred Filter In | REMUX (1000), 2160p (500), FGT/FraMeSToR quality groups |
| Scraper Priority | Zilean (1000), Jackett (1000) — prioritise cache and direct indexer |
Targets 2160p and above with strong HDR preference. High resolution weight, prefers REMUX and premium encode groups. Blocks SDR, dubbed, WEBRip, and upscales.
| Setting | Value |
|---|---|
| Max Resolution | 1080p |
| Resolution Wanted | >= (1080p or higher) |
| HDR | On |
| Resolution Weight | 100 (dominant factor) |
| HDR Weight | 20 |
| Wake Count | 48 (retries many times before giving up) |
| Filter Out | CAM, Telesync, 3D, upscaled variants |
| Preferred Filter In | REMUX (200), HDR10+/DV variants (50), TRUEHD/ATMOS (30), IMAX (30) |
| Preferred Filter Out | SDR (10), dubbed (30), WEBRip (50) |
Tips from the community¶
- Boost resolution weight (e.g.
100) if you want resolution to dominate all other scoring factors - High size weight (e.g.
10–15) helps pick larger, higher-bitrate files over compressed encodes - Filter In: REMUX is the most reliable way to guarantee a remux-only version — don't rely on preferred filters alone
- Preferred Filter In with high scores (500–1000) for trusted release groups acts as a soft allowlist without blocking everything else
- Fallback versions are essential for strict profiles — a
4K Remuxversion with no fallback will leave items sleeping if no remux exists - Wake Count
0uses the global default; set-1to disable sleeping entirely for a version; set higher (e.g.48) for rare content that needs more retries
Community versions¶
The cli_debrid Discord has a dedicated channel where users share and download version profiles. You can export your version and drop it in the channel, or grab one optimised for a specific use case (4K HDR, remux only, anime, small sizes, etc.).


