README.en.md

KISS Translator

English | 简体中文

A simple, open source bilingual translation extension & Greasemonkey script.

kiss-translator.webm

Features

• Keep it simple, smart
• Open source
• Adapt to common browsers
  • Chrome/Edge/Firefox/Kiwi/Orion
  • Safari
• Supports multiple translation services
  • Google/Microsoft/DeepL/NiuTrans/OpenAI/Gemini/CloudflareAI/Baidu/Tencent
  • Custom translation interface
• Covers common translation scenarios
  • Web bilingual translation
  • Input box translation
  • Seletction translation
    • Favorite Words
  • Mouseover translation
  • YouTube subtitle translation
• Cross-client data synchronization
  • KISS-Worker（cloudflare/docker）
  • WebDAV
• Custom translation rules
  • Rule subscription/rule sharing
  • Customized terminology
• Custom translation style
• Custom shortcut keys
  • Alt+Q Toggle Translation
  • Alt+C Toggle Styles
  • Alt+K Open Setting Popup
  • Alt+S Open Translate Popup / Translate Selected Text
  • Alt+O Open Options Page
  • Alt+I Input Box Translation

Install

Note: For the following reasons, it is recommended to use browser extensions first

• Browser extensions have more complete functions (local language recognition, context menu, etc.)
• Grease Monkey script will encounter more usage problems (cross domain issues, script conflicts, etc.)

• Browser extension
  • Chrome Installation address
    • Kiwi (Android)
    • Orion (iOS)
  • Edge Installation address
  • Firefox Installation address
  • Safari
• GreaseMonkey Script
  • Chrome/Edge/Firefox (Tampermonkey/Violentmonkey) Installation link
    • Greasy Fork
  • iOS Safari (Userscripts Safari) Installation link

Associated Projects

• Data synchronization service: https://github.com/fishjar/kiss-worker
  • Data synchronization service available for this project.
  • Can also be used to share personal private rule lists.
  • Deploy by yourself, manage by yourself, data is private.
• Community subscription rules: https://github.com/fishjar/kiss-rules
  • Provides the latest and most complete list of subscription rules maintained by the community.
  • Help with rules-related issues.
• Translation interface agent: https://github.com/fishjar/kiss-proxy
  • If you encounter network problems when accessing a certain translation interface, this proxy service may help you.
  • Deploy and manage by yourself.
• Minimalistic Dictionary Plugin: https://github.com/fishjar/kiss-dictionary
  • A word-marking translation plug-in used with this project.
  • Supports query of English words, sentences and Chinese characters.
  • Supports history records and word collections.

Development Guidelines

git clone https://github.com/fishjar/kiss-translator.git
cd kiss-translator
pnpm install
pnpm build

Discussion

• Join Telegram Group

Appreciate