explaingit

filipeps/traduzir-paginas-web

5,771JavaScriptAudience · generalComplexity · 1/5Setup · easy

TLDR

A Firefox browser extension that translates entire web pages in real time using Google, Bing, or Yandex without opening a new tab, and works on both desktop and Android Firefox.

Mindmap

mindmap
  root((traduzir-paginas-web))
    What it does
      Real-time translation
      No new tab needed
      Auto-translate option
    Translation Engines
      Google Translate
      Bing Translate
      Yandex Translate
    Platforms
      Firefox desktop
      Firefox Android
    Use Cases
      Read foreign pages
      Auto-translate sites
      Build and test locally
    Privacy
      No data collected
      Text sent to providers
Click or tap to explore — scroll the page freely

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

Things people build with this

USE CASE 1

Translate a foreign-language documentation page to your native language without leaving the browser tab.

USE CASE 2

Set Firefox on Android to automatically translate pages written in a specific language whenever you visit them.

USE CASE 3

Contribute a new interface language to the extension by joining the Crowdin translation project.

USE CASE 4

Compile the extension from source and test a custom modification in Firefox as a temporary add-on.

Tech stack

JavaScriptFirefox Extension API

Getting it running

Difficulty · easy Time to first run · 5min

In plain English

Translate Web Pages (also known as TWP) is a browser extension for Firefox that translates the content of any web page in real time without opening a new tab. It uses Google, Bing, or Yandex translation services, and you can switch between them by clicking the translation engine icon in the extension menu. The extension works on Firefox desktop and Firefox for Android. On desktop you install it from the Mozilla Add-ons website. On Android you need Firefox version 120 or later, then search for "TWP - Translate For Mobile" in the add-ons section. For Chrome, Edge, and Brave, the README notes that an official release for those browsers is planned for the future, and any previous workarounds involving registry modifications are no longer supported. Once installed, you can choose to translate the current page on demand or set the extension to translate automatically whenever you visit a page in a specific language. You can change the target language from the extension menu at any time. The FAQ explains that the extension needs permission to read and modify page content on all websites because that access is required to perform translations. Regarding privacy, the extension itself does not collect any user data. However, the text of the pages you translate is sent to Google or Yandex servers, which provide the actual translation. The extension cannot translate certain browser-restricted pages like the Firefox add-ons site itself. Contributions to the extension's interface translations are managed through a Crowdin project. The repository also includes build instructions for developers who want to compile the extension from source.

Copy-paste prompts

Prompt 1
I want to build a Firefox extension that translates web pages. Show me how traduzir-paginas-web injects translated content into the DOM and swaps out the original text nodes.
Prompt 2
Walk me through compiling traduzir-paginas-web from source and loading it as a temporary extension in Firefox for local testing.
Prompt 3
I want to add a new translation engine to traduzir-paginas-web. Show me the pattern the existing code uses to call Google and Yandex so I can add a new provider in the same style.
Prompt 4
How does traduzir-paginas-web use the broad host-permission to read and modify page content, and what is the minimal permission set needed for a translation extension?
Open on GitHub → Explain another repo

← filipeps on gitmyhub — every repo by this author, as a profile.

Verify against the repo before relying on details.