fishjar/kiss-translator

What it does

KISS Translator adds bilingual contrast translation to web pages, input boxes, selected or hovered text, and YouTube subtitles. It is distributed both as a browser extension and as a Greasemonkey-style userscript. Translation providers are configurable: built-in services include Google, Microsoft, Baidu, Tencent, DeepL, and AI services such as OpenAI, Gemini, Claude, Ollama, DeepSeek, and OpenRouter, and non-standard APIs can be connected through an external plugin system.

The extension version goes beyond page translation: it provides a comparison window for multiple services, a dictionary and vocabulary list, a site-rule editor, multilingual document translation (TXT, Markdown, PDF, EPUB, images), and local AI models that run in the browser after an explicit download.

Getting started

1. Install the extension from your browser's store: Chrome, Edge, or Firefox.
2. Open the settings page, go to service configuration, add a built-in service, fill in the API address, key, and model name, then click Test and save.
3. In scene settings, choose which service handles webpage translation, selection lookup, input-box translation, or subtitle translation.
4. Press Alt+Q or click the floating icon to translate the current page; Alt+D opens the standalone comparison window.

If you prefer a userscript, install Tampermonkey or Violentmonkey first, then install the main script or the iOS Safari variant. More detail is on the project site.

Constraints

• The extension is the recommended installation; the userscript lacks extension-only APIs, local AI, file translation, and plugin support, and may hit cross-origin restrictions.
• Features in the current dev branch may not yet be available in store builds. Safari is not supported yet.
• Local AI requires browser features such as WebGPU where applicable; speed and memory depend on the device and chosen model. Models must be downloaded before use.
• Configuring services needs valid API endpoints and keys. For local Ollama, the built-in adapter uses the OpenAI-compatible protocol rather than /api/chat, and cross-origin settings may be needed.
• Rule editing applies to standard DOM pages; iframe, Shadow DOM, canvas text, and touch gestures are not supported for visual selection.
• Configuration sync is via the separate KISS-Worker project or WebDAV. Plugin authorizations are local and must be repeated after syncing to a new device.
• The project is licensed under GPL-3.0.

Development

Building requires Node.js >= 20 (22/24 recommended) and pnpm >= 9. Run pnpm install, then pnpm build:chrome or pnpm build:firefox, and load the output directory as an unpacked extension. pnpm start serves a local web version for debugging. Plugin development is documented in the separate plugins repository.

HotRepo's take

On the JavaScript daily list dated 2026-11-11 the project recorded 13,286 stars and 19 stars gained, reaching position 11 for that day. That single snapshot supports only the fact of a recent appearance on the list, not a trend; the standing itself reflects sustained general interest in a translation tool that offers many providers and local-model options in one extension.