# MKV Orchestrator

MKV Orchestrator is a self-hosted web console for homelab and NAS users that organizes Matroska (MKV) and MP4 media libraries by scanning folders, inspecting track metadata, renaming files from TVDB/TMDB data, and. It is open source and self-hosted, installable on Unraid.

Canonical page: https://ourlocalhost.com/app/3063/mkv-orchestrator

## Description

MKV Orchestrator is a self-hosted web console for homelab and NAS users that organizes Matroska (MKV) and MP4 media libraries by scanning folders, inspecting track metadata, renaming files from TVDB/TMDB data, and planning mux/remux operations with MKVToolNix and FFmpeg bundled so no separate tool installs are needed.

## Platform availability

Available on 1 of 10 platforms: Unraid.

## Health score

69/100 (Good), based on 4 of 5 factors.
- Maintained: 99 (last commit 40 days ago)
- Popular: 32 (37 GitHub stars)
- Easy to install: 35 (1 install platform, install notes, Docker image)
- Security check: 90 (no serious findings, CI, tests, new single-developer project)

## Links

- Unraid: https://ca.unraid.net/apps/mkv-orchestrator-1w1pxb41xuj1pg?q=MKV-Orchestrator
- GitHub: https://github.com/bamcel/mkv-orchestrator

## Common questions

### What filesystem paths should I mount in the Unraid container?

Mount your Unraid shares into /media and optionally /downloads. The container includes MKVToolNix and FFmpeg/FFprobe.

### Where do I configure TVDB or TMDB API keys in the container?

Provider API keys can be configured in the web Settings page or through optional masked environment variables.

### Can it discover libraries from an existing media server?

It discovers library paths from Emby, Jellyfin, or Plex, with per-library enablement and path mapping.

### Can a batch rename be reviewed or undone?

Rename batches are recorded so recent rename operations can be reviewed and undone.

### Does converting MP4 to MKV re-encode the video?

It converts MP4 files to MKV with a lossless container copy and no re-encoding. It can optionally clean up the original MP4.

---
Source: Our Local Host (https://ourlocalhost.com/app/3063/mkv-orchestrator), the self-hosted and open-source app directory.
