normalize-ssa
Extracts ssa/ass subtitle(s) from MKV videos and rescale/resize subtitles.
Prerequisites
- NodeJS >= 18 (http://nodejs.org/)
- NPM >= 8 (https://www.npmjs.org/)
Install
Windows
- Install nodejs following the instructions at http://nodejs.org/
- Install ffmpeg following the instructions at https://www.wikihow.com/Install-FFmpeg-on-Windows
- Run in Command Prompt:
npm install -g normalize-ssa
Mac OS X
- Install nodejs following the instructions at http://nodejs.org/
- Install homebrew following the instructions at https://brew.sh/
- Run in Terminal:
brew install ffmpeg
- Run in Terminal:
npm install -g normalize-ssa
Debian (Mint, Ubuntu, etc)
- Install nodejs following the instructions at http://nodejs.org/
- Run in Terminal:
sudo apt install ffmpeg
- Run in Terminal:
sudo npm install -g normalize-ssa
Update
Windows
- Ensure that
normalize-ssa
is installed - Run in Command Prompt:
npm install -g normalize-ssa
Mac OS X
- Ensure that
normalize-ssa
is installed - Run in Terminal:
npm install -g normalize-ssa
Debian (Mint, Ubuntu, etc)
- Ensure that
normalize-ssa
is installed - Run in Terminal:
sudo npm install -g normalize-ssa
Usage
Usage: normalize-ssa [options] [command]
Extracts ssa/ass subtitle(s) from MKV videos and rescale/resize subtitles.
Options:
-V, --version output the version number
-h, --help display help for command
Commands:
parse [options] <resourcePath...> Parse subtitle(s).
help [command] display help for command
Parse
To parse subtitles and rescale/resize, run:
normalize-ssa parse /path/to/your/video.mkv
Or to recursively find and parse .ass
/.mkv
files in a directory, run:
normalize-ssa parse /path/to/your/directory
To extract a different language than English from a .mkv
, like ger
for German, run:
normalize-ssa parse --language ger /path/to/your/fileOrDirectory
And to select a different font size, run:
normalize-ssa parse --size large /path/to/your/fileOrDirectory
The valid font sizes are tiny
, small
, normal
, large
or huge
.
Contributions
While software contributions are welcome, you can also help with:
- Documentation
- Helping other people
- Feature requests
- Bug reports
Questions?
Please make an issue if you have questions, wish to request a feature, etc.