https://github.com/disrupted/subclean

🧙📖 Simple CLI to instantly enhance your movie & TV show subtitles
https://github.com/disrupted/subclean

cli command-line movie plex python radarr sonarr srt subtitle tv

Last synced: about 1 year ago
JSON representation

🧙📖 Simple CLI to instantly enhance your movie & TV show subtitles

• Host: GitHub
• URL: https://github.com/disrupted/subclean
• Owner: disrupted
• License: gpl-3.0
• Created: 2021-01-08T23:46:28.000Z (over 5 years ago)
• Default Branch: main
• Last Pushed: 2025-03-30T00:32:53.000Z (about 1 year ago)
• Last Synced: 2025-04-01T19:03:24.224Z (about 1 year ago)
• Topics: cli, command-line, movie, plex, python, radarr, sonarr, srt, subtitle, tv
• Language: Python
• Homepage:
• Size: 1.06 MB
• Stars: 20
• Watchers: 3
• Forks: 1
• Open Issues: 10
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

          
# Subclean

> Simple CLI to instantly enhance your movie & TV show subtitles.

## Installation

```

pip install subclean

```

## Example

```

$ subclean subtitle.srt

12:35:30.337 | INFO | Importing subtitle subtitle.srt

12:35:30.344 | INFO | BlacklistProcessor running

12:35:30.397 | INFO | SDHProcessor running

12:35:30.421 | INFO | DialogProcessor running

12:35:30.426 | INFO | ErrorProcessor running

12:35:30.458 | INFO | LineLengthProcessor running

12:35:30.466 | INFO | Saving subtitle subtitle_clean.srt

```

![before-after](https://github.com/disrupted/subclean/blob/main/docs/img/subclean-diff.png?raw=true)

## Usage

```

subclean [-h] [-v] [-V] [-o OUTPUT | --overwrite]

                   [--processors {LineLength,SDH,Blacklist,Error,Style,Dialog}

                   [--regex REGEX] [--line-length LINE_LENGTH]

                   FILE [FILE ...]

positional arguments:

  FILE                  Subtitle file to be processed

optional arguments:

  -h, --help            show this help message and exit

  -v, --verbose         Increase output verbosity

  -V, --version         show program's version number and

                        exit

  -o OUTPUT, --output OUTPUT

                        Set output filename

  --overwrite           Overwrite input file

  --processors {LineLength,SDH,Blacklist,Error,Style,Dialog}

                        Processors to run

                        (default: Blacklist SDH Dialog Error LineLength Style)

  --regex REGEX         Add custom regular expression to BlacklistProcessor

  --line-length LINE_LENGTH

                        Maximum total line length when concatenating short lines.

                        (default: 50)

```