🐸 Read Frog - Open Source Immersive Translate | 🐸 陪读蛙 - 开源沉浸式翻译 https://readfrog.app
  • TypeScript 99.3%
  • CSS 0.4%
  • JavaScript 0.2%
Find a file
ananaBMaster ee313e923b
docs: update claude md (#985)
* docs: update claude md

* fix: comment pr
2026-02-20 10:53:03 -08:00
.agents/skills ai: add composition skills 2026-01-27 15:08:08 -08:00
.changeset refactor: remove read provider and unify per-feature provider model (#982) 2026-02-20 02:01:38 -08:00
.claude ai: add composition skills 2026-01-27 15:08:08 -08:00
.codex/skills ai: add composition skills 2026-01-27 15:08:08 -08:00
.cursor ai: add composition skills 2026-01-27 15:08:08 -08:00
.github docs: update claude md (#985) 2026-02-20 10:53:03 -08:00
.husky refactor(ui): translation-hub (#912) 2026-01-24 11:22:05 -08:00
.vscode fix: skip empty nodes in translation traversal to fix Inoreader style issue (#723) 2025-11-21 20:48:41 -08:00
assets docs(readme): refine 2025 recap 2025-12-25 16:14:54 -08:00
public/icon refactor: turborepo setup (#137) 2025-06-10 02:53:07 -07:00
scripts/debug refactor: turborepo setup (#137) 2025-06-10 02:53:07 -07:00
src refactor: remove read provider and unify per-feature provider model (#982) 2026-02-20 02:01:38 -08:00
.gitignore refactor: remove read provider and unify per-feature provider model (#982) 2026-02-20 02:01:38 -08:00
.lintstagedrc.json refactor: replace @repo to @lib make some packages to private (#708) 2025-11-16 12:46:12 +08:00
CHANGELOG.md chore(release): version packages (#952) 2026-02-07 17:23:50 -08:00
CLAUDE.md docs: update claude md (#985) 2026-02-20 10:53:03 -08:00
commitlint.config.cjs refactor: replace @repo to @lib make some packages to private (#708) 2025-11-16 12:46:12 +08:00
components.json refactor(ui): consolidate UI components under src/components/ui/ (#943) 2026-02-05 22:21:03 -08:00
eslint.config.mjs fix(selection): route stream requests through background to bypass CORS (#954) 2026-02-08 00:26:42 -08:00
LICENSE Add GNU GPL v3 License 2026-01-01 21:24:46 -08:00
nx.json refactor: default prompt not stored in storage (#727) 2025-11-23 16:42:50 -08:00
package.json fix(selection): route stream requests through background to bypass CORS (#954) 2026-02-08 00:26:42 -08:00
pnpm-lock.yaml fix(selection): route stream requests through background to bypass CORS (#954) 2026-02-08 00:26:42 -08:00
postcss.config.cjs refactor: migrate from @read-frog/ui package to internal @/ui (#713) 2025-11-18 21:11:27 -08:00
README.md docs: update readme 2025-12-28 15:38:41 -08:00
README.zh-CN.md docs: update readme 2025-12-28 15:38:41 -08:00
tsconfig.json refactor(ui): migrate shadcn components to base-ui (#932) 2026-02-01 19:33:37 -08:00
vitest.config.ts feat: improve Google Drive sync with conflict resolution and comprehensive testing (#780) 2025-12-09 17:38:13 -08:00
vitest.setup.ts feat: improve Google Drive sync with conflict resolution and comprehensive testing (#780) 2025-12-09 17:38:13 -08:00
wxt.config.ts refactor(ui): migrate shadcn components to base-ui (#932) 2026-02-01 19:33:37 -08:00

An open-source AI-powered language learning extension for browsers.
Supports immersive translation, article analysis, multiple AI models, and more.
Master languages effortlessly and deeply with AI, right in your browser.

English · 简体中文 · Official Website · Tutorial · Changelog · Blog




2025 Recap

Table of contents

TOC


📺 Demo

Read Frog

Read Frog Popup Interface Read Frog Translation Interface

👋🏻 Getting Started & Join Our Community

Read Frog's vision is to provide an easy-to-use, intelligent, and personalized language learning experience for language learners of all levels. This has become possible in the AI era, but there are few products on the market that meet this demand. Therefore, we decided to take matters into our own hands and ultimately make the world no longer reliant on human language instructors.

Whether you are a user or a developer, Read Frog will be an important part of your journey toward this vision. Please be aware that Read Frog is currently under active development, and feedback is welcome for any issues encountered.

Download

Browser Version Download
Chrome Chrome Web Store or 中国镜像
Edge Microsoft Edge Addons

Community

In Discord ask questions, and connect with developers.
If you are in mainland China, you can add the WeChat account to join the WeChat group.

[!IMPORTANT]

Star Us, You will receive all release notifications from GitHub without any delay ~

Star History Star History Chart

Features

Transform your everyday web reading into an immersive language learning journey with Read Frog's powerful features.

🔄 Bilingual / Translation Only

Switch seamlessly between two translation display modes. Bilingual mode shows the original text alongside its translation, perfect for learning and comparison. Translation-only mode replaces the original text entirely for a cleaner reading experience.

The extension automatically re-translates all visible content when you switch modes while translation is active, ensuring a smooth transition without needing to refresh the page.

🧠 Context-Aware Translation

Enable AI to understand the full context of what you're reading. When activated, Read Frog uses Mozilla's Readability library to extract the article's title and content, providing this context to the AI for more accurate, contextually-appropriate translations.

This means technical terms get translated correctly within their domain, literary expressions maintain their nuance, and ambiguous phrases are interpreted based on the surrounding content rather than in isolation.

Selection Translation

Select any text on a webpage to reveal a smart toolbar with powerful options. Translate streams the translation in real-time. Explain provides detailed explanations tailored to your language level. Speak reads the text aloud using text-to-speech.

The toolbar intelligently positions itself to stay within the viewport, supports drag interactions, and works across all websites. Perfect for quick lookups while reading.

📝 Custom Prompts

Define your own translation prompts to translate like an expert. Create domain-specific prompts for technical documents, literary works, or casual content. Use tokens like [TARGET_LANG], [INPUT], [TITLE], and [SUMMARY] to build dynamic, context-aware prompts.

Save multiple prompt patterns and switch between them based on what you're reading. Your prompts, your rules.

📦 Batch Requests

Save up to 70% on API costs with intelligent request batching. Read Frog groups multiple translation requests into single API calls, reducing overhead and token usage while maintaining translation quality.

The system includes smart retry logic with exponential backoff and automatic fallback to individual requests if batch processing fails. All handled transparently in the background.

🤖 20+ AI Providers

Connect to 20+ AI providers through Vercel AI SDK: OpenAI, DeepSeek, Anthropic Claude, Google Gemini, xAI Grok, Groq, Mistral, Ollama, and many more. Configure custom endpoints, API keys, and model settings for each provider.

Plus free translation options: Google Translate, Microsoft Translate, and DeepLX for cost-free basic translations.

🎬 Subtitle Translation (Beta)

Translate YouTube subtitles directly in the video player. Watch foreign language content with translations displayed alongside the original subtitles, making video content accessible for language learning.

🔊 Text-to-Speech (TTS)

Listen to any selected text with high-quality AI voices. Powered by OpenAI's TTS models, choose from multiple voices (Alloy, Ash, Coral, Echo, and more) and adjust playback speed from 0.25x to 4x.

Smart sentence-aware chunking handles long text by splitting at natural boundaries and prefetching the next chunk for seamless playback. Perfect for pronunciation practice and auditory learning.

📖 Read Article

One-click deep article analysis. Read Frog extracts the main content using Mozilla's Readability, detects the source language, and generates a summary and introduction in your target language.

Then it provides sentence-by-sentence translations with vocabulary explanations tailored to your language level (beginner, intermediate, or advanced). Each sentence includes key word definitions, grammatical analysis, and contextual explanations. It's like having a personal language tutor analyze every article you read.

🤝 Contribute

Contributions of all types are more than welcome.

  1. Promote Read Frog to your friends and family.
  2. Report issues and feedback.
  3. Contribute code.

Contribute Code

Project Structure: DeepWiki

Ask AI to understand the project: Dosu

Check out the Contribution Guide for more details.




❤️ Sponsors

Every donation helps us build a better language learning experience. Thank you for supporting our mission!