49 lines
2.2 KiB
Markdown
49 lines
2.2 KiB
Markdown
# MPV Subtitle Translator (SubTranslate)
|
||
|
||
A simple [mpv](https://mpv.io/) Lua script that uses Google Translate API calls to translate currently displayed subtitles on-the-fly.
|
||
|
||
## Features
|
||
|
||
- **Auto-detects** the source language (via `source_lang = 'auto'`).
|
||
- Translates **into Russian** by default (change the `source_lang = 'ru'` parameter to any [Google Translate language code](https://cloud.google.com/translate/docs/languages)).
|
||
- Displays the translation in mpv’s On-Screen Display (OSD) for a selected duration (select in options).
|
||
|
||
## Requirements
|
||
|
||
- **mpv** (tested on versions 0.29+; works with older versions if you use the custom `url_encode()` script).
|
||
- **curl** (the script uses `mp.utils.subprocess` to invoke `curl`).
|
||
|
||
> **Note:** This script uses an **unofficial** Google Translate endpoint. Google can change or block this endpoint without notice.
|
||
|
||
## Installation
|
||
|
||
1. **Download** or create the script file: [SubTranslate.lua](./SubTranslate.lua).
|
||
2. **Place** it in your mpv `scripts` folder:
|
||
- **Linux/macOS**: `~/.config/mpv/scripts/`
|
||
- **Windows**: `%APPDATA%\mpv\scripts\`
|
||
3. **Restart** mpv (or open a new instance) so that the script loads.
|
||
|
||
## Usage
|
||
|
||
1. **Open** a video with subtitles in mpv.
|
||
2. When you see a subtitle on-screen, press **T** (you can change this keybind in the options at the beginning of the script).
|
||
3. The script sends the subtitle text to Google Translate, retrieves the translation, and displays it in the OSD.
|
||
|
||
## Changing the Target Language
|
||
|
||
- Edit the `SubTranslate.lua` file.
|
||
- Look for `destination_lang = 'ru'` and change it to whatever language you want to translate
|
||
|
||
## Troubleshooting
|
||
|
||
1. **`attempt to call field 'encode_url' (a nil value)`**
|
||
- Your mpv version might be too old to include `utils.encode_url()`. Try using the script version that defines a custom `url_encode()` function, or upgrade mpv to a more recent release.
|
||
|
||
2. **Translation Fails or Outputs Unexpected Results**
|
||
- Make sure you have a working internet connection.
|
||
- Check that `curl` is installed and in your system path.
|
||
- The unofficial Google Translate endpoint might be down or blocked.
|
||
|
||
3. **Other Issues**
|
||
- Run mpv from a terminal to see if there are any error messages.
|