# jkwill87/mnamer

media file renaming and organizing tool

Repository: https://github.com/jkwill87/mnamer
Canonical: https://ross.abutalabs.com/products/mnamer
Homepage: https://pypi.org/project/mnamer
Language: Python
License: MIT
License Family: permissive
Topics: python, metadata, cli, organizer, batch, media, movie, television
Last push: 2026-08-05T05:51:28+00:00

## Health v2 (maintenance only)
Score: 93/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 96, release rhythm 85, longevity 100
- inputs: {"age_days": 3243, "days_push": 28, "days_rel": 103, "gap_med": 10, "n_releases_24m": 4}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 1142, forks 113 (observed 2026-08-28T04:03:44.735984+00:00)

## What it is
mnamer is a Python command-line utility that parses media filenames for metadata, queries online providers like TVDb, TvMaze, TMDb, and OMDb to fill in missing details, and renames and moves files according to configurable templates. It supports movies, TV episodes, and subtitle files with customizable formatting and language settings.

## Use cases
- rename and organize movie files with proper titles
- batch rename tv episodes with season and episode numbers
- organize a messy media library automatically
- rename subtitle files to match their video files
- fetch metadata from tmdb to fix media filenames
- standardize media file naming conventions for plex or kodi

## When to choose
- you need a scriptable CLI to batch rename large media collections
- you want automatic metadata lookup from TVDb, TvMaze, TMDb, or OMDb
- you need customizable naming templates and multi-language support
- you want a Docker image for automated media organization pipelines

## When to avoid
- you prefer a GUI-based media manager
- you need streaming or playback features rather than file organization
- you want a fully stable Rust rewrite - the v3 branch is still work-in-progress

## Facets
- artifact type: cli-tool
- maturity: active
- function: cli, file-system, nlp, web-scraping
- domain: media, files, developer-tools
- platform: python, cli, cross-platform
- tags: media-renamer, file-organizer, metadata-lookup, tvdb, tmdb, batch-renaming, subtitles, automation, docker

## Member repositories
- jkwill87/mnamer (main) score 93

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:03:44.735984+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-30T06:35:05.492438+00:00, confidence not recorded.
  - readme: https://github.com/jkwill87/mnamer (fetched 2026-08-28T04:03:44.735984+00:00, sha 2c9ba936a571)
  - homepage: https://pypi.org/project/mnamer (fetched 2026-08-29T12:40:19.717092+00:00, sha 4b4e8fead74a)
  - registry_pypi: https://pypi.org/pypi/mnamer/json (fetched 2026-08-29T12:40:19.725878+00:00, sha 0c0d2092288b)
- Data as of 2026-08-30T08:39:29.467469+00:00.