tv-shows-file-renamer
CLI tool to automatically rename and group files for TV series.
Main functionality:
- Extract series metadata from thetvdb.com API.
- Group episodes by Season folders.
- Automatically change subtitles encoding to UTF-8 from specified encoding.
- Build filenames which are easily recognizable by Plex mediaserver
So, if you have bunch of files named like this:
🎬 150.mkv
📝 150.eng.srt
🎬 S09E11 - ONEPIECE - 153.mkv
🎬 [CoolSubsTeam] - 196 - OnePiece.mkv
The tool provides a fast way to get this:
📁 Season 09
🎬 S09E007 - 150 - Dreams Don't Come True! Bellamy vs. The Saruyama Alliance.mkv
📝 S09E007 - 150 - Dreams Don't Come True! Bellamy vs. The Saruyama Alliance.eng.srt
🎬 S09E010 - 153 - This is the Sea of the Sky! The Knight of the Sky and Heaven's Gate.mkv
📁 Season 10
🎬 S10E001 - 196 - Emergency Announcement! An Infamous Pirate Ship has Invaded!.mkv
Prerequisites
This tool is built with NodeJS, so it should be installed in your system.
- NodeJS at least
v8.5.0 - NPM at least
5.3.0
Installation
npm i -g tv-shows-file-renamer
Usage
Just call it in folder with your series and specify parameters
tv-shows-file-renamer -s one-piece
Commandline parameters:
| Key | Value | Description | Example |
|---|---|---|---|
| -s | serie identificator | This is a serie identificator used by thetvdb.com API. To get it you need to locate you serie on the thetvdb.com website and copy part of URL. For example for this url: https://www.thetvdb.com/series/one-piece the serie id is one-piece |
-s one-piece |
| -d | dry run mode | You can check expected output but without actual performing any operations on disk. Useful when you are not sure about whether metadata are correct. | -d |
| -m | only extract metadata | Does not perform any operations with you series, only downloads metadata for given serie from thetvdb.com API and saves that to META.json file. |
-m |
| -e | encode subtitles | Performs re-encoding of *.srt files from specified encoding to UTF-8 |
-e cp1251 |
Please use it on your own risk, if you are not sure please make backup of your data first!
Licence: MIT