illa-helper  by xiao-zaiyi

Browser extension for immersive language learning

Created 3 months ago
2,618 stars

Top 18.0% on SourcePulse

GitHubView on GitHub
Project Summary

This browser extension provides an immersive language learning experience by leveraging "comprehensible input" theory, transforming the web into a personalized learning environment. It intelligently replaces words with translations, offering a comprehensive pronunciation learning ecosystem, making it ideal for language learners seeking natural vocabulary acquisition and improved language intuition.

How It Works

The extension employs AI-driven language detection and text processing to analyze webpage content, identifying vocabulary suitable for the user's proficiency level. It offers precise control over translation ratios and context-aware replacement, ensuring translations are appropriate and non-intrusive. A dual-layer learning experience is provided through interactive tooltips that display phonetics, AI definitions, and pronunciation features upon hovering over translated words.

Quick Start & Requirements

  • Installation: Recommended via official Chrome Web Store or Firefox Add-ons.
  • Developer Installation: Requires Node.js (v18+) and npm. Clone the repository, run npm install, and configure API keys in a .env file. Build using npm run build and load unpacked.
  • API Key: An API key for OpenAI-compatible services (e.g., ChatGPT, Gemini) is required for translation functionality.

Highlighted Details

  • Supports 20+ languages with AI-powered intelligent translation and automatic language detection.
  • Features a pronunciation learning ecosystem with dual TTS support (Youdao TTS, Web Speech API), phonetic notation, and AI definitions.
  • Highly configurable with options for translation styles, display modes, trigger modes, and website black/whitelists.
  • Built with a modern tech stack: WXT framework, Vue 3, TypeScript, Vite, and Tailwind CSS.

Maintenance & Community

The project is actively maintained by Xiao-zaiyi. Discussions and contributions are welcomed via GitHub Issues.

Licensing & Compatibility

Licensed under the MIT License, permitting free use, modification, and distribution, including for commercial purposes. Fully supported on Chrome and Edge; partially supported on Firefox and Safari, with specific installation notes for Firefox.

Limitations & Caveats

Safari support requires additional configuration. Firefox users may need to use temporary installation or adjust security settings for full functionality due to add-on signing policies. An API key is mandatory for the core translation feature to work.

Health Check
Last Commit

3 weeks ago

Responsiveness

Inactive

Pull Requests (30d)
0
Issues (30d)
13
Star History
138 stars in the last 30 days

Explore Similar Projects

Feedback? Help us improve.