Python script that connects to thetvdb.com and renames your TV series in any fashion you want.
Other series renaming scripts I tried follow a very error-prone procedure. They scan each filename independently and try to extract all information about the episode from that.
Now my One Piece episodes are named like opdub283.mp4
and ---one piece episode 691 -u0026 692 english sub full hd.mp4
. How do you expect them to extract any info from this ?
So I decided to make my own series renamer. To be able to rename (fix) even badly named files like the above, my script -
- scans the working directory non-recursively
- gets the name of the TV/Anime series the folder has from the user
- gets TVDB information of the TV series the user specified.
- scans through the filenames for potential season numbers / episode numbers. Once you have the series name and the season/episode number accurate, nothing can stop your TV series collection from having a proper name.
pip install series-renamer
or download the zip and extract it.
python setup.py install
- Open command prompt aka terminal in the directory you want to scan and run the following command.
series-renamer
- Give the series name. Make sure you write the name as precisely as possible.
- The script will connect to TVDB and then scan the filenames. After that it will give you suggestions on the season numbers/episode numbers of files.
- Choose the appropriate option and move forward. Use option 'a' (automatic) if possible.
- In the end the script will create a log (series-renamer-log.html) in the root of the folder that was currently examined.
- Confirm with (y) and all episodes in the folder will be renamed.
- Customizable episode renaming format.
- Works even without season information in the filename. It then uses episode_number as the absolute episode_number of the TV Series.
- You can explictly specify season and episode number at runtime.
- Supports multi-episodes separated by hyphen like
Friends [10x17-18].mkv
. - Subtitle files are automatically renamed.
- More extra configurations to make sure your tv collection is properly detected and renamed.
Some sample logs created by series-renamer can be viewed from this link.
It is recommended you read some docs to be fully comfortable with Series Renamer.
Just create an issue, I will be glad to be of any help.