Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/ilyhalight/voice-over-translation
Небольшое расширение, которое добавляет закадровый перевод видео из YaBrowser в другие браузеры
https://github.com/ilyhalight/voice-over-translation
Last synced: about 1 month ago
JSON representation
Небольшое расширение, которое добавляет закадровый перевод видео из YaBrowser в другие браузеры
- Host: GitHub
- URL: https://github.com/ilyhalight/voice-over-translation
- Owner: ilyhalight
- License: mit
- Fork: true (sodapng/voice-over-translation)
- Created: 2022-01-22T18:48:22.000Z (almost 3 years ago)
- Default Branch: master
- Last Pushed: 2024-05-29T01:55:19.000Z (6 months ago)
- Last Synced: 2024-05-29T07:03:42.803Z (6 months ago)
- Language: JavaScript
- Homepage:
- Size: 11.9 MB
- Stars: 2,848
- Watchers: 33
- Forks: 212
- Open Issues: 62
-
Metadata Files:
- Readme: README-EN.md
- Changelog: changelog.md
- License: LICENSE
Awesome Lists containing this project
README
# Voice-over-translation
[](README.md)
[](README-EN.md)
> [!CAUTION]
> Before creating Issues, we strongly recommend that you read the [FAQ](https://github.com/ilyhalight/voice-over-translation/wiki/%5BEN%5D-FAQ) section, as well as with existing [Issues](https://github.com/ilyhalight/voice-over-translation/issues)
The voice-over translation of the video is now available not only in YandexBrowser. Very grateful, **[Yandex.Translate](https://translate.yandex.ru/)**, **[sodapng](https://github.com/sodapng)**, **[mynovelhost](https://github.com/mynovelhost)**, **[SashaXser](https://github.com/SashaXser)** and to all other contributors. Thanks <3
## Installing the extension:
> [!WARNING]
> If you use Tampermonkey 5.2.0+, don't forget to [enable](https://github.com/ilyhalight/voice-over-translation/issues/662#issuecomment-2160768958) Developer mode or use Tampermonkey MV2
1. Install the extension **[Tampermonkey](https://www.tampermonkey.net/)** (An alternative for Safari: **[UserScripts](https://apps.apple.com/app/userscripts/id1463298887)**)
2. **[«Install the Script»](https://raw.githubusercontent.com/ilyhalight/voice-over-translation/master/dist/vot.user.js)**
## List of functionality:
1. Video translation from [one of the available languages](LANG_SUPPORT.md) in russian, english or kazakh
2. Translation of streams to YouTube (works with a slight delay)
3. Displaying subtitles generated by the neural network (autogenerated subtitles are additionally displayed on YouTube)
4. Saving used subtitles (in `.srt` format)
5. Saving the audio track of the translation (in `.mp3` format)
6. Automatic video translation when opening
7. Sliders for changing video volume and translation
8. Automatic setting of the translated video volume (as in Yandex browser)
9. Synchronizing the translation volume with the video volume
10. Limit the translation of videos from your native language (you can select the language in the menu)
11. Audio proxying
12. Translation with hotkey
### Useful links:
1. Javascript library (vot.js): **[Link](https://github.com/FOSWLY/vot.js)**
2. Terminal version (vot-cli): **[Link](https://github.com/FOSWLY/vot-cli)**
3. Wiki: **[Link](https://github.com/ilyhalight/voice-over-translation/wiki)**
## Note:
1. I recommend allowing autoplay of "audio and video" to avoid errors when working with the extension
2. The extension cannot translate videos longer than 4 hours (translator API limitation)
## List of supported sites:
You can see all the restrictions related to site support in [wiki](https://github.com/ilyhalight/voice-over-translation/wiki/%5BEN%5D-Supported-sites).
- **[YouTube](https://www.youtube.com)**
- **[Twitch](https://www.twitch.tv)**
- **[VK](https://vk.com)**
- **[OK](https://ok.ru/)**
- **[Twitter](https://twitter.com/)**
- **[9GAG](https://9gag.com/gag/)**
- **[Rutube](https://rutube.ru/)**
- **[Bilibili](https://bilibili.com/)**
- **[Video Mail.ru](https://my.mail.ru/video)**
- **[Vimeo](https://vimeo.com/)**
- **[XVideos](https://xvideos.com/)**
- **[PornHub](https://rt.pornhub.com/)**
- **[Bitchute](https://www.bitchute.com/)**
- **[Coursera](https://www.coursera.org/)**
- **[[⚠️] Udemy](https://www.udemy.com/)**
- **[Facebook\*](https://facebook.com/)**
- **[TikTok](https://tiktok.com/)**
- **[Rumble](https://rumble.com/)**
- **[EPorner](https://www.eporner.com/)**
- **[Peertube](https://tube.shanti.cafe/)**
- **[Dailymotion](https://www.dailymotion.com/)**
- **[Trovo](https://trovo.live/)**
- **[Yandex Disk](https://disk.yandex.ru/)**
- **[Google Drive](https://drive.google.com/)**
- **[Banned Video](https://banned.video/)**
- **[Weverse](https://weverse.io/)**
- **[Egghead](https://egghead.io)**
- **[Youku](https://youku.com)**
- **[Archive.org](https://archive.org)**
- **[Newgrounds](https://newgrounds.com)**
- **[ProxiTok](https://proxitok.pabloferreiro.es/)**
- **[Invidious](https://yewtu.be)**
- **[Piped](https://piped.video)**
- **[Kodik (player)](https://kodik.cc)**
- **[Patreon](https://patreon.com)**
- **[Reddit](https://reddit.com)**
- **[Kick](https://kick.com)**
- **[Apple Developer](https://developer.apple.com)**
- **[EpicGames Developers](https://dev.epicgames.com)**
- **[9AnimeTV](https://9animetv.to/)**
- **[Sap learning](https://learning.sap.com/)**
- **[Watchporn.to](https://watchporn.to/)**
- **[Linkedin learning](https://www.linkedin.com/)**
- **Any direct web links to `.mp4` or `.webm`**
⚠️ - Requires additional actions, more in **[Wiki](https://github.com/ilyhalight/voice-over-translation/wiki/%5BEN%5D-Supported-sites)**
### Our domains:
These domains can be set in the extension settings (only those domains that can be changed without rebuilding are listed here):
#### Proxy-server
It's necessary for proxying requests if it is not possible to make a direct request to the Yandex servers
- [vot-worker.toil.cc](https://vot-worker.toil.cc/health) (Load balancer between proxy servers)
- [vot-worker-s1.toil.cc](https://github.com/FOSWLY/vot-worker)
- [vot-worker-s2.toil.cc](https://github.com/FOSWLY/vot-worker)
- [vot.deno.dev](https://github.com/FOSWLY/vot-worker)
- [vot-new.toil-dump.workers.dev](https://github.com/FOSWLY/vot-worker) (⚠️ doesn't work in Russia)
#### Media Proxy-server
It's necessary for proxying `.m3u8` files and correcting the translation for indirect links to `.mp4` or `.webm`(for more information in the repository)
- [media-proxy.toil.cc](https://github.com/FOSWLY/media-proxy)
#### VOT-Backend
It's necessary to translate additional sites that use the `.m3u8` or `.mpd` video format.
- [vot.toil.cc](https://github.com/FOSWLY/vot-backend)
## How to build an extension?
1. Install Node.js 18.18+ / Bun.sh
2. Install dependencies:
```bash
npm install
```
Bun:
```bash
bun install --yarn
```
3. Building an extension:
3.0. All versions at once:
```bash
npm run build
```
3.1. All minified versions at once:
```bash
npm run build:min
```
3.2. Only the regular version:
```bash
npm run build:default
```
3.3. Only the usual min. versions:
```bash
npm run build:default-min
```
### How to patch vot.js
1. Make the necessary changes to node_modules/vot.js/the required file
2. Save the changes using:
NPM (not tested, but it should work):
```bash
npx patch-package vot.js
```
Bun:
```bash
bunx patch-package --use-yarn vot.js
```
Do not use patches from the `bun patch` or from any npm packages. They will be incompatible with the patch-package, and may also break when updating the package.
### How to update localization files
For all interaction with localization files, the l10n-tui utility is made.
To call the utility, use the command:
```bash
bun l10n
```
You can read more about the utility [here](scripts/l10n-tui/README.md)
## Customization of appearance:
The extension supports customization of the appearance using Stylus, Stylish and other similar extensions
Example of changing styles:
```css
/* ==UserStyle==
@name VOT-styles
@version 16.09.2023
@namespace vot-styles
@description LLL
@author Toil
@license No License
==/UserStyle== */
:root {
--vot-font-family: "Roboto", "Segoe UI", BlinkMacSystemFont, system-ui,
-apple-system;
--vot-primary-rgb: 139, 180, 245;
--vot-onprimary-rgb: 32, 33, 36;
--vot-surface-rgb: 32, 33, 36;
--vot-onsurface-rgb: 227, 227, 227;
--vot-subtitles-color: rgb(var(--vot-onsurface-rgb, 227, 227, 227));
--vot-subtitles-passed-color: rgb(var(--vot-primary-rgb, 33, 150, 243));
}
```
## The extension has been tested in the following browsers:
| Status | Browser | Browser Version | Platform | Extension |
| ------ | ------------------------- | --------------------------------- | ----------------------- | ------------------------------------------------------------------------------------------- |
| ⠀✅ | Firefox Developer Edition | v106 — v129, 64 bit | Windows | Tampermonkey (MV2), FireMonkey, VioletMonkey, Greasemonkey |
| ⠀✅ | Firefox | v116.0.2 | Windows, Linux, Android | Tampermonkey (MV2), Violetmonkey |
| ⠀✅ | Firefox Nightly | v118.0a1 | Windows, Android | Tampermonkey (MV2) |
| ⠀✅ | LibreWolf | v100.0.2-1 | Windows | Tampermonkey (MV2) |
| ⠀✅ | Brave | v1.46 - v1.68.134 | Windows | Tampermonkey (MV2) |
| ⠀✅ | MS Edge | v106.0.1370.34 | Windows, Linux | Tampermonkey (MV2) |
| ⠀✅ | Cent Browser | v4.3.9.248, 32 bit | Windows | Tampermonkey (MV2) |
| ⠀✅ | Cent Browser Beta | v5.0.1002.182, 64 bit | Windows | Tampermonkey (MV2) |
| ⠀✅ | Google Chrome | v106 — v127 | Windows, MacOS, Linux | Tampermonkey (MV2), Tampermonkey (MV3), Violetmonkey, OrangeMonkey, User Javascript and CSS |
| ⠀✅ | Opera GX | LVL4 (core: 91) - LVL5 (core 109) | Windows | Tampermonkey Opera |
| ⠀✅ | Opera | v92.0.4561.43 | Windows | Tampermonkey Opera |
| ⠀✅ | Vivaldi | 5.7.2921.63 | Windows, Linux | Tampermonkey (MV2) |
| ⠀✅ | Safari | v15.6.1 | MacOS, iOS | Userscripts |
| ⠀✅ | Kiwi Browser | v116.0.5845.61 | Android | Tampermonkey (MV2) |
| ⠀✅ | Yandex Browser | v24.4-24.6 | Windows | Tampermonkey (MV2), Tampermonkey (MV3) |
| ⠀✅ | Arc | v1.6.1 | Windows | Tampermonkey (MV3) |
| ⠀✅ | Incognition | v4.1.1.0 (v125) | Windows | Tampermonkey (MV3), Tampermonkey (MV2) |
Working with the modern version of Tampermonkey (MV3) has not been tested in most browsers. If there are problems, it is recommended to use Tampermonkey Legacy (MV2)
To activate the script in Tampermonkey (MV3), you must [enable "Developer Mode"](https://www.tampermonkey.net/faq.php#Q209)
## Tested in the following extensions for user scripts:
| Status | Browser | Extension |
| -------------------------------------------------------------------------------------------------------------------------------------- | ------- | ---------------------------------------------------------------------------------- |
| ⠀✅ | Any | Tampermonkey Legacy (MV2) |
| ⠀✅ | Opera | Tampermonkey Opera |
| ⠀✅ | Chrome | Tampermonkey (MV3) |
| ⠀❔ | Safari | Userscripts |
| ⠀✅ | Any | Violetmonkey |
| ⠀❔ | Any | [AdGuard Usercripts](https://kb.adguard.com/en/general/userscripts#supported-apps) |
| ⠀[Install guide](https://github.com/ilyhalight/voice-over-translation/wiki/%5BEN%5D-FAQ#how-to-use-the-extension-with-firemonkey) | Firefox | Firemonkey |
| ⠀✅ | Firefox | Greasemonkey |
| ⚠️ requestIdleCallback is full of errors, but it works | Any | OrangeMonkey |
| ⠀[Install guide](https://github.com/ilyhalight/voice-over-translation/wiki/%5BEN%5D-FAQ#how-to-use-the-extension-with-user-js-and-css) | Any | User Javascript and CSS |
\*: Banned on the territory of the Russian Federation