tvTag is a quick little tool I build to help me rename my downloaded TV episodes in a sensible fashion. Regexs and bash scripts do the job, but I wanted something a little more robust, a little more fully featured, a little easier to use, et voilá, tvTag was born.
There are plenty of alternatives out there such as TV Rename and TV Renamer but they seemed to have awkward GUI models which I found hard and frustrating to use. tvTag was my attempt at making a better, simpler, CLI–based tool.
tvTag has already done the job of helping me get my TV archives in good order, so further work on the tool will slow down. If I ever make it a little more robust and tidy things up, I'll make the source available.
$ python tvtag.py --help
Usage: tvtag.py [options] baseDir inputPattern
Options:
--version show program's version number and exit
-h, --help show this help message and exit
-v, --verbose print debug output
-d, --dryrun see results without moving files
-f FILETYPES, --filetypes=FILETYPES
filter on filetypes, defaults to
*.avi;*.mkv;*.mp4;*.mpg;*.mpeg;*.wmv
Episode Overrides:
These options allow you to set default values for various episode
attributes. These will override any parsed values.
-t TITLE, --title=TITLE
-n SHOW, --show=SHOW
-e SEASON, --season=SEASON
-s EPISODE, --episode=EPISODE
tvTag uses the user-defined inputPattern pattern to parse show names, season
and episode numbers, and titles of each episode found under the baseDir. This
pattern should contain the following markers: [n] (name of the show), [s]
(season number), [e] (episode number), and [t] (epsiode title).
If necessary, you can also throw Python-friendly regex syntax of your own into the mix in order to tidy things up.