Tv-shows-file-renamer NPM

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`