git404hub

what is openread fr?

uxgnod/openread — explained in plain English

Analysis updated 2026-05-18

1TypeScriptAudience · generalComplexity · 2/5LicenseSetup · moderate

tl;dr

A bring-your-own-key browser extension that translates web pages in place using your own OpenAI-compatible AI provider.

vibe map

mindmap
  root((OpenRead))
    What it does
      Bilingual page translation
      In-place reading
      Bring your own key
    Tech stack
      TypeScript
      Chrome MV3
      pnpm
    Use cases
      Read foreign articles
      Selection translation
      Site specific rules
    Audience
      General readers
      Multilingual users

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

what do people make with this?

VIBE 1

Read foreign-language articles, documentation, or GitHub READMEs with a bilingual side-by-side translation.

VIBE 2

Connect your own OpenAI-compatible API key instead of paying for a bundled translation subscription.

VIBE 3

Right-click any selected text on a page to get a quick floating translation.

VIBE 4

Create Site Rules to reliably translate specific regions of tricky or complex web pages.

what's the stack?

TypeScriptChrome ExtensionManifest V3

how it stacks up fr

uxgnod/openread0xkinno/neuralvault0xmayurrr/ai-contractauditor
Stars111
LanguageTypeScriptTypeScriptTypeScript
Setup difficultymoderatehardeasy
Complexity2/54/52/5
Audiencegeneraldeveloperdeveloper

Figures from each repo's GitHub metadata at analysis time.

how do i run it?

Difficulty · moderate time til it works · 30min

Requires your own OpenAI-compatible API key, not yet available on the Chrome Web Store.

Use freely for any purpose, including commercial use, as long as you keep the copyright notice and state changes.

in plain english

OpenRead is a browser extension for reading web pages written in a foreign language. It translates the page in place, keeping the original layout and text visible alongside the translation, similar in spirit to the popular Immersive Translate extension. The key difference is that OpenRead does not come bundled with its own translation subscription. Instead you connect your own AI provider account, using any service compatible with the OpenAI chat completions format, and pay that provider directly for translation requests rather than paying OpenRead. It is built as a Chrome extension using the newer Manifest V3 format, and is aimed at careful reading of articles, documentation, technical posts, GitHub project pages, and newsletter style essays where preserving the page's original structure matters. You can switch between viewing the original text, the translation only, or both side by side, and translation happens gradually as you scroll rather than all at once, so the page stays responsive. You can also right click selected text to get a translation in a small draggable popup, or translate what you type into text boxes. For pages that need special handling, OpenRead supports what it calls Site Rules, saved instructions in a structured file format that tell the extension exactly which parts of a specific page or website should be translated, which is meant to handle tricky page layouts more reliably than a generic approach. The project is still described as early developer-mode software, meaning some complex pages may not translate cleanly yet. To install it today you download a release file from GitHub and load it manually into Chrome's developer mode, since it is not yet available through the Chrome Web Store. To build it from source, you need Node.js and the pnpm package manager, then run pnpm install and pnpm dev. Your API key and settings are stored only in your browser's local storage and are never sent to OpenRead's own servers, only to whichever AI provider you configure. The project is licensed under Apache 2.0, a permissive license that allows free use including commercial use.

prompts (copy fr)

prompt 1
Help me install OpenRead's GitHub release build into Chrome's developer mode.
prompt 2
Walk me through configuring OpenRead with my own OpenAI-compatible API key and base URL.
prompt 3
Explain how OpenRead's Site Rules decide which parts of a page get translated.
prompt 4
Show me how to build OpenRead from source using pnpm and load the extension for testing.

Frequently asked questions

what is openread fr?

A bring-your-own-key browser extension that translates web pages in place using your own OpenAI-compatible AI provider.

What language is openread written in?

Mainly TypeScript. The stack also includes TypeScript, Chrome Extension, Manifest V3.

What license does openread use?

Use freely for any purpose, including commercial use, as long as you keep the copyright notice and state changes.

How hard is openread to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is openread for?

Mainly general.

peek the repo → explain another one

This repo across BitVibe Labs

double-check against the repo, no cap.