Skip to content

Genghot/GGGoogleTranslate

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

9 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

GGGoogleTranslate

A system-wide macOS utility for instant Google Translate access. Highlight text anywhere, press a hotkey, and get a floating translation window immediately.


☕ Support the Developer

If you find this tool useful, please consider sponsoring the development! Sponsor


🌟 Features

  • Instant Translation: Highlight text in any app (Safari, Chrome, VS Code, Notes, etc.) and translate it instantly.
  • System-Wide Hotkey: Trigger the translation from anywhere on your Mac.
  • Floating Window: A premium, resizable floating panel centered on your screen that stays above other windows.
  • Auto-Detection: Automatically detects the source language.
  • Language Persistence: Remembers your target language and saves changes automatically.
  • Native & Fast: Built with Swift and Carbon for ultra-low latency and minimal resource usage.
  • Privacy-Friendly: Runs entirely on your machine; only sends the selected text to Google Translate when you trigger it.

🖼️ Screenshots

Menu Bar Settings Translation Window
Menu Bar Translation Window

🚀 Installation

  1. Download: Go to the Releases page and download GGGoogleTranslate_v1.0.0.dmg.
  2. Install: Open the .dmg file and drag GGGoogleTranslate into the /Applications folder alias.
  3. Launch: Open the app from your Applications folder. You will see a globe icon in your menu bar.
  4. Permissions:
    • The first time you use the hotkey, macOS will ask for Accessibility Permissions.
    • This is required so the app can simulate a "Copy" command to grab your highlighted text.
    • Go to System Settings > Privacy & Security > Accessibility and enable GGGoogleTranslate.

Important

Security Note (First Launch) Because this app is independently developed and not notarized by Apple, you might see a warning that Apple "could not verify it for malware." To open it:

  1. Right-click (or Control-click) the app in your Applications folder and select Open.
  2. In the dialog that appears, click Open again.
  3. This will register the app as safe, and it will launch normally from then on.

Tip

Still can't open? If macOS is still being stubborn, you can manually allow it by running this one command in your Terminal:

xattr -cr /Applications/GGGoogleTranslate.app

📖 How to Use

  1. Highlight text in any application.
  2. Press the Hotkey: The default is ⌘ + Option + G.
    • Note: If this conflict with your applications, change it in the settings!
  3. The Window Pops Up: Your translation appears instantly.
  4. Dismiss: Press Esc or click anywhere outside to hide the translator.
  5. Change Settings:
    • Click the globe icon in the menu bar.
    • Change Target Language: Select from the dropdown.
    • Change Hotkey: Click "Change Hotkey" and press your desired combination.
    • Launch at Login: Toggle this to have the app start automatically.

🛠️ Building from Source

If you want to build the app yourself:

  1. Clone the repository:
    git clone https://github.com/Genghot/GGGoogleTranslate.git
    cd GGGoogleTranslate
  2. Run the build script:
    bash build.sh
  3. The compiled app will be in ./build/GGGoogleTranslate.app.

⚖️ License

MIT License. See LICENSE for details.

About

A lightweight macOS menu bar utility that lets users highlight any text system-wide, press a configurable hotkey, and instantly get a Google Translate popup with the selected text pre-filled.

Resources

Stars

Watchers

Forks

Sponsor this project

 

Packages

 
 
 

Contributors