---

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

Большое спасибо разработчикам Yandex.Translate, Yandex.Browser и всем, кто помогает делать расширение еще лучше.

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

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

[!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

Из Chrome WebStore

Откройте Chrome WebStore и нажмите «Установить»

Из GitHub Releases

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

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

Из Firefox Add-ons

Откройте Firefox Add-ons и нажмите «Добавить в Firefox»

Из GitHub Releases

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

Возможности

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

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

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

Ограничения и рекомендации

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

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

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

Наши домены:

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

Proxy-сервер

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

• vot-new.toil-dump.workers.dev (⚠️ не работает в РФ)

Media Proxy-сервер

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

• media-proxy.toil.cc

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

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

NPM:

npm install

Bun:

bun install

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

Автоматическая сборка

Автоматическую сборку можно выполнить только с помощью Bun.sh:

bun run autobuild

После завершения в папке .output появятся артефакты сборки подготовленные для публикации в магазинах расширений Chrome и Firefox.

В папке dist-ext будет находится non-store сборка для распространения в виде .zip-архива (для Chrome) и .xpi-архива (для Firefox).

В папке dist будет находится сборка в виде юзерскрипта для установки через Tampermonkey или другие загрузчики юзерскриптов.

Ручная сборка

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

npm run build:gm:default

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

npm run build:gm:min

Userscript (обе версии):

npm run build:gm

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

npm run build:ext

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));
}

Contributing

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

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