read-frog README

The project's README from github.com/mengxi-ream/read-frog. As one markdown file: README.md.

Read Frog banner

mengxi-ream%2Fread-frog | Trendshift Star History Rank

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 简体中文 繁體中文 日本語 한국어 Español Русский Türkçe Tiếng Việt

Official Website · Tutorial · Changelog · Blog

Latest Version badge Chrome Version badge Edge Version badge Firefox Version badge
Discord badge Chrome Users badge Edge Users badge Firefox Users badge
Stars badge Contributors badge Last Commit badge Issues badge
Sponsor badge

Table of contents

TOC


📺 Demo

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 Version badge Chrome Web Store or 中国镜像
Edge Edge Version badge Microsoft Edge Addons
Firefox Firefox Version badge Firefox Add-ons

Community

Discord badge In Discord ask questions, and connect with developers.
WeChat badge 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 Read Frog on GitHub

Star History Star History Chart

Back to top

✨ Features

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

🪄 Custom AI Actions

Turn selected text into reusable AI tools that match the way you read and learn. Define your own prompts and structured output fields, choose a provider, model, and icon, then run the action directly from the selection toolbar for dictionary lookups, rewriting, summaries, explanations, or any workflow you design.

Start with the built-in Dictionary and Improve Writing templates, or build an action from scratch. Structured results can also be mapped and saved to Notebase for later study.

Back to top

🧠 Flashcards & Spaced Repetition

Save vocabulary, definitions, example sentences, translations, and reading notes to Notebase, then turn them into flashcards with customizable card templates. Content you discover while reading becomes study material without interrupting your flow.

Review due cards online and rate each one Again, Hard, Good, or Easy. Read Frog's spaced-repetition scheduler uses your feedback to decide when each card should appear again—right before you are likely to forget it.

Back to top

🔄 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.

Back to top

✨ 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.

Back to top

🧠 Context-Aware Translation

Enable AI to understand the full context of what you're reading. When activated, Read Frog extracts the page title and a concise Markdown version of the page 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.

Back to top

🎬 Subtitle Translation

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.

Back to top

🔊 Text-to-Speech (TTS)

Listen to any selected text with high-quality AI voices. Powered by Edge TTS — completely free, with 150+ voices across 80+ languages including Chinese, English, Japanese, Korean, and many more. Adjust rate, pitch, and volume to your preference.

Automatic language detection (basic or LLM-powered) with per-language voice mapping ensures the right voice for every language. 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.

Back to top

📦 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.

Back to top

🤖 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.

Back to top

🤝 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.

ReadFrog is dual-licensed under GPLv3 and a commercial license.

See CONTRIBUTING.md for contributor licensing terms.


Read Frog contributors

Back to top

📜 Commercial License Grant

Tabbit Meituan Tabbit Browser Team: Free license (at no cost) for closed-source commercial use, limited to v1.21.3 and earlier versions (commit 724863f). Granted on March 3, 2026, 9:00 AM (Vancouver Time, UTC-8).

Back to top

❤️ Sponsors

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

Sponsors

Back to top

read-frog (mengxi-ream/read-frog)

Searching Database…

10.1K ·GitHub
这是什么?Read Frog 是一款开源浏览器扩展,在你浏览网页时提供 AI 翻译和语言学习功能:它可以翻译网页、文章字幕和选中文本,并把阅读内容变成学习用的闪卡。
这是独立应用,还是浏览器扩展?它是一款浏览器扩展,支持 Chrome、Edge 和 Firefox,不是桌面或移动应用。
怎么让它跑起来?从 Chrome 网上应用店、Microsoft Edge 加载项或 Firefox 附加组件商店安装(Chrome 也有国内镜像),然后在扩展设置中配置一个 AI 提供商。
使用它需要 AI 提供商的 API 密钥吗?你需要使用自己的 API 密钥,连接 20 多家受支持的 AI 提供商中的至少一家(OpenAI、DeepSeek、Anthropic Claude、Google Gemini、Grok、Groq、Mistral、Ollama 等);不过 Google 翻译、微软翻译和 DeepLX 等免费选项无需密钥也可使用。
它完全免费吗,还是许可方面有什么限制?扩展本身可以免费使用,但代码库采用 GPLv3 和商业许可双重授权,仅有一个指名团队可就旧版本获得特殊的免费闭源商业授权。
它是为谁打造的?面向想在阅读真实网页内容的同时学习语言的人,翻译支持主要围绕英语、日语和中文等语言。
它支持哪些浏览器?Chrome、Microsoft Edge 和 Firefox。
Notebase 是什么?Notebase 是内置的学习区,你浏览时保存的词汇、释义、例句和阅读笔记都存放在这里,并会变成闪卡,供间隔重复复习使用。
可以用它翻译 YouTube 视频吗?可以。Read Frog 能直接在视频播放器中翻译 YouTube 字幕,在原始字幕旁显示译文。
它支持文字转语音吗?支持。它内置由 Edge TTS 驱动的免费 TTS,提供 80 多种语言的 150 多个音色,支持自动检测语言,并可调节语速、音调和音量。
批量翻译是如何节省 API 成本的?Read Frog 会把多个翻译请求合并成单次 API 调用,在保证质量的同时最多可节省 70% 的 API 成本;如果某一批次失败,还会自动重试和回退。
Size
97.2 MB
Stars
10.1K
Age
1y
Commits · 90 Days