Skip to content

Latest commit

 

History

History
230 lines (174 loc) · 13.3 KB

README-EN.md

File metadata and controls

230 lines (174 loc) · 13.3 KB

Voice-over-translation

ru en

Caution

Before creating Issues, we strongly recommend that you read the FAQ section, as well as with existing Issues

The voice-over translation of the video is now available not only in YandexBrowser. Very grateful, Yandex.Translate, sodapng, mynovelhost, SashaXser and to all other contributors. Thanks <3

Installing the extension:

Warning

If you use Tampermonkey 5.2.0+, don't forget to enable Developer mode or use Tampermonkey MV2

  1. Install the extension Tampermonkey (An alternative for Safari: UserScripts)
  2. «Install the Script» (Cloudflare version)

List of functionality:

  1. Video translation from one of the available languages 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 if you have banned Yandex servers (in the Cloudflare version)

Useful links:

  1. Version for VioletMonkey, FireMonkey, GreaseMonkey, AdGuard, OrangeMonkey, UserScripts and some browsers (cloudflare-version): Link
  2. Terminal version (vot-cli): Link
  3. Wiki: Link

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.

⚠️ - Requires additional actions, more in Wiki

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

Warning

In the next version, the domain vot.toil.cc will be replaced by vot-worker.toil.cc. If you don't plan to upgrade extension and you are using the cloudflare version, then you will need to install the domain yourself vot-worker.toil.cc in the extension menu

M3U8 Proxy-server

How to build an extension?

  1. Install NodeJS 18+
  2. Install dependencies:
npm i

  1. Building an extension:

    3.0. All versions at once:

    npm run build

    3.1. All minified versions at once:

    npm run build:min

    3.2. Only the regular version:

    npm run build:default

    3.3. Cloudflare version only:

    npm run build:cloudflare

    3.2. Only the usual min. versions:

    npm run build:default-min

    3.3. Only min. Cloudflare versions:

    npm run build:cloudflare-min

  2. Installing the pre-commit hook:

    npm run prepare

Customization of appearance:

The extension supports customization of the appearance using Stylus, Stylish and other similar extensions

Example of changing styles:

/* ==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));
}

The extension has been tested in the following browsers:

Status Browser Browser Version Platform Extension
⠀✅ 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)
⠀✅ Yandex Browser v24.4-24.6 Windows Tampermonkey (MV2), Tampermonkey (MV3)
⠀✅ Arc v1.6.1 Windows Tampermonkey (MV3)

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"

Tested in the following extensions for user scripts:

Status Browser Extension
⠀✅ Any Tampermonkey Legacy (MV2)
⠀✅ Opera Tampermonkey Opera
⠀✅ Chrome Tampermonkey (MV3)
⠀⚠️ Download Safari Userscripts
⠀⚠️ Download Any Violetmonkey
⠀⚠️ Download Any AdGuard Usercripts
⠀⚠️ Download Firefox Firemonkey
⠀⚠️ Download Any Greasemonkey
⠀⚠️ Download Any OrangeMonkey

⚠️ - They are not priority extensions. These extensions, due to the "cloudflare" version of the user script, do not have cross-site synchronization of settings, and are also (practically) not tested before the release of a new version of the user script.

example btn

*: Banned on the territory of the Russian Federation