Skip to content

cppakko/cluelens

Repository files navigation

ClueLens logo

ClueLens

A browser dictionary and translation extension with 18 lookup sources, automatic language detection, TTS pronunciation, vocabulary collection, and flexible panel layouts.

Version Platform License

English | 中文

Features

  • 18 Lookup Sources: Query 13 dictionaries, 4 translators, and 1 AI source in parallel from a single panel.
  • Automatic Language Detection: Detect Chinese, Japanese, Korean, English, French, Spanish, and German to skip incompatible sources automatically.
  • Pronunciation and TTS: Play source audio directly or use Web Speech API and Lingva with optional preload and auto-play.
  • Flexible Surfaces: Use ClueLens as an inline floating panel, browser popup, or dedicated side panel, with context-menu and keyboard shortcut support.
  • Vocabulary Book: Save words while browsing, search them later, reopen lookups, and export them as JSON or CSV.
  • Material Design 3 Theming: Customize seed color, dark mode, hue, chroma, tone, and fonts, including Google Fonts and the SJTU mirror.
  • Backup and Restore: Export or import settings, enabled source order, vocabulary, and supported per-source configs as JSON.

Preview

ClueLens preview

ClueLens screenshot

Supported Sources

Dictionaries

  • Bing Dictionary
  • Cambridge Dictionary
  • DictionaryAPI
  • DWDS
  • Green's Dictionary of Slang
  • Jisho
  • Larousse
  • Moegirl
  • Open Multilingual Wordnet
  • SpanishDict
  • Urban Dictionary
  • Wiktionary
  • Zdic

Translators

  • Bing Translate
  • Caiyun Translate
  • DeepLx
  • Google Translate

AI-Assisted

  • OpenAI with compatible APIs and local models

Most web-backed sources also expose an open-source-page action directly from the result card. The main exceptions are DictionaryAPI, Caiyun Translate, DeepLx, and OpenAI.

Install From Stores

Install from Releases

Download the latest build from the Releases page.

Chrome/Chromium Browsers

  1. Download and extract cluelens-xxx-chrome.zip
  2. Open chrome://extensions or edge://extensions
  3. Turn on Developer mode
  4. Click Load unpacked
  5. Choose the extracted folder

Firefox

  1. Download and extract cluelens-xxx-firefox.zip
  2. Open about:debugging#/runtime/this-firefox
  3. Click Load Temporary Add-on
  4. Select the manifest file in the extracted folder

Local Build

Requirements

  • Node.js 18+
  • Yarn 1.x

Install

yarn install

Optional environment variables

Create a .env file if you want to provide a default Caiyun token:

VITE_CAIYUN_DEFAULT_TOKEN=your-caiyun-token

Run in development

yarn dev

For Firefox:

yarn dev:firefox

Build locally

yarn build

About

ClueLens is a browser extension for instant word lookup, sentence translation, and multi-source dictionary search across web pages.

Topics

Resources

License

Stars

Watchers

Forks

Packages

 
 
 

Contributors