explaingit

inmetx/omniread-v2.2

Analysis updated 2026-05-18

1JavaScriptAudience · generalComplexity · 2/5LicenseSetup · easy

TLDR

A Chrome extension that translates web pages offline using Gemini Nano or any OpenAI-compatible API, with bilingual side-by-side view and phrase-level popup translation.

Mindmap

mindmap
  root((OmniRead))
    Translation modes
      Full page replace
      Side by side bilingual
      Word popup on selection
    Engines
      Offline Gemini Nano
      OpenAI compatible API
      Local Ollama model
    Features
      7 day cache
      Dynamic page support
      Cancel in flight requests
      Keyboard shortcut
    Languages
      Chinese
      English
      Japanese
      Korean
    Setup
      No build tools
      Load unpacked in Chrome
      Optional API key
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

What do people build with it?

USE CASE 1

Translate a Chinese or Japanese tech documentation page into English in bilingual view to read the original and translation together.

USE CASE 2

Select a single sentence on a foreign-language webpage, right-click, and get an instant translation popup without translating the whole page.

USE CASE 3

Connect your DeepSeek or local Ollama model as the translation engine for faster results on sites you visit regularly.

What is it built with?

JavaScriptChrome ExtensionGemini NanoManifest V3

How does it compare?

inmetx/omniread-v2.2acip/slack-claude-agentalexanderdaly/neurofhe-relay
Stars111
LanguageJavaScriptJavaScriptJavaScript
Setup difficultyeasymoderateeasy
Complexity2/53/52/5
Audiencegeneraldeveloperresearcher

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

How do you get it running?

Difficulty · easy Time to first run · 5min

Not on the Chrome Web Store, install by enabling developer mode in Chrome and loading the folder as an unpacked extension.

No open-source license, intended for personal use and private sharing only, all rights reserved.

In plain English

OmniRead is a Chrome browser extension that translates web pages into your preferred language. It can show a bilingual view where the original text and translation appear side by side, or it can replace the original text entirely. You can also select any word or phrase on a page, right-click, and see a translation in a small floating popup. The extension supports two translation engines. The default is Gemini Nano, a model built directly into Chrome, which works completely offline without sending any text to external servers. If you prefer faster or more accurate results, you can connect any OpenAI-compatible API service, such as DeepSeek, ChatGPT, or a locally running Ollama model, by entering your API key in the settings. Translations are cached for seven days, so pages you have already translated load instantly on a second visit without calling the translation engine again. The extension also handles pages that update dynamically, such as social media feeds, detecting and translating new content as it appears. Stopping a translation mid-page cancels in-progress requests immediately to avoid wasting API usage. The project is written in plain JavaScript with no external frameworks and no build tools. You install it in Chrome by enabling developer mode and loading the folder directly. It is not listed in the Chrome Web Store. The source code includes 109 automated tests covering the cache, translation logic, and utility functions. According to the README, the project is intended for personal use and private sharing. It does not include an open-source license. The README is written primarily in Chinese.

Copy-paste prompts

Prompt 1
I installed OmniRead as an unpacked Chrome extension. Walk me through connecting my DeepSeek API key so I can use it instead of the offline Gemini Nano engine.
Prompt 2
OmniRead is showing translations misaligned with the original text on a page that uses 'show more' buttons. How does the single-sentence translation mode fix this and how do I enable it?
Prompt 3
Explain how OmniRead's LRU cache works and how I can clear cached translations for a specific site.
Prompt 4
I want to contribute to OmniRead. Walk me through running the 109 unit tests using Node 18's built-in test runner.
Prompt 5
Set up OmniRead to translate Twitter and other dynamic social media feeds. Explain the SPA detection mechanism it uses.

Frequently asked questions

What is omniread-v2.2?

A Chrome extension that translates web pages offline using Gemini Nano or any OpenAI-compatible API, with bilingual side-by-side view and phrase-level popup translation.

What language is omniread-v2.2 written in?

Mainly JavaScript. The stack also includes JavaScript, Chrome Extension, Gemini Nano.

What license does omniread-v2.2 use?

No open-source license, intended for personal use and private sharing only, all rights reserved.

How hard is omniread-v2.2 to set up?

Setup difficulty is rated easy, with roughly 5min to a first successful run.

Who is omniread-v2.2 for?

Mainly general.

Open on GitHub → Explain another repo

This repo across BitVibe Labs

Scan in gitsafehub Deploy in gitdeployhub inmetx on gitmyhub

Verify against the repo before relying on details.