Thanks to visit codestin.com
Credit goes to github.com

Skip to content

Repository files navigation

FluentRead

FluentRead

An open-source browser extension for bilingual translation.

Install · Website · User guide · 简体中文 · LINUX DO Community · GPL-3.0

FluentRead displays translations alongside the original webpage and provides selection translation, AI reading assistance, image and document translation, and bilingual video subtitles. Its reading card integrates a browser adaptation of the DeepSeek Harness session core for contextual explanations and follow-up questions.

FluentRead bilingual webpage translation

Features

Feature Description
Webpage translation Bilingual page translation, hover and selection translation, original-text restoration, and automatic translation rules.
AI reading card Meaning, sentence analysis, usage explanations, and practice, with paragraph context and follow-up questions.
Learning center Save words, phrases, and sentences with their original context for study and review.
Image and area translation Recognize text in webpage images or selected screen areas and display translations that can be copied.
Document translation Read PDF, ePub, DOCX, and other supported formats in two languages, edit translations, and export files.
Video subtitles Bilingual subtitles on YouTube and X; supported X videos can also use local AI transcription.
Services and settings Free translation services, DeepL, AI providers, and local Ollama models, with glossaries, translation styles, shortcuts, and menu layout settings.

See the user guide for instructions and supported formats. AI explanations require a configured AI service. Third-party pricing and availability depend on the provider.

DeepSeek Harness

The reading card adapts the conversation-event and message organization components of the DeepSeek Harness session core for the browser. FluentRead connects these to the selected text, permitted paragraph context, model services, and local reading history. It supports different AI providers and models, with optional learning memories.

The adaptation is used for selection-based reading assistance. Full-page, hover, and regular selection translation use their respective translation pipelines. See the integration map for scope and upstream references, and the third-party notice for its MIT license.

Reading card guide

Installation

Chrome · Edge · Firefox · Userscript

  1. Install the extension and refresh the webpage.
  2. Open FluentRead and select a target language. The source language defaults to automatic detection and can also be selected manually.
  3. Choose “Translate page.” Enable selection translation and other tools in settings as needed.

Store updates may arrive at different times. The userscript provides core webpage translation features. See the installation guide for browser and feature availability.

Local development

Requirements: Node.js 20 or later and pnpm 9.

pnpm install --frozen-lockfile
pnpm dev

Use pnpm build to build the Chrome extension, pnpm compile for type checking, and pnpm docs:build to build the website. See architecture and testing for project conventions.

Contributing

Report bugs and propose changes through Issues. Pull requests for code, documentation, interface translations, and website adaptation are welcome.

Product descriptions and Chinese and English store images are maintained in the separate press and store kit.

Support

FluentRead is an open-source project whose continued development is made possible by the generous support of its community. Voluntary contributions are welcome through either service.

WeChat SupportKo-fi · International
Thinkstu’s WeChat support code
Scan with WeChat. Click the image to enlarge.
Support thinkstu on Ko-fi ↗

ko-fi.com/thinkstu

License and privacy

FluentRead is released under GPL-3.0. See third-party notices for component attribution and licenses.

Cloud translation sends relevant text to the selected provider. See data and privacy for file parsing, image recognition, and local model behavior.

About

An open-source browser extension for bilingual translation. 一款开源的浏览器双语翻译插件。

Resources

Stars

8.1k stars

Watchers

25 watching

Forks

Releases

Packages

Used by

Contributors

Languages