SubtitleTranslateMPV

📝 ~~ reffering to mpv config folder

📝 You can benchmark defaultDelay by executing benchmark-sub-translator script message see

📝 secondary-sub-start currently unsopported

Modular script for auto translating subtitles on the fly into multiple languages. You can extend it with you favorite translator by contributing one.

🌿Features

• Auto enable when toLang not match any subtitle stream.
• Auto correct subtitle offset for comfort watching without delays.
• Register 4 script messages what you can bind via ~~/input.conf.
  • Toggle messages
    • sub-translated-only
    • sub-primary-original
  • enable-sub-translator
  • disable-sub-translator
  • benchmark-sub-translator

⬇️Install

• Clone repository into ~~/scripts folder

git clone --depth 1 https://github.com/EnergoStalin/subtitle-translate-mpv.git

• Setup default settings for mpv and script itself described below
• Install dependencies described below and make sure them accessible from path

⚙️Options

Avalible options ~~/script-opts/<cloned_folder_name>.conf(see mp.get_script_name()) with default values

# Initial subtitle delay for translator
defaultDelay=-0.5
# Which provider to use(see translators folder in repository) or Providers readme section for reference
translator=Console-Translate
# Show only primary text
translatedOnly=yes
# Use original text as primary
primaryOriginal=no
# Used in translator
fromLang=en
toLang=ru
# Full font name for showed text defaults to osd-font mpv property and can be omitted
osdFont=Anime Ace v3
# defaults to osd-font-size
osdFontSize=36
# Font scale relative to osdFontSize
osdOriginalFontScale=50
# Override all subtitle fonts to osdFont
overrideFonts=yes
# When any subitle stream language don't match toLang
# (match performed by lua string.find())
# Or there any external subtitle with unknown language
autoEnableTranslator=yes
# How fast delay adjusts default is 8 translate requests(ticks)
sensitivity=8

🧾Recommended input.conf

CTRL+t script-message enable-sub-translator
CTRL+T script-message disable-sub-translator
ALT+t script-message sub-translated-only
ALT+o script-message sub-primary-original

# Will run benchmark to determine optimal defaultDelay for current translator
# Check console for output
ALT+b script-message benchmark-sub-translator

Providers

📝 One of providers listed below should be installed and specified in translator config field

• Console-Translate see Console-Translate.lua (Recommended)

  📝 Windows untested but should work

  Average translation time by benchmark.lua 0.4s

• crow see crow.lua

  ⚠️⚠️⚠️ Crow may decide to encode your language not into utf-8 #2 then subtitles will be broken(fixed for russian by tricking encoding) should work for major languages tho

  Average translation time by benchmark.lua 0.85s

  Avalible via winget

  winget install --id CrowTranslate.CrowTranslate