Skip to content

zpix1/yt-anti-translate

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

YouTube Anti Translate

Chrome Web Store Rating Mozilla Add-on Rating Edge Add-on Rating

Overview

Source code of YouTube Anti Translate Chromium Extension created by zpix1, And YouTube Anti Translate - mv3 Firefox Extension mantained by namakeingo. Also available on the Microsoft Edge Store.

All the people involved were annoyed by YouTube changing video titles to poorly user-translated versions. While it might be useful if you do not know the language, it quickly becomes annoying once you do. As there is no option provided by YouTube to disable it, we made this extension to retrieve original titles and change them back. As YouTube later got even more annoying with translated descriptions, audio (dubbing) and channel branding, the extension was expanded to untranslate that too.

It is much easier to use than its analogues (such as YoutubeAutotranslateCanceler), because it does not require any YouTube API keys (for core features) or additional userscript extensions.

Features

  • Restores original video titles on YouTube (can be toggled in settings "Untranslate titles")
  • Restores original video descriptions on YouTube (can be toggled in settings "Untranslate description")
  • Restores original video chapters (can be toggled in settings "Untranslate video chapters")
  • Disables automatic audio (dubbing) translation (can be toggled in settings "Untranslate audio track")
  • Restores original video thumbnails on YouTube (can be toggled in settings "Untranslate video thumbnails")
  • Restores original channel branding header and about on YouTube (can be toggled in settings "Untranslate channel branding")
  • Restores original channels' names everywhere else
  • Untranslates YouTube Shorts audio and titles
  • Works on m.youtube.com too (some mobile features are still unsupported and/or experimental)
  • Works on youtube-nocookie.com
  • Works on embeded YouTube videos
  • Works automatically without any configuration
  • "Advanced Settings" to allow translations for specified channels (using the @ handle of any channel)

Warning

For compatibility with DeArrow it is recommended do disable "Untranslate titles" and "Untranslate video thumbnails". You can then use DeArrow's options page, under "Behavior" menu section, and enable "Default to Original Video Information" to still have translated titles and thumbnail from DeArrow.

Enhanced Features Reliability Option

In the extension settings, you can optionally provide a YouTube Data API Key. Although this is optional, it is reccomended.

When that is populated, some features work more reliably. Read more on how to obtain

How to use

If using Chrome/Edge or other Chromium browsers, install it from Chrome Web Store. If using a Firefox browser, install it from Firefox Extensions Store.

There's also a Firefox Manifest v3 version (maintained by artisticfox8) since 2021. Currently it is mostly the same as the Chrome version, but it used to include a number of Firefox specific fixes in the past.

Development Setup

  1. Clone this repository
  2. Navigate to the cloned folder and run the following command in a terminal window npm ci
  3. Open with the IDE editor of choice
  4. You can verify functionality by running Playwright Test (make sure you install Playwright extensions for your IDE if needed)
    • Before running the tests, you will need to install playwright browsers and dependencies npx playwright install --with-deps
    • Please create or update tests if adding new capabilities
    • For running tests on your machine you need a .env file with values for GOOGLE_USER, GOOGLE_PWD and GOOGLE_OTP_SECRET.

      [!NOTE] These .env values should be valid credentials to a Google (YouTube) Account with 2FA OTP enabled and OTP as the highest level of security on the account (aka no "Google prompt" or "Passkeys and security keys" configured). GOOGLE_OTP_SECRET is the "secret" query parameter of the QR Code that is provided when configuring the 2FA OTP Authenticathor. You can use a QR Code reader to read the text value. It is recommended that you create a test account for this purpose.

Testing in Browser

  • Chrome

    1. Open Chrome and navigate to chrome://extensions/
    2. Enable "Developer mode"
    3. Click "Load unpacked" and select the app directory from this repository
  • Firefox

    1. Create a .zip of app directory (Note that manifest.json must be at the root of the archive)
    2. Open Firefox and navigate to about:addons
    3. Click the gear icon, click on "Install Add-on from File", select the zip file you created in step 1

Contributing

Contributions are welcome! Here's how you can help:

  1. Report bugs: If you find any issues, please open an issue in this repository
  2. Suggest features: Have an idea to improve the extension? Let me know by opening an issue
  3. Submit code: Feel free to fork the repository and submit pull requests
  4. Join our Discord server: You can also join our Discord server to discuss development and contribute.

Support

If this extension really helped you, consider supporting the original creator at their donation page.

You can also show your support by:

Contributors