Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/oltodosel/interSubs
Interactive subtitles for mpv. Instantly translate selected word/sentence.
https://github.com/oltodosel/interSubs
mpv mpv-script subtitles
Last synced: 3 months ago
JSON representation
Interactive subtitles for mpv. Instantly translate selected word/sentence.
- Host: GitHub
- URL: https://github.com/oltodosel/interSubs
- Owner: oltodosel
- License: mit
- Created: 2017-02-08T08:01:29.000Z (almost 8 years ago)
- Default Branch: master
- Last Pushed: 2023-03-13T20:25:58.000Z (over 1 year ago)
- Last Synced: 2024-06-30T12:33:45.174Z (5 months ago)
- Topics: mpv, mpv-script, subtitles
- Language: Python
- Homepage:
- Size: 874 KB
- Stars: 211
- Watchers: 10
- Forks: 20
- Open Issues: 5
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- awesome-mpv - interSubs - Interactive subtitles, instantly translate selected word/sentence. (Learning)
README
interSubs
=========
Interactive subtitles for [mpv](https://github.com/mpv-player/mpv), that was made to help study languages.
Easily tweaked and customizable.
v. 2.10 - Changelog at the bottom.
If Qt version doesn't work for you - use [Tk](https://github.com/oltodosel/interSubs/tree/master/Tk). It was abandoned(2017), but maybe still works.
* Supported dictionaries for words:
* https://dict.cc/
* https://pons.com/
* http://reverso.net/
* https://dict.leo.org/
* https://translate.google.com/
* http://morfix.co.il/
* https://redensarten-index.de/
* Supported dictionaries for sentences:
* https://www.deepl.com/translator
* https://translate.google.com/
* Supported dictionaries for word pronunciation:
* https://forvo.com/
* https://pons.com/
* https://translate.google.com/
* Offline \t separated dictionary. [details](https://github.com/oltodosel/interSubs/issues/36#issuecomment-803541985) | [pyglossary](https://github.com/ilius/pyglossary)
* http://linguee.com/ redirecting to browser by click.
* Can use multiple dictionaries simultaneously.
* Reassigning mouse buttons functions in config.
* Doesn't work with DVD (picture based) subtitles, only the text-based ones.
* [Script](https://github.com/oltodosel/extract_n_convert_dvd_bd_subtitles) to convert picture based subtitles into *.srt; also extracts them from *.mkv
* Can extend time of subs showing; for slow readers
```
00:02:23,046 --> 00:02:25,990
bla bla
00:02:28,020 --> 00:02:33,084
waka waka
00:02:23,046 --> 00:02:28,020
bla bla
00:02:28,020 --> 00:02:33,084
waka waka
```
Requirements
------------
* mpv 0.27 (I don't know if it will work with mpv front-ends.)
* Xorg (ignore for Mac users)
* composite manager; `xcompmgr` or sth. (ignore for Mac users)
* python => 3.6
* python-pyqt5
* python-numpy
* python-beautifulsoup4
* python-requests
* python-lxml
* python-httpx
* lua
* socat
* pkill
* xdotool (for hiding subtitles when minimizing mpv or switching window)
* optional: chromium (for external translation, other browser can be specified)
* optional: wget (for listening to pronunciation)
Installation
------------
* `mv interSubs.py interSubs.lua interSubs_config.py ~/.config/mpv/scripts/;`
* Edit configuration file `interSubs_config.py`
* Edit `interSubs.lua` to add option where interSubs will start automatically.
* For Mac also edit configuration at `interSubs.lua`
* On KDE(kwin) go to Compositor and uncheck "Allow applications to block compositing". [Screenshot](https://iwf1.com/wordpress/wp-content/uploads/2017/09/Disable-applications-override-compositor-KDE.jpg).
* For Windows - port it yourself. (It does NOT work on Windows. [reason](https://github.com/mpv-player/mpv/blob/master/DOCS/man/ipc.rst#command-prompt-example)) and [a possible way to do it](https://github.com/oltodosel/interSubs/issues/40#issuecomment-835767040)). Consider installing VirtualBox and Ubuntu or some other user-friendly distro.
Usage
-----
* Start video with mpv & select subtitles.
* F5 to start/stop interSubs.
* Starts automatically with files/paths specified in interSubs.lua
* Point cursor over the word to get popup with translation.
* F6 to hide/show without exiting.
Buttons bellow may be reassigned in config
-----
* Left-click - show translation in your browser.
* Right-click - listen to pronunciation.
* Wheel - scroll through transitions in popup.
* Wheel+Ctrl - resize subtitles.
* Wheel+Shift - change subtitles' vertical position.
* Wheel-click - cycle through auto_pause options.
* Wheel-click-left/right - +/- auto_pause_min_words. (fancy mouses)
* Back-click - translate whole sentence. (fancy mouses)
Troubleshooting
-----
* Does not work at all - launch `mpv` in a console, then start `interSubs` and see if there are any errors that might indicate on missing packages and install them.
* Background and subtitles are shown as solid black bars - install/launch a compositor.
* May have issues working in a multi-monitor system. See [the solution](https://github.com/oltodosel/interSubs/issues/26).
* On KDE subtitles might sometimes be invisible. See [the solution](https://github.com/oltodosel/interSubs/issues/12#issuecomment-433960146).
* On KDE subtitles fade instead of appearing immediately. See [the solution](https://github.com/oltodosel/interSubs/issues/39#issuecomment-810483614)
* Instead of changing system settings you may change [--x11-bypass-compositor](https://mpv.io/manual/stable/#options-x11-bypass-compositor)
* Stuttering video during subtitles change might be solved by changing mpv's video output `mpv --vo gpu`.
* On MacOS subtitles are not rendered on top of `mpv`. See [a possible solution](https://github.com/oltodosel/interSubs/issues/42#issuecomment-841725012)
* On MacOS subtitles are not rendered on top of `mpv` only in fullscreen mode. See [the solution](https://github.com/oltodosel/interSubs/issues/42#issuecomment-841746404)
Changelog
-----
* 2.0a
* Configs are incompatible with previous version.
* Tk is abandoned in favor of Qt.
* Background can be fully transparent or semi/fully opaque.
* Rendering is faster than with Tk.
* requires pyqt5 for python 3
* `pip install pyqt5` / `pacman -S python-pyqt5`
* requires composite manager for not solid bg; `xcompmgr` or sth.
* tested on Openbox, i3, KDE(kwin).
* On KDE(kwin) go to composite and uncheck "Allow applications to block compositing". [screenshot](https://iwf1.com/wordpress/wp-content/uploads/2017/09/Disable-applications-override-compositor-KDE.jpg)
* No more stalling when pointing on a wrong word; those words will be translated and saved in background.
* R2L isn't ready yet.
* Option to not save translations on the disk was removed.
* Noun colorization was removed.
* Randomization of translations was removed.
* Option to show N of previous subtitles is suspended for now, I might add it in the future.
* Tk version won't be updated unless something critical happens.
* 2.1
* R2L support (checked on Hebrew; works more or less).
* Minor corrections.
* 2.2
* Added https://dict.leo.org/ - de<>en/es/fr/it/pl/pt/ru/zh(cn)
* Minor corrections.
* 2.3
* Added option to limit extension of subtitles during long scenes without talking.
* `extend_subs_duration_limit_sec = 15`
* Updated https://translate.google.com/
* Now it gives complete output instead of single result.
* `mtranslate_google` -> `google`
* Added http://www.morfix.co.il/
* `morfix`
* Minor error corrections.
* 2.4
* Fixed non-working deepl.com
* Minor corrections.
* 2.5
* Added option to hide/show interSubs without exiting - F6
* Minor corrections.
* 2.6
* Fixed inability to start after update to pyqt5 5.11.3 or sth in that area. Didn't look for version that causes it specifically.
* 2.7
* Fixed residual flickering of previous lines during subtitles change. Began to happen at qt5.12 or so.
* 2.8
* Fixed gtts/pons pronunciation.
* Fixed google-translation.
* 2.9
* Added google-translation for full sentences(default mouse Back-click):
* `f_translation_full_sentence` to bind to mouse instead of `f_deepl_translation`
* in config `translation_function_name_full_sentence = 'google'`
* 2.10
* Fixed google-translation