SakanaLens

Automatic Japanese-to-English Translation

SakanaLens enables seamless translation of Japanese text to English in any active window. With a simple Ctrl + T shortcut for full-window translation, Ctrl + Cmd + T to select a specific area, or Ctrl + Cmd + R to lock a region for future translations (then using Ctrl + T to translate only that region), you can translate on-screen text without switching applications.

---

✨ Features

• Instant Translation: Press Ctrl + T to trigger translation of the entire active window. :zap:
• Selective Translation: Use Ctrl + Cmd + T to select a specific area or scope for translation, instead of the whole window. :scissors:
• Region Lock Translation: Press Ctrl + Cmd + R to select or define a specific region for translation. The app will remember this region, and subsequent Ctrl + T presses will only translate text within that locked region. :lock:
• Stay Focused: No need to leave the app you’re using. :eyes:
• Screen Text Detection: Automatically translates visible text in the active application. :mag:
• Speech Support: Converts translated text into speech (English & Chinese only, via Alibaba DashScope). :sound:
• Local Text-to-Speech (TTS): Support kokoro tts model, using local tts without token consumption. :speech_balloon:

---

🚀 Installation & Setup

Step 1: Install Dependencies

pip3 install -r requirements.txt

Step 2: Grant Accessibility Permissions

To function properly, SakanaLens requires accessibility permissions.

• Open System Preferences → Privacy & Security → Accessibility.
• Add either the app or the terminal if running from the command line.

Step 3: Set Up API Key

• Rename api_template.json5 to api.json5.
• Edit api.json5 and insert your API key.

Step 4: Run the Application

python3 sakana_lens.py

• Press Ctrl + T to trigger translation.

---

⚠️ Compatibility

SakanaLens is currently only supported on macOS.

Note:

• This app CANNOT run on Windows.
• You MUST grant Accessibility permissions for the app or terminal.
• You MUST grant Screen and System Audio Recording permissions for the app or terminal.
  These permissions are required under Privacy & Security settings because the app needs access to the screen for clipping and screenshots, as well as system audio output.

---

🎤 Text-to-Speech (TTS) Support

• Utilizes Alibaba DashScope for TTS.
• Supports English and Chinese.
• Japanese TTS is not supported.
• Note: Using DashScope for TTS consumes tokens, which may incur costs.

---

🟢 New UI | 🎉 Version 2.0 released

---

📺 Showcase

🔎 Webpage Translation

Translate website text into English effortlessly. 🛜

📖 Manga Translation with Speech

Experience manga translation with text-to-speech functionality. 💬

:lock: Region Locker

Press Ctrl + Cmd + R to select or define a specific region for translation, the next Ctrl + T presses will only translate text within that locked region.

🖥️ Additional Use Cases

Web Translation Helper

Reading Assistance

Gaming Support

---

🛠️ Contribution & Support

Feel free to contribute to this project! If you encounter issues, please open an issue or submit a pull request.

Happy translating! 🎉

---

```json { “name”: “Sakana Lens”, “description”: “自動翻訳ツール (日本語対応)”, “version”: “2.0”, “author”: “Charles Liu”, “license”: “Apache-2.0”, “system_requirements”: { “os”: “macOS only”, “python”: “Python 3.9+” } }

This site is open source. Improve this page.