x-ai-auto-translator

Project Overview

X AI Translator is a browser extension that translates foreign posts on X (Twitter) into your language. Built for Chrome and Edge as a Manifest V3 extension with zero dependencies and no build step, it uses your own OpenAI-compatible AI service and renders translations by cloning the original post's DOM, so the layout matches perfectly.

Your own AI turns X into a Chinese-language feed.

Key Features

• Full coverage: timelines, post detail pages, comments, quotes, profile bios and info cards
• Dual modes: auto-translate on viewport entry with prefetching, or a manual "Translate" button per post
• Bring your own engine: any OpenAI-compatible endpoint - vLLM, Ollama, DeepSeek, GLM, OpenAI, Gemini gateways
• Pixel-identical layout: clones the original DOM and replaces only text nodes; links, line breaks, bold and font sizes stay the same
• Placeholder protection: emoji, URLs, @mentions and #hashtags never enter the model and are restored in place
• Token savings: text is split into segments, batch-merged per request, and identical text translates once per session
• Image explanations: a vision model describes any image in a dark overlay panel, click again to restore
• Local privacy: the API key lives only in chrome.storage; requests go straight from the extension background to your service

Target Audience

• Chinese users browsing foreign posts on X
• Developers running their own AI inference services
• Privacy-minded users avoiding third-party relays
• Readers who want translations in the original layout

Quick Start

1. Clone the repository or download and unzip the release archive
2. Open chrome://extensions (or edge://extensions), enable Developer mode, and "Load unpacked extension"
3. Visit x.com, click the toolbar icon, and set your base URL, API key and model

Core Advantages

• Zero middlemen: translation requests go directly to your own service
• No build step: load the source directory as-is
• Native reading feel: translations match the original post pixel for pixel

System Requirements

Item	Requirement
Browser	Desktop Chrome or Edge (Chromium)
AI service	A reachable OpenAI-compatible service (e.g. self-hosted vLLM)

Notes

• X redesigns often; selector updates may be needed after major changes
• API costs are on you, mitigated by batch merging and session caching
• Switching models may not change translations until the session cache clears on browser restart
• Local http endpoints work fine: requests come from the extension background, not the page