2 stable releases
2.0.0 | May 16, 2023 |
---|---|
1.2.1 | Dec 11, 2022 |
#1767 in Command line utilities
29KB
367 lines
movie-rename
A simple tool to rename movies, written in Rust.
It turns a file like Apur.Sansar.HEVC.2160p.AC3.mkv
into Apur Sansar (1959) - Satyajit Ray.mkv
using metadata pulled from TMDB.
This is made mostly due to mnamer not having support for director's name, and also because I wanted to try writing something useful in Rust.
Installation
Install from AUR, my personal lure-repo or download the binary from the releases. You can also get it from crates.io.
You can also install from source by using
git clone https://github.com/SinTan1729/movie-rename
cd movie-rename
sudo make install
Usage
-
The syntax is:
movie-rename <filename(s)> [-n|--dry-run] [-d|--directory] [-h|--help] [-v|--version]
-
There needs to be a config file named
config
in the$XDG_CONFIG_HOME/movie-rename/
directory. -
It should consist of two lines. The first line should have your TMDB API key.
-
The second line should have a pattern, that will be used for the rename.
-
In the pattern, the variables need to be enclosed in
{}
, the supported variables aretitle
,year
anddirector
. -
Default pattern is
{title} ({year}) - {director}
. Extension is always kept. -
Passing
--directory
or-d
assumes that the arguments are directory names, which contain exactly one movie and optionally subtitles. -
Passing
--dry-run
or-n
does a dry tun and only prints out the new names, without actually doing anything. -
Passing
-nd
or-dn
does a dry run in directory mode. -
Passing
--help
or-h
shows help and exits. -
Passing
--version
or-v
shows version and exits.
Notes
- Currently, it only supports names in English. It should be easy to turn it into a configurable option. Since for movies in all the languages I know, English name is usually provided, it's a non-feature for me. If someone is willing to test it out for other languages, they're welcome. I'm open to accepting PRs.
- I plan to add more variables in the future. Support for TV Shows will not be added, since tvnamer does that excellently.
Dependencies
~10–24MB
~254K SLoC