mov-renamarr/docs/CONFIG.md

Configuration Reference

This document describes all supported options in config.toml.

Locations

• Config: $XDG_CONFIG_HOME/mov-renamarr/config.toml (fallback ~/.config/mov-renamarr/config.toml)
• Cache: $XDG_CACHE_HOME/mov-renamarr/cache.db (fallback ~/.cache/mov-renamarr/cache.db)

The app creates a commented default config on first run if none exists.

Precedence

1. Built-in defaults
2. Config file
3. Environment variables
4. CLI flags

Minimal example

provider = "auto"
api_key_tmdb = "YOUR_TMDB_KEY_OR_READ_ACCESS_TOKEN"
quality_tags = ["resolution"]

[llm]
mode = "off"

Providers

provider = "auto" # auto|tmdb|omdb|both
api_key_tmdb = "..."   # TMDb API key or Read Access Token (Bearer)
api_key_omdb = "..."   # OMDb API key

Cache

cache_path = "/home/user/.cache/mov-renamarr/cache.db"
cache_ttl_days = 30
refresh_cache = false

Reporting and sidecars

report_format = "text" # text|json|csv
sidecar_notes = false  # write per-file notes for skipped/failed
sidecars = false       # move/copy sidecar files (srt, nfo, etc)
dry_run_summary = false # suppress per-file output (use with --dry-run)

Matching and naming

min_score = 80         # 0-100 match threshold
include_id = false     # include tmdb/imdb id in filenames
no_lookup = false      # skip external providers (filename/LLM only)
explain = false        # show top candidates when skipped

Quality tags

quality_tags = ["resolution"]          # list
# or
quality_tags = "resolution,codec"      # comma-separated string

Supported tags: resolution, codec, source, all, none.

Output safety

overwrite = false      # replace existing files
suffix = false         # add " (1)", " (2)" on collision

Console

color = "auto"         # auto|always|never

Concurrency

jobs = "auto"          # auto or integer
net_jobs = "auto"      # auto or integer

LLM (Ollama)

Install Ollama: ollama.com

[llm]
mode = "off"           # off|parse|assist
endpoint = "http://localhost:11434"
model = "Qwen2.5:latest"
timeout_seconds = 30
max_tokens = 256

Recommended models:

• Qwen2.5:latest (safe default)
• Qwen2.5:14b (higher accuracy, more RAM/VRAM) Alternatives:
• llama3.1:8b (strong general-purpose)
• gemma2:9b (fast, efficient)
• mistral-nemo:12b (mid-size, long context)
• phi3:14b (compact, good structure)

Provider base URLs (for testing)

tmdb_base_url = "https://api.themoviedb.org/3"
omdb_base_url = "https://www.omdbapi.com"

Environment variables

All config settings can be overridden with environment variables using the MOV_RENAMARR_ prefix (e.g., MOV_RENAMARR_TMDB_API_KEY).