Skip to content

Latest commit

 

History

History
41 lines (30 loc) · 1.38 KB

README.md

File metadata and controls

41 lines (30 loc) · 1.38 KB

subby

Extract PGS/VOBSUB/ASS Embedded Subtitles from video to SRT

Requirements:

  • Install Tesseract OCR 5.0 and additional languages
  • Install Java runtime
  • Pip install the requirements.txt (`pip install -r requirements.txt)

Usage

Subby is a companion script/tool for Plex server owners or just people that want to streamline subtitle OCR extraction from their media files.

Modes

Subby has two methods of operation:

python3 main.py --plex

Starts a plex scan using the `config.ini parameters, it will scan all libraries and pass any items with subtitles to subby.

Subby will then find out if the file has PGS/ASS/VOBSUB and if they exist while the file has no SRT file in the same directory, it will extract it from the video using OCR

python3 main.py D:/movie.mkv

This will process whichever file you're pointing it to, extracting subtitles if there's no existing SRT files present.

Config

  • notifyPlex: if true, after the plex scan and subtitle extraction subby will send an update notification to Plex to look for updates on the processed items and only on the processed items.
  • only4k: Plex scan will collect only 4k items for processing.
  • exportEmbeddedSRTs: if embedded subs are SRTs, this flag will tell subby to extract it.

Dependencies

This tool uses:

  • MkvToolNix (must be installed for Linux)
  • BDSup2Sup
  • AssToSrt
  • ImageMaker
  • PgsReader