Data

Tools

Indexes

Applications

Experiments

Awesome

An open API service indexing awesome lists of open source software.

https://github.com/mengxi-ream/read-frog

🐸 Read Frog - Open Source Immersive Translate | 🐸 陪读蛙 - 开源沉浸式翻译
https://github.com/mengxi-ream/read-frog

browser-extension chinese chrome-extension deepseek english english-learning gpt immersive-translate japanese language-learning llm openai react translate wxt

Last synced: 24 days ago
JSON representation

🐸 Read Frog - Open Source Immersive Translate | 🐸 陪读蛙 - 开源沉浸式翻译

Awesome Lists containing this project

README 

          





[![Read Frog banner][image-banner]][website]



mengxi-ream%2Fread-frog | Trendshift



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** · [简体中文](./README.zh-CN.md) · [Official Website](https://readfrog.app) · [Tutorial](https://www.readfrog.app/docs) · [Changelog](https://www.readfrog.app/changelog) · [Blog](https://www.readfrog.app/blog)



[![Latest Version badge][extension-release-shield]][github-release-link]

[![Chrome Version badge][chrome-version-shield]][chrome-store-link]

[![Edge Version badge][edge-version-shield]][edge-store-link]

[![Firefox Version badge][firefox-version-shield]][firefox-store-link]


[![Discord badge][discord-shield]][discord-link]

[![Chrome Users badge][chrome-users-shield]][chrome-store-link]

[![Edge Users badge][edge-users-shield]][edge-store-link]

[![Firefox Users badge][firefox-users-shield]][firefox-store-link]


[![Stars badge][star-history-shield]][star-history-link]

[![Contributors badge][contributors-shield]][contributors-link]

![Last Commit badge][last-commit-shield]

[![Issues badge][issues-shield]][issues-link]


[![Sponsor badge][sponsor-shield]][sponsor-link]






![2025 Recap](/assets/2025-recap.png)



Table of contents



#### TOC



- [📺 Demo](#-demo)

- [👋🏻 Getting Started \& Join Our Community](#-getting-started--join-our-community)

  - [Download](#download)

  - [Community](#community)

- [✨ Features](#-features)

  - [🔄 Bilingual / Translation Only](#-bilingual--translation-only)

  - [✨ Selection Translation](#-selection-translation)

  - [🧠 Context-Aware Translation](#-context-aware-translation)

  - [🎬 Subtitle Translation](#-subtitle-translation)

  - [🔊 Text-to-Speech (TTS)](#-text-to-speech-tts)

  - [📦 Batch Requests](#-batch-requests)

  - [🤖 20+ AI Providers](#-20-ai-providers)

- [🤝 Contribute](#-contribute)

  - [Contribute Code](#contribute-code)

- [📜 Commercial License Grant](#-commercial-license-grant)

- [❤️ Sponsors](#️-sponsors)







## 📺 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][issues-link] encountered.



### Download



| Browser | Version                                                                | Download                                                          |

| ------- | ---------------------------------------------------------------------- | ----------------------------------------------------------------- |

| Chrome  | [![Chrome Version badge][chrome-version-shield]][chrome-store-link]    | [Chrome Web Store][chrome-store-link] or [中国镜像][crxsoso-link] |

| Edge    | [![Edge Version badge][edge-version-shield]][edge-store-link]          | [Microsoft Edge Addons][edge-store-link]                          |

| Firefox | [![Firefox Version badge][firefox-version-shield]][firefox-store-link] | [Firefox Add-ons][firefox-store-link]                             |



### Community



| [![Discord badge][discord-shield-badge]][discord-link] | In Discord ask questions, and connect with developers.                                 |

| :----------------------------------------------------- | :------------------------------------------------------------------------------------- |

| [![WeChat badge][wechat-shield-badge]][wechat-link]    | 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][image-star]][github-star-link]



  Star History





 

   

   

   Star History Chart

 







[![Back to top][back-to-top]](#readme-top)






## ✨ Features



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



### 🔄 [Bilingual / Translation Only][docs-tutorial]



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][back-to-top]](#readme-top)






### ✨ [Selection Translation][docs-tutorial]



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][back-to-top]](#readme-top)






### 🧠 [Context-Aware Translation][docs-tutorial]



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][back-to-top]](#readme-top)






### 🎬 [Subtitle Translation][docs-tutorial]



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][back-to-top]](#readme-top)






### 🔊 [Text-to-Speech (TTS)][docs-tutorial]



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][back-to-top]](#readme-top)






### 📦 [Batch Requests][docs-tutorial]



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][back-to-top]](#readme-top)






### 🤖 [20+ AI Providers][docs-tutorial]



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][back-to-top]](#readme-top)






## 🤝 Contribute



Contributions of all types are more than welcome.



1. Promote Read Frog to your friends and family.

2. Report [issues][issues-link] and feedback.

3. Contribute code.



### Contribute Code



Project Structure: [DeepWiki](https://deepwiki.com/mengxi-ream/read-frog)



Ask AI to understand the project: [Dosu](https://app.dosu.dev/29569286-71ba-47dd-b038-c7ab1b9d0df7/documents)



Check out the [Contribution Guide](https://readfrog.app/en/docs/code-contribution/contribution-guide) for more details.



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



See [CONTRIBUTING.md](./CONTRIBUTING.md) for contributor licensing terms.





  

    

      

        


        Read Frog contributors


        


      

    

    

  






[![Back to top][back-to-top]](#readme-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`](https://github.com/mengxi-ream/read-frog/commit/724863fdbc2d777766cada6c111235534ee03ca0)). Granted on March 3, 2026, 9:00 AM (Vancouver Time, UTC-8).






[![Back to top][back-to-top]](#readme-top)






## ❤️ Sponsors



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



[![Sponsors][sponsor-image]][sponsor-link]






[![Back to top][back-to-top]](#readme-top)






[back-to-top]: https://img.shields.io/badge/-BACK_TO_TOP-151515?style=flat-square

[chrome-store-link]: https://chromewebstore.google.com/detail/read-frog-open-source-ai/modkelfkcfjpgbfmnbnllalkiogfofhb

[chrome-users-shield]: https://img.shields.io/chrome-web-store/users/modkelfkcfjpgbfmnbnllalkiogfofhb?style=flat-square&label=Chrome%20Users&color=yellow&labelColor=black

[chrome-version-shield]: https://img.shields.io/chrome-web-store/v/modkelfkcfjpgbfmnbnllalkiogfofhb?style=flat-square&label=Chrome%20Version&labelColor=black&color=yellow

[contributors-link]: https://github.com/mengxi-ream/read-frog/graphs/contributors

[contributors-shield]: https://img.shields.io/github/contributors/mengxi-ream/read-frog?style=flat-square&labelColor=black

[crxsoso-link]: https://www.crxsoso.com/webstore/detail/modkelfkcfjpgbfmnbnllalkiogfofhb

[discord-link]: https://discord.gg/ej45e3PezJ

[discord-shield]: https://img.shields.io/discord/1371229720942874646?style=flat-square&label=Discord&logo=discord&logoColor=white&color=5865F2&labelColor=black

[discord-shield-badge]: https://img.shields.io/badge/chat-Discord-5865F2?style=for-the-badge&logo=discord&logoColor=white&labelColor=black

[edge-store-link]: https://microsoftedge.microsoft.com/addons/detail/read-frog-open-source-a/cbcbomlgikfbdnoaohcjfledcoklcjbo

[firefox-store-link]: https://addons.mozilla.org/firefox/addon/read-frog-open-ai-translator/

[firefox-version-shield]: https://img.shields.io/amo/v/read-frog-open-ai-translator?style=flat-square&label=Firefox%20Version&labelColor=black&color=orange

[firefox-users-shield]: https://img.shields.io/amo/users/read-frog-open-ai-translator?style=flat-square&label=Firefox%20Users&color=orange&labelColor=black

[edge-users-shield]: https://img.shields.io/badge/dynamic/json?style=flat-square&logo=microsoft-edge&label=Edge%20Users&query=%24.activeInstallCount&url=https%3A%2F%2Fmicrosoftedge.microsoft.com%2Faddons%2Fgetproductdetailsbycrxid%2Fcbcbomlgikfbdnoaohcjfledcoklcjbo&labelColor=black

[edge-version-shield]: https://img.shields.io/badge/dynamic/json?style=flat-square&logo=microsoft-edge&label=Edge%20Version&query=%24.version&url=https%3A%2F%2Fmicrosoftedge.microsoft.com%2Faddons%2Fgetproductdetailsbycrxid%2Fcbcbomlgikfbdnoaohcjfledcoklcjbo&labelColor=black&prefix=v

[extension-release-shield]: https://img.shields.io/github/package-json/v/mengxi-ream/read-frog?filename=package.json&style=flat-square&label=Latest%20Version&color=brightgreen&labelColor=black

[github-release-link]: https://github.com/mengxi-ream/read-frog/releases

[github-star-link]: https://github.com/mengxi-ream/read-frog/stargazers

[image-banner]: /assets/banner.png

[image-star]: ./assets/star.png

[issues-link]: https://github.com/mengxi-ream/read-frog/issues

[issues-shield]: https://img.shields.io/github/issues/mengxi-ream/read-frog?style=flat-square&labelColor=black

[last-commit-shield]: https://img.shields.io/github/last-commit/mengxi-ream/read-frog?style=flat-square&label=commit&labelColor=black

[sponsor-image]: https://cdn.jsdelivr.net/gh/mengxi-ream/static/sponsorkit/sponsors.svg

[sponsor-link]: https://github.com/sponsors/mengxi-ream

[sponsor-shield]: https://img.shields.io/github/sponsors/mengxi-ream?style=flat-square&label=Sponsor&color=EA4AAA&labelColor=black

[star-history-link]: https://www.star-history.com/#mengxi-ream/read-frog&Timeline

[star-history-shield]: https://img.shields.io/github/stars/mengxi-ream/read-frog?style=flat-square&label=stars&color=yellow&labelColor=black

[website]: https://readfrog.app

[wechat-link]: ./assets/wechat-account.jpg

[wechat-shield-badge]: https://img.shields.io/badge/chat-WeChat-07C160?style=for-the-badge&logo=wechat&logoColor=white&labelColor=black



[docs-tutorial]: https://readfrog.app/docs