https://github.com/caridy/plex-subtitles-normalizer

CLI tool to fix subtitles needed by Plex Media Center
https://github.com/caridy/plex-subtitles-normalizer

Last synced: 21 days ago
JSON representation

CLI tool to fix subtitles needed by Plex Media Center

• Host: GitHub
• URL: https://github.com/caridy/plex-subtitles-normalizer
• Owner: caridy
• Created: 2014-03-02T19:32:57.000Z (over 10 years ago)
• Default Branch: master
• Last Pushed: 2014-03-03T01:23:26.000Z (over 10 years ago)
• Last Synced: 2024-10-20T11:26:47.429Z (24 days ago)
• Language: JavaScript
• Size: 129 KB
• Stars: 13
• Watchers: 3
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

        
Plex Subtitles Normalizer CLI

-----------------------------

This CLI tool guarantee that SRT files have the proper format,

including empty lines.

As today, PLEX Player has issues when:

* breaklines (aka `\n`) are added at the top of the file before

the first block

* empty blocks with a single breakline.

This breaks subtitles, specially when casting them to Chromecast.

### Installation

This tool requires `nodejs`, and should installed as globals.

```

npm install plex-subtitles-normalizer --global

```

### How to Use

```

$ cd path/to/Movies

$ psn

```

By calling `psn` in a folder, it looks for any file with `.srt` extension, analyzing the file looking for invalid formats, if the file has any, it will create a backup of the file (by adding the `.bak` extension), and it will override the original file with the correct format.

### Advanced Options

#### Backups

You can pass an option to avoid creating backup files, although it is not recommended:

```

$ psn --no-backup

```

If something weird happen, you can always restore the backup, or simply use the backup as the original source:

```

$ psn --from-backup

```

#### Encoding

You can also select the encoding, by default `latin1` will be used. The tool will automatically detect some encoding issues, but if you find something weird, you can try to use an alternative encoding from [iconv-lite][], for example, you can use `Big5` for chinese:

```

$ psn --from-backup --encoding Big5

```

[iconv-lite]: https://github.com/ashtuchkin/iconv-lite#supported-encodings

#### Custom path

You can customize the pattern to search for subtitles:

```

$ psn --pattern **/*.srt

```