- Cross-platform: Windows, Mac and Linux
- Multi-language support
- Subtitle provider login support
- No hotkeys required: opening a video will automatically trigger subtitles to download
(Only when the right subtitles are not yet present)
This Lua script uses the Python program subliminal to download subtitles. Make sure you have both installed:
pip install subliminal
-
Copy autosub.lua into:
OS Path Windows [Drive]:\Users\[User]\AppData\Roaming\mpv\scripts\ Mac/Linux ~/.config/mpv/scripts/ mkdir ~/.config/mpv/scripts cat > ~/.config/mpv/scripts/autosub.lua [Paste script contents and CTRL+D]
-
Specify the correct subliminal location for your system:
-
To determine the correct path, use:
OS App Command Windows Command Prompt where subliminal Mac/Linux Terminal which subliminal -
Copy the path(s) to the subliminal variable(s) at the start of the script (optionally define multiple paths for different operating systems)
local subliminal_paths = { ['windows'] = '<path to subliminal.exe>', ['linux'] = '<path to subliminal>', ['darwin'] = '<path to subliminal>', }
On Windows, the backslashes in the path need to be escaped, e.g.:
C:\\Users\\Administrator\\AppData\\Local\\Programs\\Python\\Python37\\Scripts\\subliminal.exe
-
- Optionally change the subtitle languages / ISO codes.
Be sure to put your preferred language at the top of the list.
If necessary, you can manually trigger downloading your first choice language by pressingb
,
or your second choice language by pressingn
. - Optionally specify the login credentials for your preferred subtitle provider(s), if you have one.
- If you do not care for the automatic downloading functionality, and only wish to use the hotkeys,
simply change theauto
bool tofalse
. - For added convenience, you can specify the locations to exclude from auto-downloading subtitles, or alternatively,
the only locations that should auto-download subtitles.
This script is under the MIT License,
so you are free to modify and adapt this script to your needs:
check out the MPV Lua API for more information.
If you find yourself unable to find the correct subtitles for some niche movies/series, you might be interested in the submod command line tool I've written to manually correct subtitle timing.
Inspired by selsta's and fullmetalsheep's autosub scripts.