voice-over-translation/README.md

Закадровый перевод видео

Caution

Перед созданием Issues настоятельно рекомендуем ознакомиться с разделом FAQ, а так же с уже существующими Issues

Закадровый перевод видео, теперь, доступен не только в YandexBrowser. Очень признателен, Yandex.Translate, sodapng, mynovelhost, SashaXser и всем остальным контрибьюторам. Спасиб <3

Установка расширения:

Warning

Если вы пользуетесь Tampermonkey 5.2.0+, не забудьте включить режим разработчика или используйте Tampermonkey MV2

1. Установите расширение Tampermonkey (Альтернатива для Safari: UserScripts)
2. «Установите Скрипт» (Cloudflare version)

Список функционала:

1. Перевод видео с одного из доступных языков на русский, английский или казахский
2. Перевод стримов на YouTube (работает с небольшой задержкой)
3. Отображение субтитров сгенерированных нейросетью (на YouTube дополнительно отображаются автосгенерированные субтитры)
4. Сохранение используемых субтитров (в .srt формате)
5. Сохранение аудиодорожки перевода (в .mp3 формате)
6. Автоматический перевод видео при открытие
7. Слайдеры для изменения громкости видео и перевода
8. Автоматическое выставление громкости переведенного видео (как в Яндекс браузере)
9. Синхронизация громкости перевода с громкостью видео
10. Ограничить перевод видео с родного языка (язык можно выбрать в меню)
11. Проксирование аудио, если у вас забанены сервера Яндекса (в Cloudflare версии)

Полезные ссылки:

1. Версия для VioletMonkey, FireMonkey, GreaseMonkey, AdGuard, OrangeMonkey, UserScripts и некоторых браузеров (cloudflare-version): Ссылка
2. Версия для терминала (vot-cli): Ссылка
3. Вики: Link

Примечание:

1. Рекомендую разрешить автовоспроизведение "аудио и видео", чтобы избежать ошибок при работе расширения
2. Расширение не может переводить видео длиной более 4 часов (ограничение API переводчика)

Список поддерживаемых сайтов:

Все ограничения, связанные с поддержкой сайтов вы можете увидеть в вики.

• YouTube
• Twitch
• VK
• OK
• [⚠️] Twitter
• 9GAG
• Rutube
• Bilibili
• Видео Mail.ru
• Vimeo
• XVideos
• PornHub
• Bitchute
• Coursera
• [⚠️] Udemy
• [⚠️] Facebook*
• TikTok
• Rumble
• EPorner
• Peertube
• Dailymotion
• Trovo
• [⚠️] Yandex Disk
• Google Drive
• Banned Video
• Weverse
• Egghead
• Youku
• Newgrounds
• ProxiTok
• Invidious
• Piped
• Любые прямые веб-ссылки на .mp4

⚠️ - Требует дополнительных действий, подробнее в Wiki

Наши домены:

Эти домены могут быть установлены в настройках расширения (здесь указаны только те домены, которые можно изменить без пересборки):

Proxy-сервер

• vot.toil.cc (Балансировщик между прокси серверами)
• vot-worker.toil.cc
• vot.deno.dev
• vot-new.toil-dump.workers.dev (⚠️ не работает в РФ)

M3U8 Proxy-сервер

• m3u8-proxy.toil.cc
• m3u8-proxy.toiloff.workers.dev (⚠️ не работает в РФ. Не рекомендуется к использованию из-за низких лимитов.)

Как собрать расширение?

1. Установите NodeJS 18+
2. Установите зависимости:

npm i

3. Сборка расширения:

   3.0. Все версии сразу:

   npm run build
   

   3.1. Все минифицированные версии сразу:

   npm run build:min
   

   3.2. Только обычная версии:

   npm run build:default
   

   3.3. Только Cloudflare версии:

   npm run build:cloudflare
   

   3.2. Только обычная мин. версии:

   npm run build:default-min
   

   3.3. Только мин. Cloudflare версии:

   npm run build:cloudflare-min
   

4. Установка pre-commit хука:

   npm run prepare
   

Кастомизация внешнего вида:

Расширение поддерживает кастомизацию внешнего вида с помощью Stylus, Stylish и других подобных расширений

Пример изменения стилей:

/* ==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-background: rgba(var(--vot-surface-rgb, 46, 47, 52), 0.8);
  --vot-subtitles-color: rgb(var(--vot-onsurface-rgb, 227, 227, 227));
  --vot-subtitles-passed-color: rgb(var(--vot-primary-rgb, 33, 150, 243));
}

Расширение протестировано в следующих браузерах:

Статус	Браузер	Версия браузера	Платформа	Расширение
⠀✅	Firefox Developer Edition	v106 — v128, 64 bit	Windows	Tampermonkey (MV2)
⠀✅	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	v106.0.5249.91	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 — 126	Windows, MacOS, Linux	Tampermonkey (MV2), Tampermonkey (MV3), Violetmonkey, OrangeMonkey
⠀✅	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)

Работа с современной версией Tampermonkey (MV3) не тестировалась в большинстве браузеров. При наличие проблем рекомендуется использовать Tampermonkey Legacy (MV2)

Протестировано в следующих расширениях для юзерскриптов:

Статус	Браузер	Расширение
⠀✅	Любой	Tampermonkey Legacy (MV2)
⠀✅	Opera	Tampermonkey Opera
⠀✅	Chrome	Tampermonkey (MV3)
⠀⚠️ Загрузить	Safari	Userscripts
⠀⚠️ Загрузить	Любой	Violetmonkey
⠀⚠️ Загрузить	Любой	AdGuard Usercripts
⠀⚠️ Загрузить	Firefox	Firemonkey
⠀⚠️ Загрузить	Любой	Greasemonkey
⠀⚠️ Загрузить	Любой	OrangeMonkey

⚠️ - Не являются приоритетными расширениями. Эти расширения из-за "cloudflare" версии юзерскрипта не имеют межсайтовой синхронизации настроек, а так же (практически) не тестируются перед выходом новой версии юзерскрипта.

*: Запрещена на территории РФ