auto-translate

Project Overview

auto-translate is a Chrome/Edge extension (Manifest V3) modeled after Immersive Translate, doing bilingual web translation through your own AI APIs. It supports OpenAI-compatible, Claude, Gemini and Ollama formats, and ships built-in Google/Microsoft free channels — usable out of the box without any key.

Immersive-translate style with your own AI, or with free channels and zero keys.

Key Features

• Full-page bilingual translation: dual/translated/original modes, cycle with Alt+M
• Viewport lazy translation: only translates what you see, saving API quota
• Selection translation: bubble with streaming output and Edge TTS read-aloud
• Input-box translation: one click to translate what you typed, filled back in
• Hover translation: a badge on block elements for on-demand paragraph translation
• Multi-format AI APIs: OpenAI-compatible/Claude/Gemini/Ollama with custom BaseURL, key and model
• Free channels and fallback: keyless Google/Microsoft channels; automatic switch to a backup API on failure
• Smart rendering: truncated-box escape, flex/grid adaptation, self-rendering element protection, SPA re-translation
• Site rules: built-in exclusions plus allow/block lists with Chinese IDN domains
• Translation cache: cross-session reuse with rate limiting, retry and dedup

Target Audience

• Readers of foreign-language sites and papers
• Developers with their own DeepSeek-style APIs
• Casual users who want translation without keys
• Learners relying on selection and hover reading

Quick Start

1. Download and unzip the latest release zip
2. Open chrome://extensions/, enable Developer mode and Load unpacked
3. In settings pick a free Google/Microsoft channel, or fill your API and hit Test connection
4. Open a foreign page, click the red circle to translate, or press Alt+T

Core Advantages

• Zero-key start: free channels work immediately; AI APIs upgrade quality
• Quota-friendly: viewport lazy translation plus caching minimize API usage
• Detail-hardened: handles truncated boxes, flex layouts and self-rendering elements
• Reliable fallback: backup API auto-switching and encrypted key storage

System Requirements

Item	Requirement
Browser	Chrome / Edge 109+
Manifest	V3
License	MIT

Notes

• Not on the web store; load the unzipped folder in developer mode
• Keep your own API keys safe — they stay on your device
• Firefox is not supported yet