mnamer
mnamer (media renamer) is an intelligent and highly configurable media organization utility. It parses media filenames for metadata, searches the web to fill in the blanks, and then renames and moves them.
Currently it has integration support with TVDb and TvMaze for television episodes and TMDb and OMDb for movies.
Documentation
Check out the wiki page for more details.
$ uv tool install mnamer or $ pip3 install --user mnamer
$ docker pull jkwill87/mnamer
✍️ Formatting
Using the episode-directory, episode-format, movie-directory, or movie-format settings you customize how your files are renamed. Variables wrapped in braces {} get substituted with of parsed values of template field variables.
Language is supported by the default TMDb and TVDb providers. You can use the --language setting to set the language used for templating.
mnamer also supports subtitle files (.srt, .idx, .sub). It will use the format pattern used for movie or episode media files with its extension prefixed by its 2-letter language code.
🧰 Settings
USAGE: mnamer [preferences] [directives] target [targets ...]
POSITIONAL:
[TARGET,...]: media file file path(s) to process
PARAMETERS:
The following flags can be used to customize mnamer's behaviour. Their long
forms may also be set in a '.mnamer-v2.json' config file, in which case cli
arguments will take precedence.
-b, --batch: process automatically without interactive prompts
-l, --lower: rename files using lowercase characters
-r, --recurse: search for files within nested directories
-s, --scene: use dots in place of alphanumeric chars
-v, --verbose: increase output verbosity
--hits=<NUMBER>: limit the maximum number of hits for each query
--ignore=<PATTERN,...>: ignore files matching these regular expressions
--language=<LANG>: specify the search language
--mask=<EXTENSION,...>: only process given file types
--no-guess: disable best guess; e.g. when no matches or network down
--no-overwrite: prevent relocation if it would overwrite a file
--no-style: print to stdout without using colour or unicode chars
--movie-api={*tmdb,omdb}: set movie api provider
--movie-directory: set movie relocation directory
--movie-format: set movie renaming format specification
--episode-api={tvdb,*tvmaze}: set episode api provider
--episode-directory: set episode relocation directory
--episode-format: set episode renaming format specification
DIRECTIVES:
Directives are one-off arguments that are used to perform secondary tasks
like overriding media detection. They can't be used in '.mnamer-v2.json'.
-V, --version: display the running mnamer version number
--clear-cache: clear request cache
--config-dump: prints current config JSON to stdout then exits
--config-ignore: skips loading config file for session
--config-path=<PATH>: specifies configuration path to load
--id-imdb=<ID>: specify an IMDb movie id override
--id-tmdb=<ID>: specify a TMDb movie id override
--id-tvdb=<ID>: specify a TVDb series id override
--id-tvmaze=<ID>: specify a TvMaze series id override
--no-cache: disable request cache
--media={movie,episode}: override media detection
--test: mocks the renaming and moving of files
Parameters can either by entered as command line arguments or from a config file named .mnamer-v2.json.
Contributions
Community contributions are a welcome addition to the project. In order to be merged upstream any additions will need to be formatted with ruff for consistency with the rest of the project and pass the continuous integration tests run against each PR. Before introducing any major features or changes to the configuration api please consider opening an issue to outline your proposal.
Bug reports are also welcome on the issue page. Please include any generated crash reports if applicable. Feature requests are welcome but consider checking out if it is in the works first to avoid duplication.
Star History
1 maintainer
Metadata
1 maintainer
Release files for mnamer 2.7.2
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| mnamer-2.7.2.tar.gz | 5.3 MB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| mnamer-2.7.2-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 5.3 MB
Release files / mnamer-2.7.2.tar.gz
| Download URL | mnamer-2.7.2.tar.gz |
|---|---|
| Size | 5.3 MB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
46926e4cc49c3163059f2dc8302d5a2eb5b687ada5393600a439a89691c6c7c4
|
|
BLAKE2b-256 checksum How to use checksums |
19d5edca80dcade48bb598f329fabc239e99b4121be266295b496490d1266bce
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.11.16 {"installer":{"name":"uv","version":"0.11.16","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
|
Release files / mnamer-2.7.2-py3-none-any.whl
| Download URL | mnamer-2.7.2-py3-none-any.whl |
|---|---|
| Size | 36.3 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
0e779015a25c1be51d0ad637bcd4a3507dfd4be97ad5c3455ff7aa7808db0c16
|
|
BLAKE2b-256 checksum How to use checksums |
f22018d217431097534f9299264e6ba26a37b8eebdff85fd0e5fff11d83b23e1
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.11.16 {"installer":{"name":"uv","version":"0.11.16","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
|
