Ranking Presets: Default and Custom Configurations

Presets are named bundles of ranking model values and settings that give you a sensible starting point without manually specifying every field. Riven ships with one built-in preset — default — and supports fully custom ranking models for users who want complete control over how torrents are scored.

Available Presets

default

The built-in balanced preset. Prioritises lossless remuxes and high-quality web sources, strongly prefers Dolby Vision and HDR10+, and rewards lossless audio (TrueHD / DTS-HD MA). Heavily penalises rips and HDTV sources.

custom

No built-in values — you provide every field in the rankingModel object. Any field you omit defaults to null, which rejects torrents with that attribute. Full control with full responsibility.

The Default Preset

The default preset is designed for a 4K-first, quality-focused library. Its opinionated hierarchy is:

Source: Remux (10,000) ≫ Web-DL (200) > Web / Blu-ray (100) ≫ HDTV (−5,000) ≫ rips (−10,000)
HDR: Dolby Vision (3,000) > HDR10+ (2,100) > HDR (2,000) > 10-bit (100) > SDR (0)
Audio: TrueHD / DTS-Lossless (2,000) > Atmos (1,000) > DDP (150) > AAC / DTS Lossy (100) > DD (50) > FLAC / Stereo (0)
Codec: HEVC / AVC / AV1 are all equal (500); lower-quality codecs are left at null
Resolution: Only r2160p: true is set in the default preset’s settings block; schema defaults (r1080p: true, r720p: true, unknown: true) remain active, so 4K, 1080p, 720p, and unknown-resolution torrents are all allowed

Using the Default Preset

Set rankingModel to the string "default" in your config file. You can still layer settings overrides on top — they are merged after the preset is loaded:

{
  "$schema": "https://raw.githubusercontent.com/rivenmedia/riven-ts/main/apps/riven/ranking-config.schema.json",
  "rankingModel": "default"
}

To also enable 1080p alongside 4K while keeping all default scores:

{
  "$schema": "https://raw.githubusercontent.com/rivenmedia/riven-ts/main/apps/riven/ranking-config.schema.json",
  "rankingModel": "default",
  "settings": {
    "resolutions": {
      "r2160p": true,
      "r1080p": true
    }
  }
}

When rankingModel is "default", the preset’s settings and your settings block are shallow-merged (top-level keys only). This means if you specify resolutions, your entire resolutions object replaces the preset’s — so always include every resolution key you want enabled, including r2160p, when providing a resolutions override.

Default Preset Full Values

The table below shows every value set by the default preset. Fields not listed are null in the schema defaults (not set by the preset), meaning torrents with those attributes are rejected unless you add them via a settings override or a custom model.

Field	Value	Notes
`remux`	`10000`	Blu-ray / UHD remux — highest quality source
`webdl`	`200`	Web-DL from streaming services
`web`	`100`	Generic web source
`bluray`	`100`	Standard Blu-ray encode
`hdtv`	`−5000`	HDTV broadcast — penalised
`brrip`	`−10000`	Blu-ray rip — heavily penalised
`hdrip`	`−10000`	HD rip — heavily penalised
`webrip`	`−1000`	Web rip — moderately penalised

All other quality/rip fields (dvd, vhs, bdrip, dvdrip, etc.) are null — those torrents are rejected.

Field	Value	Notes
`hevc`	`500`	H.265 / x265
`avc`	`500`	H.264 / x264
`av1`	`500`	AV1

xvid and mpeg are null — those torrents are rejected.

Field	Value	Notes
`dolbyVision`	`3000`	Dolby Vision (DV tag)
`hdr10plus`	`2100`	HDR10+
`hdr`	`2000`	Standard HDR10
`bit10`	`100`	10-bit depth flag
`sdr`	`0`	Explicitly tagged SDR (allowed, no bonus)

Field	Value	Notes
`truehd`	`2000`	Dolby TrueHD lossless
`dtsLossless`	`2000`	DTS-HD MA / DTS:X lossless
`atmos`	`1000`	Dolby Atmos object audio
`dolbyDigitalPlus`	`150`	DD+ / E-AC-3 / EAC3
`aac`	`100`	AAC
`dtsLossy`	`100`	Standard DTS lossy
`dolbyDigital`	`50`	DD / AC-3
`flac`	`0`	FLAC (allowed, no bonus)
`stereo`	`0`	Stereo / 2.0 (allowed, no bonus)
`surround`	`0`	Surround 5.1/7.1 (allowed, no bonus)

mono and mp3 are null — those torrents are rejected.

Field	Value	Notes
`edition`	`100`	Special edition tag
`proper`	`20`	Proper re-release
`repack`	`20`	Repack re-release
`dubbed`	`−1000`	Dubbed audio — penalised
`hardcoded`	`0`	Hardcoded subs (allowed, no penalty)
`network`	`0`	Network tag (allowed, no penalty)
`retail`	`0`	Retail flag (allowed, no penalty)
`subbed`	`0`	External subs (allowed, no penalty)
`scene`	`0`	Scene flag (allowed, no penalty)
`uncensored`	`0`	Uncensored flag (allowed, no penalty)

Setting	Effective Value	Source
`resolutions.r2160p`	`true`	Set by default preset
`resolutions.r1080p`	`true`	Schema default
`resolutions.r720p`	`true`	Schema default
`resolutions.r480p`	`false`	Schema default
`resolutions.r360p`	`false`	Schema default
`resolutions.unknown`	`true`	Schema default

The default preset’s settings block only sets r2160p: true. Because the preset’s settings are spread-merged with schema defaults (not used as a full replacement), all other resolution keys keep their schema defaults. The net effect when using "rankingModel": "default" with no overrides is that 4K (r2160p), 1080p (r1080p), 720p (r720p), and unknown-resolution torrents are all enabled.All other settings (options, languages, pattern arrays) use schema defaults.

Custom Preset

When you need scoring logic that deviates significantly from the default, set rankingModel to an object. The preset is bypassed entirely — every field you omit will be null.

A null ranking model field does not mean “ignore this attribute” — it means “reject any torrent that has this attribute.” For example, if you omit avc, torrents with H.264 video will not be fetched. Always explicitly set every attribute you want to allow, even if the score is 0.

Partial Override Pattern

If you only want to change a handful of scores while keeping the rest of the default preset’s logic, use the string "default" for rankingModel and do not put your overrides in settings. Instead, file a bug — there is no partial-override merge for rankingModel; preset vs. custom is a binary choice. For targeted score adjustments, the recommended approach is to copy the default preset values and modify only the fields you care about:

{
  "$schema": "https://raw.githubusercontent.com/rivenmedia/riven-ts/main/apps/riven/ranking-config.schema.json",
  "settings": {
    "resolutions": {
      "r2160p": true,
      "r1080p": true,
      "r720p": true,
      "unknown": true
    }
  },
  "rankingModel": {
    "remux": 10000,
    "webdl": 200,
    "web": 100,
    "bluray": 100,
    "hdtv": -5000,
    "brrip": -10000,
    "hdrip": -10000,
    "webrip": -1000,
    "hevc": 500,
    "avc": 500,
    "av1": 500,
    "dolbyVision": 3000,
    "hdr10plus": 2100,
    "hdr": 2000,
    "bit10": 100,
    "sdr": 0,
    "truehd": 2000,
    "dtsLossless": 2000,
    "atmos": 1000,
    "dolbyDigitalPlus": 150,
    "aac": 100,
    "dtsLossy": 100,
    "dolbyDigital": 50,
    "flac": 0,
    "stereo": 0,
    "surround": 0,
    "proper": 20,
    "repack": 20,
    "edition": 100,
    "dubbed": -1000,
    "hardcoded": 0,
    "network": 0,
    "retail": 0,
    "subbed": 0,
    "scene": 0,
    "uncensored": 0
  }
}

Anime-Optimised Example

This example adjusts the config for an anime library: enables 1080p, allows subbed releases without penalty, penalises dubbed releases less heavily, and removes the strict rip penalties:

{
  "$schema": "https://raw.githubusercontent.com/rivenmedia/riven-ts/main/apps/riven/ranking-config.schema.json",
  "settings": {
    "resolutions": {
      "r2160p": false,
      "r1080p": true,
      "r720p": true,
      "unknown": true
    },
    "options": {
      "titleSimilarity": 0.8
    }
  },
  "rankingModel": {
    "remux": 5000,
    "webdl": 300,
    "web": 200,
    "bluray": 200,
    "hdtv": -2000,
    "webrip": 0,
    "brrip": -2000,
    "hdrip": -1000,
    "hevc": 500,
    "avc": 400,
    "av1": 500,
    "hdr": 1000,
    "hdr10plus": 1200,
    "dolbyVision": 1500,
    "bit10": 100,
    "sdr": 0,
    "truehd": 500,
    "dtsLossless": 500,
    "atmos": 300,
    "dolbyDigitalPlus": 150,
    "aac": 100,
    "dtsLossy": 100,
    "dolbyDigital": 50,
    "flac": 200,
    "stereo": 0,
    "surround": 0,
    "proper": 20,
    "repack": 20,
    "edition": 50,
    "dubbed": -200,
    "subbed": 100,
    "scene": 0,
    "hardcoded": 0
  }
}

Use settings.preferred with regex patterns to give a score bonus to specific release groups or encoding teams you trust. Any torrent matching a preferred pattern receives a flat +10,000 bonus on top of its normal score, making it effectively always win its resolution bucket.

Get Started

Deployment

Architecture

Plugins

Ranking

Ranking Presets: Default and Custom Configurations

Available Presets

default

custom

The Default Preset

Using the Default Preset

Default Preset Full Values

Custom Preset

Partial Override Pattern

Anime-Optimised Example

Build docs developers (and LLMs) love

Get Started

Deployment

Architecture

Plugins

Ranking

Documentation Index

​Available Presets

default

custom

​The Default Preset

​Using the Default Preset

​Default Preset Full Values

​Custom Preset

​Partial Override Pattern

​Anime-Optimised Example

Build docs developers (and LLMs) love

Available Presets

The Default Preset

Using the Default Preset

Default Preset Full Values

Custom Preset

Partial Override Pattern

Anime-Optimised Example