[Support] MetaDen — Self-hosted movie file renamer (IMDB + TMDB + configurable rename templates)

MetaDen is a self-hosted movie file renamer built as a single Docker container. It scans your media folder, searches IMDB via OMDb, downloads posters from TMDB, and renames files using a configurable token-based format template. Inspired by the original Zeeb desktop app by slaingod, rebuilt ground-up for the modern homelab.

GitHub: https://github.com/exarkun10/metaden

Docker Hub: https://hub.docker.com/r/exarkun10/metaden

[v1.1 — Subtitle Support]

MetaDen now searches and downloads subtitles via OpenSubtitles after renaming. Searches by original release name for the best timing match, with Release match (green) and Generic (amber) badges so you know what you're getting. Subtitle downloads are tracked in undo history independently of the rename. Language preference is configurable in Settings.

Setup: Register a free API consumer key at https://www.opensubtitles.com/en/consumers and add it to your container as OPENSUBTITLES_API_KEY. The subtitle section appears automatically once configured.

Features:

• Recursive folder scanning with 3-level file tree (group → movie folder → files)

• IMDB search via OMDb API, auto-selects best match with year-aware ranking

• Poster browser — English posters prioritized, language badges on foreign posters

• Configurable rename format using tokens: <title> <year> <imdb> <rating> <scanres> and more

• Resolution scanning via ffprobe (actual file metadata, not filename guessing)

• Folder rename, poster download, URL file, and release_info.txt on rename

• Subtitle search and download via OpenSubtitles (optional, v1.1)

• Undo history with independent undo per action

• Extras/featurettes auto-detected and nested under parent movie

• Settings with auto-save, restore defaults, clickable token insertion

• Noise word lists (Codecs, Sources, Audio, Release Groups) — fully configurable

Quick Install (Unraid) Add container manually via Docker tab or import the CA template from the GitHub repo.

Repository: exarkun10/metaden:latest

Port: 8265

Config path: /mnt/user/appdata/metaden → /config

Media path: your movies folder → /media

Required API Keys (both free):

• TMDB: https://www.themoviedb.org/settings/api

• OMDb: https://www.omdbapi.com/apikey.aspx

Optional API Key (free):

• OpenSubtitles: https://www.opensubtitles.com/en/consumers

Built with Python 3.12 + FastAPI + Vue 3 + Tailwind CSS. MIT License.

Edited June 7Jun 7 by ExarKun10
[v1.1 — Subtitle Support]