Skip to content

Configuration Guide

Configuration File

MKV Episode Matcher uses a configuration file located at:

  • Windows: %USERPROFILE%\.mkv-episode-matcher\config.ini
  • Linux/Mac: ~/.mkv-episode-matcher/config.ini

Configuration Options

[Config]
# Required Settings
tmdb_api_key = your_tmdb_api_key
show_dir = /path/to/shows

# Optional Settings
max_threads = 4
open_subtitles_api_key = your_opensubs_key
open_subtitles_user_agent = your_user_agent
open_subtitles_username = your_username
open_subtitles_password = your_password

Command Line Configuration

All configuration options can be set via command line:

mkv-match \
  --tmdb-api-key "your_key" \
  --show-dir "/path/to/shows" \
  --season 1 \
  --dry-run true \
  --get-subs true

Detailed Options

TMDb Configuration

[Config]
tmdb_api_key = your_api_key

The TMDb API key is required for: - Show identification - Episode information - Season details

OpenSubtitles Configuration

[Config]
open_subtitles_api_key = your_key
open_subtitles_user_agent = your_agent
open_subtitles_username = username
open_subtitles_password = password

Required only if using subtitle download functionality.

Performance Settings

[Config]
max_threads = 4

Adjust based on your system's capabilities: - Default: 4 threads - Minimum: 1 thread - Maximum: Number of CPU cores