voice-over-translation/README.md

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

Caution

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

Все права на оригинальное программное обеспечение принадлежат их правообладателям. Расширение не связано с оригинальными правообладателями.

Закадровый перевод видео теперь доступен не только в YandexBrowser. Большое спасибо разработчикам Yandex.Translate и всем контрибьюторам, которые помогают улучшать расширение.

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

Warning

Важно для пользователей Tampermonkey 5.2+ (MV3): В браузерах на движке Chromium (Chrome, Edge, Brave, Vivaldi и др.) необходимо:

1. Открыть страницу расширений (chrome://extensions) и включить «Режим разработчика» (подробности в документации Tampermonkey).
2. Если движок Chromium версии 138+, в «Сведениях» расширения включить «Разрешить пользовательские скрипты».

Пользователям Opera:

1. Используйте Violentmonkey вместо Tampermonkey.
2. В настройках расширения обязательно включите «Разрешить доступ к результатам на странице поиска» (гайд от Opera: как найти эту настройку), иначе скрипт не будет работать.

1. Установите загрузчик юзерскриптов: Tampermonkey (или Violentmonkey для Opera)
2. «Установить скрипт»

Установка нативного расширения для Chrome / Chromium

1. Откройте Releases и скачайте файл vot-extension-chrome-<версия>.zip
2. Откройте страницу расширений:
   • Chrome: chrome://extensions
   • Edge: edge://extensions
   • Brave: brave://extensions
   • Opera: opera://extensions
3. Включите «Режим разработчика»
4. Перетащите скачанный .zip-файл на страницу расширений

Установка нативного расширения для Firefox

1. Откройте Releases, нажмите на vot-extension-firefox-<версия>.xpi и подтвердите установку в Firefox

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

• Перевод видео на русский, английский или казахский с поддерживаемых языков
• Автоматический перевод видео при открытии
• Автоматическое включение субтитров при открытии
• Умное расположение субтитров: адаптация длины строк и размера текста под размер плеера
• Отображение субтитров, сгенерированных нейросетью
• Отображение субтитров с сайта (например, автопереведенные субтитры YouTube)
• Сохранение субтитров в форматах .srt, .vtt, .json
• Сохранение аудиодорожки перевода в формате .mp3
• Отдельные ползунки громкости для оригинального и переведённого звука
• Адаптивная громкость: приглушение оригинала, когда звучит перевод
• Ограничение перевода видео на родном языке (язык можно выбрать в меню)
• Синхронизация громкости перевода с громкостью видео
• Ограничение перевода с выбранных языков
• Горячие клавиши для перевода и управления субтитрами (включая комбинации клавиш)
• Простая настройка внешнего вида субтитров
• Отображение перевода отдельных слов в субтитрах

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

1. Библиотека для JS (vot.js): Ссылка
2. Версия для терминала (vot-cli): Ссылка
3. Вики: Ссылка

Примечание:

1. Рекомендуется разрешить автовоспроизведение «аудио и видео», чтобы избежать ошибок при работе расширения
2. Расширение не может переводить видео длиной более 4 часов (ограничение API переводчика)
3. Для стабильной работы загрузки аудио используйте актуальные и поддерживаемые загрузчики пользовательских скриптов (например, Tampermonkey или Violentmonkey)

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

Полный список поддерживаемых веб-сайтов и ограничения, связанные с их поддержкой, доступны в вики.

Наши домены:

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

Proxy-сервер

Нужен для проксирования запросов, если прямой доступ к серверам Яндекса недоступен.

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

Media Proxy-сервер

Нужен для проксирования .m3u8-файлов и корректной обработки непрямых ссылок на .mp4 и .webm.

• media-proxy.toil.cc

VOT-Backend

Нужен для перевода дополнительных сайтов с форматами видео, которые не поддерживаются серверами Яндекса напрямую.

• vot.toil.cc

VOT Status and Stats

Проверить текущий статус и аптайм всех серверов можно здесь:

• votstatus.toil.cc

Проверить статистику работы прокси-серверов (обновляется раз в 5 минут):

• votstats.toil.cc

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

1. Установите Node.js 22+ / Bun.sh
2. Установите зависимости:

NPM:

npm install

Bun:

bun install

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

   3.0. Userscript (обычная сборка):

   npm run build
   

   3.1. Userscript (минифицированная сборка):

   npm run build:min
   

   3.2. Userscript (обе версии подряд):

   npm run build:all
   

   3.3. Нативные расширения Chrome/Firefox:

   npm run build:ext
   

   3.4. Dev-сборка userscript с sourcemap:

   npm run build:dev
   

Артефакты userscript попадают в dist/, сборка нативных расширений — в dist-ext/.

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

Расширение поддерживает кастомизацию внешнего вида с помощью 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-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	Windows	Tampermonkey (MV2), FireMonkey, Violentmonkey, Greasemonkey
✅	Firefox	v116.0.2	Windows, Linux, Android	Tampermonkey (MV2), Violentmonkey
✅	Firefox Nightly	v118.0a1	Windows, Android	Tampermonkey (MV2)
✅	LibreWolf	v100.0.2-1	Windows	Tampermonkey (MV2)
✅	Brave	v1.46	Windows	Tampermonkey (MV2)
✅	MS Edge	v106.0.1370.34	Windows, Linux	Tampermonkey (MV2)
✅	Cent Browser	v4.3.9.248	Windows	Tampermonkey (MV2)
✅	Cent Browser Beta	v5.0.1002.182	Windows	Tampermonkey (MV2)
✅	Google Chrome	v106	Windows, MacOS, Linux	Tampermonkey (MV2), Tampermonkey (MV3), Violentmonkey, User Javascript and CSS
✅	Opera GX (LVL4)	core91	Windows	Violentmonkey
✅	Opera GX (LVL5)	core109	Windows	Violentmonkey
✅	Opera	v92.0.4561.43	Windows	Violentmonkey
✅	Vivaldi	5.7.2921.63	Windows, Linux	Tampermonkey (MV2)
✅	Safari	v15.6.1	MacOS, iOS	Userscripts, Tampermonkey
✅	Kiwi Browser	v116.0.5845.61	Android	Tampermonkey (MV2)
✅	Yandex Browser	v24.4	Windows	Tampermonkey (MV2), Tampermonkey (MV3)
✅	Arc	v1.6.1	Windows	Tampermonkey (MV3)
✅	Incognition	v4.1.1.0 (v125)	Windows	Tampermonkey (MV3), Tampermonkey (MV2)

Мин. версия браузера — это минимальная версия, на которой расширение было протестировано. Это не означает, что оно не запустится в более старых версиях. Учтите, что поддержкой и исправлением ошибок в устаревших браузерах мы не занимаемся.

Для активации скрипта в Tampermonkey (MV3) необходимо включить «Режим разработчика».

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

Статус	Браузер	Расширение
✅	Любой	Tampermonkey Legacy (MV2)
✅	Opera	Violentmonkey
✅	Chrome	Tampermonkey (MV3)
⚠️¹	Safari	Userscripts
✅	Любой	Violentmonkey
❔	Любой	AdGuard Userscripts
Гайд по установке	Firefox	Firemonkey
✅	Firefox	Greasemonkey
Гайд по установке¹	Любой	User Javascript and CSS

¹ - Работает в режиме проксирования, отключение функции «Использовать загрузку аудио» может приводить к проблемам с переводом новых видео.

Contributing

Пожалуйста, ознакомьтесь с гайдом для контрибьюторов.

Основано на проекте sodapng/voice-over-translation (license MIT)