Skip to content

yelog/SnapTraTranslator

Repository files navigation

SnapTra Translator

English | 简体中文 | 日本語 | 한국어

A lightweight macOS menu bar app that instantly translates words under your cursor via screen capture and OCR. Press a hotkey, hover over any text, and get a beautiful floating bubble with translation, phonetics, dictionary definitions, and optional pronunciation.

Preview

Settings

Screenshots

Translation Bubble Dictionary Definitions

Features

Core Translation

  • Instant OCR translation - Captures screen region around cursor and detects the word closest to your pointer
  • Floating bubble overlay - Modern translucent bubble appears near cursor with translation results
  • Dictionary definitions - Shows detailed word definitions grouped by part of speech (noun, verb, adjective, etc.)
  • Phonetic notation - Displays phonetic transcription for recognized words
  • Text-to-speech - Optional pronunciation playback after translation

Translation Modes

  • Continuous translation - Keep translating as you move the mouse while holding the hotkey
  • Single lookup mode - One translation per hotkey press with interactive bubble (copy, close buttons)

Supported Languages

Chinese (Simplified), Chinese (Traditional), English, Japanese, Korean, French, German, Spanish, Italian, Portuguese, Russian, Arabic, Thai, Vietnamese

Customization

  • Single-key hotkey - Configure trigger key from modifier keys (Shift, Control, Option, Command, Fn)
  • Source/target language selection - Choose your translation language pair
  • Launch at login - Auto-start when you log in
  • Debug OCR region - Visualize capture area and detected word bounding boxes for troubleshooting

Additional Features

  • Copy to clipboard - Quick copy word or translation
  • Language pack detection - Automatically checks and prompts for missing language packs
  • Menu bar app - Runs quietly in the menu bar without cluttering your dock

Download

Available on the Mac App Store

Requirements

  • macOS 14+ (translation features require macOS 15 for system Translation APIs)
  • Screen Recording permission (required for OCR capture)

Build & Run

Open in Xcode:

open "SnapTra Translator.xcodeproj"

Build from command line:

# Debug build
xcodebuild -project "SnapTra Translator.xcodeproj" -scheme "SnapTra Translator" -configuration Debug build

# Release build
xcodebuild -project "SnapTra Translator.xcodeproj" -scheme "SnapTra Translator" -configuration Release build

# Clean
xcodebuild -project "SnapTra Translator.xcodeproj" -scheme "SnapTra Translator" clean

Usage

  1. Grant permissions - Launch the app and grant Screen Recording permission when prompted
  2. Configure settings - Set your preferred hotkey and language pair in the settings window
  3. Translate - Hold the hotkey and hover over any text; a bubble appears with translation, phonetics, and definitions
  4. Dismiss - Release the hotkey to dismiss (or click X in single lookup mode)

Troubleshooting

  • No bubble appears - Check Screen Recording permission in System Settings > Privacy & Security > Screen Recording
  • Missing translations on macOS 15 - Install language packs in System Settings > General > Language & Region > Translation Languages
  • Hotkey not working - Ensure no other app is using the same key; try a different modifier key
  • Bubble clipped at screen edge - Enable "Debug OCR Region" to see the capture area and adjust cursor position

License

MIT License

About

一款 macos 离线快速翻译软件

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Languages