refactor: migrate to WXT and overhaul codebase by NullVerdict · Pull Request #1906 · ilyhalight/voice-over-translation

NullVerdict · 2026-10-26T18:40:29Z

Move extension builds to WXT and improve translation reliability.

Improve YouTube audio track selection and handling of temporary download failures.
Make translation status polling adaptive and prevent duplicate requests for completed translations.
Update auto source-language handling for Live Voice and improve translation restarts.
Improve reconnection after the extension’s background process restarts.
Optimize subtitle processing and improve screen-reader accessibility for decorative icons.
Refine redaction of JSON parsing errors in diagnostic messages.

[WIP] The Next Update

Add a mediaProxyHost setting next to the proxy worker host and pass it to vot.js as the mediaProxy option. The value is normalized to a bare host[:port]; empty or invalid input falls back to the default.

Phrase added to all locales with bun localize, hashes updated.

…y-v2 feat: make media proxy host configurable

NullVerdict · 2026-10-26T18:44:56Z

@ilyhalight В целом всё готово. Единственный вопрос по стратегиям от @Acobat12: они ломаются только в очень старых версиях Chrome (в 104 версии точно не работают).

ilyhalight · 2026-10-26T20:57:41Z

в коде в большинстве случаев используется import.meta.env.FIREFOX, но при этом есть isFirefoxBuild() в src/extension/background/telemetry-guard.ts, почему бы не использовать что-то одно

из .output пропала папка sourcemaps из-за чего sourcemap не загружаются в Bugsink.
stashSourcemaps кладёт карты расширения в dist-ext/sourcemaps/{chrome,firefox}, карты userscript лежат в dist/sourcemaps.

Лишний zip в артефакте workflow. autobuild оставляет в .output неподписанный vot-extension--firefox.zip, и он попадает в артефакт .output/.zip.

ilyhalight · 2026-10-26T20:57:51Z

@@ -63,38 +105,34 @@ export function bytesToBase64(bytes: Uint8Array): string {
  if (typeof btoaFn !== "function") {


может быть еще стоит btoaFn / atobFn просто на btoa / atob заменить, они вроде и так везде есть

ilyhalight · 2026-10-26T20:58:42Z

+ * (field 1 = ClientAbrState). Existing field 69 entries are replaced, every
+ * other field is copied byte-for-byte.
+ */
+export function setGeneratedSabrAudioTrackId(


нигде кроме тестов самой этой функции не используется

ещё вот

Мёртвый код, четыре предупреждения lint:

youtubeSabrPlayer.ts:8: импорт WebEmbeddedFormat;

youtubeSabrSupport.ts:5: импорт debug;

youtubeSabrSupport.ts:437: CurrentYouTubeAudioEvidence;

youtubeSabrSupport.ts:447: isVotSupportedAudioLanguage. Сама проверка поддерживаемых языков не потеряна, она переехала в resolveSabrAudioTrackId.

Поправил. Есть ещё какие-то моменты?

вроде нет, единственное из-за typescript 7, возможно, в ноде будет падать. Если там проблема только в моих либах, то обновлю их попозже

…d code

Acobat12 · 2026-10-27T02:06:51Z

Привет! Раз уж вы сейчас перерабатываете логику выбора аудиодорожек, возможно, стоит учесть ещё один момент, о котором я ранее писал.

Иногда YouTube показывает несколько дорожек одного языка, например en.4 и en.10. Сейчас в resolveSabrAudioTrackId() используется .find(), поэтому выбор зависит от порядка, в котором YouTube вернул дорожки.

Из-за этого может быть выбрана en.10, хотя также доступна en.4. При этом наличие дорожки в метаданных ещё не гарантирует, что её получится фактически скачать через SABR. В результате перевод потенциально может завершиться ошибкой, хотя другая дорожка того же языка могла бы работать.

Возможно, стоит немного изменить выбор: если среди дорожек нужного языка есть .4, отдавать ей приоритет, а если нет, оставлять существующую логику.

Сейчас:

const exact = availableTrackIds.find(
  (trackId) => sabrTrackLanguage(trackId) === requested,
);

Можно заменить на:

const exactMatches = availableTrackIds.filter(
  (trackId) => sabrTrackLanguage(trackId) === requested,
);

const exact =
  exactMatches.find((trackId) => trackId.endsWith(".4")) ??
  exactMatches[0];

Таким образом, если среди дорожек нужного языка присутствует .4, будет выбрана именно она как оригинальная дорожка. Если .4 отсутствует, сохранится прежнее поведение, выбор первой подходящей дорожки.

Это небольшое изменение позволит отдавать приоритет оригинальному аудио, не ломая существующую логику загрузки и резервные варианты.

Разумеется, решение за вами. Просто предлагаю небольшое улучшение, поскольку, когда я изначально работал над SABR, ещё не до конца разобрался с особенностями выбора аудиодорожек.

Acobat12 · 2026-10-27T02:40:56Z

@ilyhalight В целом всё готово. Единственный вопрос по стратегиям от @Acobat12: они ломаются только в очень старых версиях Chrome (в 104 версии точно не работают).

Старые версии Chrome я не тестировал. Проверял стратегии в разных браузерах, даже в Safari специально для этого создавал виртуальную машину с macOS. Также проверял Supermium.

Времени всё детально протестировать не было, хотя хотелось, чтобы потом пользователи не жаловались на ошибки :)

Что делать со старыми версиями Chrome, я даже сейчас не знаю. Другого решения у меня пока нет.

Что касается Supermium, то в нём стратегии работают. Это форк Chromium с поддержкой даже Windows XP: https://github.com/win32ss/supermium

Поэтому пользователи старых систем, которым нужен перевод, могут установить Supermium вместо устаревшего Chrome.

NullVerdict · 2026-10-27T14:38:09Z

@Acobat12 Интересное предложение, но хардкодить .4 нет смысла, эти цифры всегда разные. Единственный нормальный вариант это фильтровать по метаданным. Но пока никто на проблемы не жалуется, думаю, трогать это не стоит

ilyhalight · 2026-10-27T16:55:24Z

Но пока никто на проблемы не жалуется

вообще странно, что никто не жалуется. Судя по логам, относительно много неудачных попыток загрузки через web_sabr, хоть и примерно 2/3 из них, судя по всему, по итогу, успешно загружают аудио через обычный web_abr. В будущем нужно будет обязательно расширить этот лог, чтобы понимать в чем причина т.к. сейчас ~90% audio_failure из них это просто unknown

ilyhalight · 2026-10-28T07:47:46Z

можешь в vot.js дофиксить pr, чтобы я оба замержил сразу?

Acobat12 · 2026-10-28T08:09:21Z

Тяжело объяснить на словах, как это будет работать, но логика довольно простая.
Других цифр нету только .4 и .10

Если пользователь выбрал английский, сначала ищется именно английская дорожка, и только среди совпадений отдаётся приоритет .4.

Например, если пользователь выбрал испанский, а у видео доступны es-US.10 и оригинальная en-US.4, будет выбрана испанская es-US.10, а не английская.

Не бойтесь, этим изменением вы не сломаете переводы :) Наоборот, оно защищает от конкретной ошибки выбора аудиодорожки, о которой я ещё писал в PR #1873. В остальных случаях логика остаётся прежней.

Acobat12 · 2026-10-28T08:24:06Z

вообще странно, что никто не жалуется. Судя по логам, относительно много неудачных попыток загрузки через web_sabr, хоть и примерно 2/3 из них, судя по всему, по итогу, успешно загружают аудио через обычный web_abr. В будущем нужно будет обязательно расширить этот лог, чтобы понимать в чем причина т.к. сейчас ~90% audio_failure из них это просто unknown

Кроме уже предложенной замены выше .find() на .filter() с приоритетом .4, для исправления unknown в WXT нужны следующие изменения:

1. `youtubeSabrSupport.ts` обработка `unknown`

В resolveSabrAudioTrackId() найди:

if (!requested || requested === "auto") {
  return {
    availableTrackIds,
    supportedAlternativeTrackIds,
    usedSupportedAlternative: false,
  };
}

Замени на:

if (!requested || ["auto", "unknown", "und"].includes(requested)) {
  const supportedTracks = availableTrackIds.filter(
    (trackId) =>
      supportedAlternativeTrackIds.includes(trackId),
  );

  const originalTrack = availableTrackIds.find(
    (trackId) => trackId.endsWith(".4"),
  );

  const trackId =
    originalTrack && supportedTracks.includes(originalTrack)
      ? originalTrack
      : supportedTracks[0];

  return {
    trackId,
    availableTrackIds,
    supportedAlternativeTrackIds,
    usedSupportedAlternative:
      Boolean(trackId && trackId !== originalTrack),
  };
}

Теперь при unknown:

Если есть .4 и её язык поддерживается VOT, выбирается она.
Если .4 отсутствует или её язык не поддерживается VOT, выбирается первая дорожка с поддерживаемым языком.
Если ID отсутствуют, сохраняется существующий fallback.
Если среди доступных дорожек нет ни одной с поддерживаемым языком, trackId остаётся undefined. Дальнейшее поведение определяется существующей логикой загрузчика.

2. `youtubeSabrSupport.ts` ожидание дорожки

В waitForSabrAudioTrackId() найди:

if (!requested || requested === "auto") {

Замени на:

if (!requested || ["auto", "unknown", "und"].includes(requested)) {

Так unknown будет обрабатываться сразу, без бессмысленного ожидания совпадения с языком "unknown".

3. `youtubeSabrSupport.ts` фильтрация форматов

В selectSabrAudioFormat() найди:

const language = normalizeAudioLanguage(
  trackId ? sabrTrackLanguage(trackId) : requestedLanguage,
);

Замени на:

const normalizedLanguage = normalizeAudioLanguage(
  trackId ? sabrTrackLanguage(trackId) : requestedLanguage,
);

const language =
  normalizedLanguage &&
  !["auto", "unknown", "und"].includes(normalizedLanguage)
    ? normalizedLanguage
    : undefined;

Это необходимо, чтобы "unknown" не использовался как реальный язык при фильтрации аудиоформатов.

4. `youtubeSabr.ts` классификация fallback

Найди:

requestedSabrLanguage && requestedSabrLanguage !== "auto"
  ? "native-only"
  : "native-auto";

Замени на:

requestedSabrLanguage &&
!["auto", "unknown", "und"].includes(requestedSabrLanguage)
  ? "native-only"
  : "native-auto";

Это позволит правильно классифицировать загрузку с неизвестным языком как native-auto.

Итого нужно сделать всего 5 изменений: одно для приоритета .4 над .10, которое я уже описал выше и не стал повторять, и ещё четыре для обработки unknown.

Эти изменения направлены на улучшение определения аудиодорожек, а не на изменение существующей логики переводов. Не бойтесь, переводы от этого не должны сломаться :) Наоборот, это поможет избежать некоторых ошибок при выборе аудио. 💯

Acobat12 · 2026-10-28T09:19:41Z

После этих изменений, останется только один возможный сценарий, который в будущем может решиться сам собой, причём изменять код для этого не потребуется.

Например, оригинальный язык видео португальский (pt), но он ошибочно определился как unknown. В таком случае скрипт может отправить оригинальную португальскую дорожку в Яндекс. Если Яндекс не сможет обработать этот язык, перевод не получится.

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

А то, что пользователи сейчас особо не жалуются, вполне объяснимо. Когда VOT предлагает авторизоваться на YouTube, пользователь просто следует инструкции и пробует снова. Для него это выглядит как обычный шаг для продолжения перевода, а не как ошибка загрузки аудио. Поэтому отсутствие жалоб ещё не означает, что проблем с web_sabr нет :)

Так что тишина в комментариях не обязательно признак того, что всё работает идеально. Но, согласитесь, такая тишина тоже немного настораживает?)) У меня в форке такая же история тишина, блин! 😄

Acobat12 · 2026-10-28T11:48:42Z

Небольшое дополнение к моему предыдущему комментарию. Кажется, я всё-таки упустил один важный момент.

Даже если YouTube со временем добавит к видео автодубляж на поддерживаемый язык, это ещё не гарантирует, что скрипт сможет отправить новую дорожку на перевод.

Проблема в том, что Яндекс может вернуть уже существующий результат перевода и не запросить аудио повторно. В таком случае логика выбора дорожек в web_sabr просто не будет задействована.

Ранее я уже описывал способ принудительно запросить новый перевод в issue #1828.

В моих тестах для этого помогала передача wasStream: true вместе с изменённой длительностью видео:

videoData: {
  ...videoData,
  duration: videoData.duration + 300,
},
extraOpts: {
  wasStream: true,
},

Поэтому, возможно, стоит добавить отдельный режим принудительного запроса нового перевода.

Как вариант, эту логику можно реализовать в src/core/translationHandler.ts, в методе requestTranslationWithLivelyFallback(), непосредственно перед вызовом votClient.translateVideo(request), где формируется запрос к Яндексу.

При активации такого режима можно изменять videoData.duration и передавать extraOpts.wasStream: true. При этом для обычных запросов параметры лучше оставлять без изменений, чтобы не мешать получению уже готовых переводов.

Не уверен, что это самое подходящее место с точки зрения текущей архитектуры, но, возможно, такой вариант будет проще реализовать.

Тогда сценарий, который я описывал ранее, действительно сможет работать: если YouTube позже добавит поддерживаемую дорожку, можно будет принудительно запустить повторную обработку и попытаться отправить Яндексу уже её.

В моих тестах такой подход позволял обходить получение уже существующего перевода.

Получается, с фразой "изменять код не потребуется" я немного поспешил. 😄

ilyhalight and others added 14 commits October 19, 2026 16:57

Merge pull request #1819 from ilyhalight/dev

39fca17

[WIP] The Next Update

fix(#1819): yt subs duplicate on cache expire

cc02b1f

chore: added kinopoisk match

85c4ab3

build: update manifest

020f0e4

feat: make media proxy host configurable

ad710c6

Add a mediaProxyHost setting next to the proxy worker host and pass it to vot.js as the mediaProxy option. The value is normalized to a bare host[:port]; empty or invalid input falls back to the default.

fix: translate media proxy host setting

8b56caa

Phrase added to all locales with bun localize, hashes updated.

Merge pull request #1894 from AlexGromer/feat/configurable-media-prox…

5928802

…y-v2 feat: make media proxy host configurable

fix(#1895): init locale in iframe

4b66963

fix(#1892): play after translation is ready on inactive tab

0ad6878

fix: send illegal invocation error report in orangemonkey

973ee5f

chore: bump version

67f203e

docs: updated 1.12.2 changelog

bef075c

refactor: migrate to WXT and overhaul codebase

53e131a

refactor: improve translation/audio reliability

f9e7c46

ilyhalight reviewed Oct 26, 2026

View reviewed changes

fix(#1906): fix build artifacts, collect sourcemaps, and clean up dea…

0e69d64

…d code

NullVerdict marked this pull request as ready for review October 26, 2026 21:51

		@@ -63,38 +105,34 @@ export function bytesToBase64(bytes: Uint8Array): string {
		if (typeof btoaFn !== "function") {

Conversation

NullVerdict commented Oct 26, 2026

Uh oh!

NullVerdict commented Oct 26, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

ilyhalight commented Oct 26, 2026

Uh oh!

ilyhalight Oct 26, 2026

Choose a reason for hiding this comment

Uh oh!

ilyhalight Oct 26, 2026

Choose a reason for hiding this comment

Uh oh!

ilyhalight Oct 26, 2026

Choose a reason for hiding this comment

Uh oh!

NullVerdict Oct 26, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

ilyhalight Oct 26, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Acobat12 commented Oct 27, 2026

Uh oh!

Acobat12 commented Oct 27, 2026

Uh oh!

NullVerdict commented Oct 27, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

ilyhalight commented Oct 27, 2026

Uh oh!

ilyhalight commented Oct 28, 2026

Uh oh!

Acobat12 commented Oct 28, 2026

Uh oh!

Acobat12 commented Oct 28, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

1. youtubeSabrSupport.ts обработка unknown

2. youtubeSabrSupport.ts ожидание дорожки

3. youtubeSabrSupport.ts фильтрация форматов

4. youtubeSabr.ts классификация fallback

Uh oh!

Acobat12 commented Oct 28, 2026

Uh oh!

Acobat12 commented Oct 28, 2026

Uh oh!

Reviewers

Uh oh!

Assignees

Labels

Projects

Milestone

Development

Uh oh!

4 participants

NullVerdict commented Oct 26, 2026 •

edited

Loading

NullVerdict Oct 26, 2026 •

edited

Loading

ilyhalight Oct 26, 2026 •

edited

Loading

NullVerdict commented Oct 27, 2026 •

edited

Loading

Acobat12 commented Oct 28, 2026 •

edited

Loading

1. `youtubeSabrSupport.ts` обработка `unknown`

2. `youtubeSabrSupport.ts` ожидание дорожки

3. `youtubeSabrSupport.ts` фильтрация форматов

4. `youtubeSabr.ts` классификация fallback