selfhost.directory

The index of self-hostable projects — ranked, categorized and served with live updates.
Own your data and stop giving it to big tech.

GitHub
MDCz logo

Self-host MDCz

v0.20.0

Metadata scraper and organizer for JAV media libraries

BetaOpen SourceGPL-3.0
Updated13 hours ago
LanguageTypescript
Setup difficultyModerate
Stars
421
Port
3838 (WebUI HTTP server)
Docker
ghcr.io/shotheadman/mdcz

What is MDCz?

MDCz helps you manage local JAV video collections by automatically identifying movie codes from filenames and fetching detailed information from various online databases. It produces standard NFO files that work with popular media servers like Emby, Jellyfin, and Kodi, and can automatically rename and sort your files into a consistent folder structure. The software handles multi-part videos, streaming link files, and external subtitle files. You can run it as a desktop application on Windows, macOS (Apple Silicon), or Linux, or deploy the web interface on a NAS or server using Docker Compose. The web UI listens on port 3838 and stores its data in a local SQLite database, so no separate database server is needed. Development is active; the core scraping and organization features work, while some advanced options are still being polished.

Should you self-host MDCz?

MDCz scores 47/100 on selfhost.directory (how scoring works) and ranks #85 of 142 in Media Management. It has 421 GitHub stars.

It shipped 9 stable releases in the past year. The latest, v0.20.0, came out on 27 October 2026. New versions land roughly every 3 days.

Setup is moderate: expect some configuration beyond a single command. An official Docker image is available. It is GPL-3.0-licensed and written mostly in Typescript.

Its closest alternative on selfhost.directory is Sonarr (81/100, 17 472 stars). It scores higher overall, so compare the two before you pick. See MDCz vs Sonarr side by side.

Features

  • Actor alias normalization
  • Auto-rename and organization
  • Batch workbench with diff preview
  • Cross-platform Desktop App
  • Docker WebUI
  • Duplicate scanning and filename formatting
  • Embedded SQLite database
  • Emby/Jellyfin integration
  • Multipart video support
  • Multi-provider metadata scraping
  • NFO file generation

MDCz README

How to configure MDCz

  • MDCZ_ADMIN_PASSWORDOptional admin password to skip web UI first-time setup

    Optional admin password to skip web UI first-time setup

    values: Any string

  • MDCZ_BIND_IP127.0.0.1IP address to bind the WebUI to

    IP address to bind the WebUI to

    values: 127.0.0.1, 0.0.0.0, or LAN IP

  • MDCZ_MEDIA_PATHAbsolute path to media library on host (required)

    Absolute path to media library on host (required)

    values: Any existing host directory

  • MDCZ_STATE_PATH./dataData persistence directory for database, task data, and config

    Data persistence directory for database, task data, and config

    values: Any host path

  • MDCZ_VERSIONDocker image version to deploy (e.g., 0.15.0 without 'v' prefix)

    Docker image version to deploy (e.g., 0.15.0 without 'v' prefix)

    values: Any published release version

  • PGID1000Group ID for container process (file permissions)

    Group ID for container process (file permissions)

    values: Numeric GID

  • PUID1000User ID for container process (file permissions)

    User ID for container process (file permissions)

    values: Numeric UID

  • UMASK022File creation mask for generated files

    File creation mask for generated files

    values: Octal umask (e.g., 022, 002)

MDCz releases & version history

More in Media Management

Rate this project

Click to rate — no account needed.

0 comments

Posting as guest
Loading comments…