press Alt + Q, get an instant floating translation.

Find a file

Cheng Gu 925050da90 feat: keep window inside screen's work area		2026-01-27 22:02:08 +08:00
.github/workflows	ci: dont publish	2026-01-27 10:14:06 +08:00
electron	feat: keep window inside screen's work area	2026-01-27 22:02:08 +08:00
src	feat: set lang of source and target and other improves	2026-01-27 21:39:54 +08:00
.gitignore	init	2026-01-25 21:15:27 +08:00
.prettierrc	init	2026-01-25 21:15:27 +08:00
index.html	init	2026-01-25 21:15:27 +08:00
LICENSE	Add MIT License to the project	2026-01-27 09:44:43 +08:00
package-lock.json	chore: license	2026-01-27 21:39:05 +08:00
package.json	feat: wired electron builder config	2026-01-27 10:07:31 +08:00
preview.png	init	2026-01-25 21:15:27 +08:00
README.md	fix: LICENSE	2026-01-27 09:46:07 +08:00
vite.config.js	init	2026-01-25 21:15:27 +08:00

README.md

Lucy Translator

A lightweight, floating Windows translation app. Select text in any application, press Alt + Q, and get an instant translation.

Features

Global Shortcut: Alt + Q to capture and translate.
Floating Window: Appears near your mouse cursor. Glassmorphism design.
System Tray: Runs in background. Minimizes to tray.
Translation: Powered by Google Translate (via google-translate-api-x).
Native Input: Uses Input API (via koffi) to simulate Ctrl+C without blocking other keys.

Development

Prerequisites

Node.js (LTS)
Windows (for native API support)

Setup

npm install

Run

npm run electron:dev

Build

To create a Windows installer (.exe):

npm run dist

The output can be found in the release/ directory.

Formatting

npm run format

Configuration

Shortcut: Alt+Q (Hardcoded in electron/main.js)
Target Language: Simplified Chinese (zh-CN)

License

MIT License

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.