Overview

Assigns priority scores to audio and subtitle tracks in MKV files Assigns priority scores to audio and subtitle tracks in MKV files - kennethsible/mkvpriority MKVPriority assigns configurable priority scores to audio and subtitle tracks, similar to custom formats in Radarr/Sonarr. MKV flags, such as default and forced, are automatically set for the highest-priority tracks (e.g., 5.1 surround and ASS subtitles), while lower-priority tracks (e.g., stereo audio and PGS subtitles) are deprioritized. The project has 60 GitHub stars and is licensed under MIT.

Key Features

Source: GitHub README

Assigns configurable priority scores to audio and subtitle tracks (similar to custom formats in Radarr/Sonarr)
Automatically sets default/forced flags for the highest priority tracks (e.g., Japanese audio and ASS subtitles)
Deprioritizes unwanted audio and subtitle tracks (e.g., English dubs, commentary tracks, signs/songs)
Periodically scans your media library using a cron schedule and processes new MKV files with a database
Integrates with Radarr and Sonarr using a custom script to process new MKV files as they are imported

Getting Started

Source: GitHub README

usage: mkvpriority [-h] -c TOML_PATH[::TAG] [-a DB_PATH] [-v] [-x] [-q] [-p] [-n] [-r] [-e] [INPUT_PATH[::TAG] ...]

positional arguments:
  INPUT_PATH[::TAG]     files or directories

options:
  -c, --config TOML_PATH[::TAG]
  -a, --archive DB_PATH
  -v, --verbose         inspect track metadata
  -x, --debug           show mkvtoolnix output
  -q, --quiet           suppress logging output
  -p, --prune           prune database entries
  -n, --dry-run         simulate track changes
  -r, --restore         restore original tracks
  -e, --extract         extract embedded subtitles

Normalized Features

Source: tool-features-normalized.json

comments, docker, pip, rest api, scheduled tasks, webhooks.

Deploy

Docker

Self-host with Docker Compose

Coolify

One-click via Coolify panel

Elestio

Managed hosting from $9/mo

PikaPods

Simple managed hosting

Features

Integrations & APIs

REST API
Webhooks

Automation & Workflows

Scheduled Tasks / Cron

Collaboration

Comments & Discussions

Replaces

Related Media & Streaming Tools

View all 334 →

Immich

95K

High-performance self-hosted photo and video management — automatic backup, ML-powered search, and a Google Photos-like experience on your own server.

media AGPL-3.0

Jellyfin

49K

The volunteer-built media solution that puts you in control of your media. Stream movies, shows, music, and photos to any device from your own server.

media GPL-2.0