https://github.com/EnergoStalin/subtitle-translate-mpv
Modular script for translating subtitles on the fly into multiple languages.
https://github.com/EnergoStalin/subtitle-translate-mpv
lua mpv mpv-script subtitles translation
Last synced: 2 months ago
JSON representation
Modular script for translating subtitles on the fly into multiple languages.
- Host: GitHub
- URL: https://github.com/EnergoStalin/subtitle-translate-mpv
- Owner: EnergoStalin
- License: agpl-3.0
- Created: 2022-07-28T00:16:54.000Z (almost 4 years ago)
- Default Branch: master
- Last Pushed: 2026-01-13T15:17:05.000Z (5 months ago)
- Last Synced: 2026-01-26T14:53:48.976Z (4 months ago)
- Topics: lua, mpv, mpv-script, subtitles, translation
- Language: Lua
- Homepage:
- Size: 963 KB
- Stars: 37
- Watchers: 1
- Forks: 2
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE.md
Awesome Lists containing this project
README
# SubtitleTranslateMPV
[](https://wakatime.com/badge/user/e95ece5f-54ed-4ef2-9ff3-b88a5a8bfc5c/project/f492dcc3-e7cb-41cc-8bf0-899f69af8719)
> :memo:
> `~~` reffering to [mpv config folder](https://mpv.io/manual/stable/#script-location)
> :memo: You can benchmark defaultDelay by executing benchmark-sub-translator script message [see](#receiptrecommended-inputconf)
> :memo: secondary-sub-start currently unsupported
Modular script for auto translating subtitles on the fly into multiple languages.
You can extend it with you favorite translator by contributing one.
## :herb: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
## :arrow_down: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 they accessible from path
## :gear:Options
Avalible options `~~/script-opts/.conf`([see mp.get_script_name()](https://mpv.io/manual/stable/#lua-scripting-mp-get-script-name())) with default values
```cfg
# 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
```
## :receipt:Recommended input.conf
```cfg
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
:memo: One of providers listed below should be installed and specified in translator config field
- [Console-Translate](https://github.com/Lifailon/Console-Translate) see [Console-Translate.lua](https://github.com/EnergoStalin/subutils-mpv/blob/master/modules/translators/Console-Translate.lua) (Recommended) (:warning: Support translation only of ru,en languages and vice versa [see](https://github.com/Lifailon/Console-Translate/blob/26a83cfcf9921a573fa1620d16bb1a463092ee7b/Console-Translate/0.3/Console-Translate.psm1#L29-L32))
> :memo: Windows untested but should work
Average translation time by benchmark.lua **0.4s**
- [crow](https://github.com/crow-translate/crow-translate) see [crow.lua](https://github.com/EnergoStalin/subutils-mpv/blob/master/modules/translators/crow.lua)
> :warning::warning::warning: Crow may decide to encode your language not into utf-8 [#2](https://github.com/EnergoStalin/subtitle-translate-mpv/issues/2) then **subtitles will be broken**(fixed for russian by tricking [encoding](https://github.com/EnergoStalin/subtitle-translate-mpv/blob/master/modules/translators/encodings/auto.lua)) should work for major languages tho
Average translation time by benchmark.lua **0.85s**
Avalible via winget
```powershell
winget install --id KDE.CrowTranslate
```