This code is a userscript designed to remove auto-translations of...

September 3, 2025 at 10:34 AM


// ==UserScript==
// @name         Youtube Auto-translate Canceler
// @namespace    https://github.com/pcouy/YoutubeAutotranslateCanceler/
// @version      0.4
// @description  Remove auto-translated youtube titles
// @author       Pierre Couy
// @match        https://www.youtube.com/*
// @grant        GM_setValue
// @grant        GM_getValue
// ==/UserScript==


(function() {
    'use strict';
    var NO_API_KEY = false;
    if(GM_getValue("api_key") === undefined || GM_getValue("api_key") === null || GM_getValue("api_key") === ""){
        GM_setValue("api_key", prompt("Enter your API key. Go to https://developers.google.com/youtube/v3/getting-started to know how to obtain an API key, then go to https://console.developers.google.com/apis/api/youtube.googleapis.com/ in order to enable Youtube Data API for your key."));
    }
    if(GM_getValue("api_key") === undefined || GM_getValue("api_key") === null || GM_getValue("api_key") === ""){
        NO_API_KEY = true;
    }
    const API_KEY = GM_getValue("api_key");
    var API_KEY_VALID = false;


    var url_template = "https://www.googleapis.com/youtube/v3/videos?part=snippet&id={IDs}&key=" + API_KEY;

    var cachedTitles = {}

    var currentLocation;
    var changedDescription;
    var alreadyChanged;
    var recheckTimer = -1;

    function getVideoID(a)
    {
        while(a.tagName != "A") a = a.parentNode;
        return a.href.match (/(?:v=)([a-zA-Z0-9-_]{11})/)[1];
    }

    function resetChanged(){
        console.log(" --- Page Change detected! --- ");
        currentLocation = document.title;
        changedDescription = false;
        alreadyChanged = [];
    }

    function changeTitles(){
        if(currentLocation !== document.title) resetChanged();

        if (window.location.href.includes ("/watch")){
            var titleMatch = document.title.match (/^(?:\([0-9]+\) )?(.*?)(?: - YouTube)$/);
            if (!titleMatch) {
                console.log ("ERROR: Video is deleted!");
                if (recheckTimer == -1) recheckTimer = setInterval(changeTitles, 1000);
                return;
            }
            var pageTitle = document.getElementsByClassName("title style-scope ytd-video-primary-info-renderer");
            if (pageTitle.length > 0 && pageTitle[0] !== undefined && titleMatch != null) {
                if (pageTitle[0].innerText != titleMatch[1]){
                    console.log ("Reverting main video title '" + pageTitle[0].innerText + "' to '" + titleMatch[1] + "'");
                    pageTitle[0].innerText = titleMatch[1];
                }
            }
        }

        if (NO_API_KEY) {
            return;
        }

        var APIcallIDs;

        var videoIDElements = Array.prototype.slice.call(document.querySelectorAll("#video-title")).filter(el => {
            return el.className.includes("-video-") && alreadyChanged.indexOf(el) == -1;
        } );

        var mainVidID = "";
        if (!changedDescription && window.location.href.includes ("/watch")){
            mainVidID = window.location.href.match (/(?:v=)([a-zA-Z0-9-_]{11})/)[1];
        }

        if(mainVidID != "" || videoIDElements.length > 0)
        { 

            if (recheckTimer != -1) {
                clearInterval(recheckTimer);
                recheckTimer = -1;
            }
            var IDs = videoIDElements.map( a => getVideoID (a));
            var APIFetchIDs = IDs.filter(id => cachedTitles[id] === undefined);
            if (mainVidID != "") APIFetchIDs.splice(0, 0, mainVidID); 
            var totalIDsToDo = APIFetchIDs.length; 
            APIFetchIDs = APIFetchIDs.slice(0, 50); 
            var requestUrl = url_template.replace("{IDs}", APIFetchIDs.join(','));

            console.log("API Request (" + APIFetchIDs.length + " videos) - " + (totalIDsToDo-APIFetchIDs.length) + " videos remaining!");

            var xhr = new XMLHttpRequest();
            xhr.onreadystatechange = function ()
            {
                if (xhr.readyState === 4)
                { 
                    var data = JSON.parse(xhr.responseText);

                    if(data.kind == "youtube#videoListResponse")
                    {
                        API_KEY_VALID = true;

                        data = data.items;

                        if (mainVidID != "")
                        { 
                            var videoDescription = data[0].snippet.description;
                            var pageDescription = document.getElementsByClassName("content style-scope ytd-video-secondary-info-renderer");
                            if (pageDescription.length > 0 && videoDescription !== undefined && pageDescription[0] !== undefined) {

                                pageDescription[0].innerHTML = linkify(videoDescription);
                                console.log ("Reverting main video description!");
                            } else {
                                console.log ("ERROR: Failed to find main video description! Skipping!", videoDescription, pageDescription);
                            }
                            changedDescription = true;
                        }

                        data = data.forEach( v => {
                            cachedTitles[v.id] = v.snippet.title;
                        } );

                        for(var i=0 ; i < videoIDElements.length ; i++){
                            var vidElement = videoIDElements[i];
                            var curID = getVideoID(vidElement);
                            if (curID !== IDs[i]) {
                                console.log ("WARNING: YouTube replaced content while loading attempt has been made! Retrying in a second!");
                                changedDescription = false;
                                setTimeout(changeTitles, 1000);
                                return;
                            }
                            if (cachedTitles[curID] !== undefined)
                            {
                                var originalTitle = cachedTitles[curID];
                                var pageTitle = vidElement.innerText.trim();
                                if(pageTitle != originalTitle.replace(/\s{2,}/g, ' '))
                                {
                                    console.log ("-- '" + curID + "': '" + pageTitle + "' --> '" + originalTitle + "'");
                                    vidElement.innerText = originalTitle;
                                }
                                alreadyChanged.push(vidElement);
                            }
                            else if (APIFetchIDs.includes(curID))
                            {
                                cachedTitles[curID] = vidElement.innerText.trim();
                                alreadyChanged.push(vidElement);
                                console.log ("-- '" + curID + "': private or deleted!");
                            }
                        }
                        changeTitles();
                    }
                    else
                    {
                        console.log("ERROR: API Request Failed!");
                        console.log(requestUrl);
                        console.log(data);

                        NO_API_KEY = !API_KEY_VALID;
                        if (NO_API_KEY) {
                            GM_setValue('api_key', '');
                            console.log("ERROR: API Key Fail! Please Reload!");
                        }
                    }
                }
            };
            xhr.open('GET', requestUrl);
            xhr.send();
        } else if (recheckTimer == -1) {

            recheckTimer = setInterval(changeTitles, 1000);
        }
    }

    function linkify(inputText) {
        var replacedText, replacePattern1, replacePattern2, replacePattern3, replacePattern4;

        replacePattern1 = /(\b(https?|ftp):\/\/[-A-Z0-9+&@#\/%?=~_|!:,.;]*[-A-Z0-9+&@#\/%=~_|])/gim;
        replacedText = inputText.replace(replacePattern1, '<a class="yt-simple-endpoint style-scope yt-formatted-string" spellcheck="false" href="$1">$1</a>');

        replacePattern2 = /(^|[^\/])(www\.[\S]+(\b|$))/gim;
        replacedText = replacedText.replace(replacePattern2, '<a class="yt-simple-endpoint style-scope yt-formatted-string" spellcheck="false" href="http://$1">$1</a>');

        replacePattern3 = /(([a-zA-Z0-9\-\_\.])+@[a-zA-Z\_]+?(\.[a-zA-Z]{2,6})+)/gim;
        replacedText = replacedText.replace(replacePattern3, '<a class="yt-simple-endpoint style-scope yt-formatted-string" spellcheck="false" href="mailto:$1">$1</a>');

        replacePattern4 = /([0-9]+:)?([0-9]+):([0-9]+)/gim;
        replacedText = replacedText.replace(replacePattern4, function(match) {

            var timeChars = match.split(':'); 
            var time = parseInt(timeChars[0], 10) * 60 + parseInt(timeChars[1], 10); 
            if (timeChars.length >= 3)
            { 
                time = time * 60 + parseInt(timeChars[2], 10);
            }

            var url = window.location.href; 
            url = url.slice (url.indexOf("/watch?"), url.length); 
            url = url.replace(/[?&]t=([0-9]+)s/, ""); 
            url = url + "&t=" + time + "s";

            return '<a class="yt-simple-endpoint style-scope yt-formatted-string" spellcheck="false" href="' + url + '">' + match + '</a>';
        });

        return replacedText;
    }

    changeTitles();
})();

This code is a userscript designed to remove auto-translations of YouTube video titles and restore them to their original titles. Here is a breakdown of its functionality:

Primary Purpose

The userscript ensures that:

YouTube video titles, which may have been localized or automatically translated based on the user's language settings, are reverted to their original, untranslated titles.
Additionally, if viewing a specific video, its description is also restored to its original state.

Key Functionalities

Prompt for YouTube Data API Key:
- The script prompts the user to enter a YouTube Data API key, which it uses to fetch the original titles and descriptions through the YouTube API.
- If no valid API key is provided, certain features requiring the API will not work.
Monitoring Page Changes:
- The script tracks whether the webpage's URL or video changes (e.g., navigating from one video to another or scrolling to see recommended videos). When a change is detected, it resets state and processes new content.
Restoration of Titles for Videos on the Page:
- For all video links (like recommended videos, search results, etc.), the script:
  - Extracts video IDs from their URLs.
  - Fetches their original titles using the YouTube API (unless they are cached).
  - Replaces the auto-translated or localized titles with their original titles.
Restoration of the Main Video Description:
- If viewing a specific video, it uses the YouTube API to fetch the original video description and updates the page to display the unaltered description, replacing any localized/auto-translated text.
Caching Titles:
- The script retains a cache (cachedTitles) of original titles from prior API calls, minimizing API requests and improving performance.
Error Handling:
- It retries operations if content changes dynamically (e.g., lazy-loaded content or re-rendering by YouTube).
- If the API key is invalid, it prompts the user to re-enter it.
Linkify Functionality:
- The script adds clickable links to URLs, email addresses, or timecodes found in video descriptions. For example:
  - Timecodes (e.g., 2:15) are converted into clickable timestamps, allowing users to jump to those times in the current video.

How it Works

Initialization:
- The script is injected into YouTube (@match https://www.youtube.com/*).
- It ensures strict mode ('use strict';) for better performance and error detection.
- It checks if a YouTube Data API key is stored. If not, it prompts the user to enter one.
API Requests:
- A base API URL template (url_template) is prepared, which is used to fetch video details in bulk (up to 50 video IDs at a time) using the provided API key.
Dynamic Handling of Page Content:
- The script continuously checks the page title, URL, and video elements.
- Based on the detected content, it updates the titles and description via DOM manipulation.
Rechecking:
- It sets timers to periodically recheck and update titles/descriptions if new content is dynamically loaded.

Specific Code Components

getVideoID:
- This function extracts the video ID (11-character unique identifier) from a given video link.
resetChanged:
- Resets the script's state when a page or video change is detected.
changeTitles:
- Core function that:
  - Fetches original titles/descriptions.
  - Replaces translated titles/descriptions with their authentic versions.
linkify:
- Converts URLs, email addresses, and timecodes in video descriptions into clickable links.

Dependencies

GM_getValue and GM_setValue are used to store the API key locally (features of Greasemonkey/Tampermonkey browser extensions).
XMLHttpRequest for making API requests to the YouTube Data API.

Limitations

Requires a valid YouTube Data API key to fetch original data.
Restricted to 50 videos per API call.
May not account for edge cases (e.g., private or deleted videos).

Outcome

The script dynamically monitors YouTube and reverts video titles and descriptions to their original, untranslated state for improved accuracy.

Generate your own explanations

Download our vscode extension

Read other generated explanations

Built by @thebuilderjr

This code is a **userscript** designed to remove auto-translations of...