Originally, this article described a Javascript version of this utility, but the NPM dependency no longer works so I made a Python version. Thus, the presence of “node js” logo in the banner image. – BRH

Ever since moving to Europe way back in 2010, I have been a frequent user of Google Translate. However, cutting-and-pasting between a web site or text document and the Translate’s input field is a bit tedious, so I looked into ways to make it easier to integrate into my daily life on a laptop. The solution I came up with relies on Python, the Google translate API, and the excellent macOS utility called Keyboard Maestro.

Getting Started with Translations

There is some initial setup necessary before Google translate API can be used. I followed the instructions for the Python client library. Next, I created a Python virtual environment in which to install the Google Python package. A short bit later, I was able to run a simple Python program that does the job:

import sys
from google.cloud import translate_v2 as translate

def translate_text(text: str, source: str, target: str) -> str:
    result = translate.Client().translate(values=text, target_language=target, source_language=source)
    return result['translatedText']

if __name__ == '__main__':
    print(translate_text(sys.stdin.read().strip(), sys.argv[1], sys.argv[2]))
    sys.exit(0)

Nothing fancy – just read in some text to translate and direct Google Translate to do the hard work. When we get the response from Google, send the output text to stdout for another process to read. We can quickly check that it works:

echo 'The king is dead. Long live the king' | python translate.py en fr
Le roi est mort. Longue vie au roi.

Seems ok. Let’s try the reverse for fun:

echo 'Le roi est mort. Longue vie au roi.' | python translate.py fr en
The king is dead. Long live the king.

To make things easy when calling this from another process, I modified the Python script to launch within the Python virtual environment by adding a magic shebang line at the beginning:

#!/Users/howes/src/translator/venv/bin/python

Here, the path points to the Python inside the virtual environment venv I created before installing the Google translate package.

I then added execute permissions to the Python script so that one could run it directly without needing to use python in the command-line, and I removed the suffix.

mv translate.py translate
chmod a+x translate

Bring in the Keyboard Maestro

Next step was to make the Python script (translate) run when I pressed a key sequence trigger after selecting some text. First, I created two Keyboard Maestro macros for the two translation paths: English to French, and French to English.

The only difference is the order of the en and fr arguments given to translate script.

The macros read whatever text is in the System Clipboard and passes it to the translate script. Keyboard Maestro reads the output of the Python process and puts it into the System Clipboard, replacing the text that was there with its translation.

Both macros are configured to appear in the global macro palette. The global macro palette will appear when a key sequence is pressed, which in my setup is the function key F12.

Now, Pressing F12 brings up a small palette with two choices:

Pressing the letter E will bring about the English-French translation, while pressing F will translate French to English. Simple. Here is what the translation output looks like: