Home

Awesome

gtt

Google Translate TUI (Originally)

Supported Translator: Apertium, Bing, ChatGPT, DeepL(only free API), DeepLX, Google(default), Libre, Reverso

ScreenShot

screenshot

⚠️ Note for ChatGPT and DeepL

ChatGPT and DeepL translations require API keys, which can be obtained from OpenAI API keys and DeepL API signup pages, respectively. Note that only the free API is supported for DeepL currently. Once you have your API key add it to $XDG_CONFIG_HOME/gtt/server.yaml or $HOME/.config/gtt/server.yaml. See the example in server.yaml file.

api_key:
  chatgpt:
    value: CHATGPT_API_KEY # <- Replace with your API Key
    # file: $HOME/secrets/chatgpt.txt # <- You can also specify the file where to read API Key
  deepl:
    value: DEEPL_API_KEY # <- Replace with your API Key
    # file: $HOME/secrets/deepl.txt # <- You can also specify the file where to read API Key

DeepLX

DeepLX is self-hosted server. You must provide IP address and port at $XDG_CONFIG_HOME/gtt/server.yaml or $HOME/.config/gtt/server.yaml. The api key for DeepLX is optional, depending on your setting. See the example in server.yaml file.

api_key:
  deeplx:
    value: DEEPLX_API_KEY # <- Replace with your TOKEN
    # file: $HOME/secrets/deeplx.txt # <- You can also specify the file where to read API Key
host:
  deeplx: 127.0.0.1:1188 # <- Replace with your server IP address and port

Libre

If you want to use official LibreTranslate, you have to obtain an API Key on their website. Alternatively, if you want to host it by yourself, you must provide the IP address and port. Make sure add them to $XDG_CONFIG_HOME/gtt/server.yaml or $HOME/.config/gtt/server.yaml. See the example in server.yaml file.

api_key:
  libre:
    value: LIBRE_API_KEY # <- Replace with your API Key
    # file: $HOME/secrets/libre.txt # <- You can also specify the file where to read API Key
host:
  libre: 127.0.0.1:5000 # <- Replace with your server IP address and port

Install

Dependencies

For Arch Linux, you need alsa-lib. For Ubuntu or Debian, you need libasound2-dev. For RedHat-based Linux, you need alsa-lib-devel.

xclip (optional) - for Linux/X11 to copy text.

wl-clipboard (optional) - for Linux/Wayland to copy text.

Or, if your terminal supports OSC 52, you can enable OSC 52 in page 2 of the pop out menu to copy text.

Arch Linux (AUR)

yay -S gtt-bin

Nix ❄️ (nixpkgs-unstable)

add to your package list or run with:

nix-shell -p '(import <nixpkgs-unstable> {}).gtt' --run gtt

or with flakes enabled:

nix run github:nixos/nixpkgs#gtt

Prebuild

Binary file is available in Release Page for Linux and macOS on x86_64.

From source

go install

go install -ldflags="-s -w" github.com/eeeXun/gtt@latest

And make sure $HOME/go/bin is in your $PATH

export PATH=$PATH:$HOME/go/bin

go build

git clone https://github.com/eeeXun/gtt.git && cd gtt && go build -ldflags="-s -w -X main.version=$(git describe --tags)"

Run on Docker (Docker Hub)

docker run -it eeexun/gtt:latest

Key Map

<C-c> Exit program.

<Esc> Toggle pop out menu.

<C-j> Translate from source to destination window.

<C-s> Swap language.

<C-q> Clear all text in source of translation window.

<C-y> Copy selected text.

<C-g> Copy all text in source of translation window.

<C-r> Copy all text in destination of translation window.

<C-o> Play text to speech on source of translation window.

<C-p> Play text to speech on destination of translation window.

<C-x> Stop playing text to speech.

<C-t> Toggle transparent.

<C-\> Toggle Definition/Example & Part of speech.

<Tab>, <S-Tab> Cycle through the pop out widget.

<1>, <2>, <3> Switch pop out menu.

Customize key map

You can overwrite the following key

For key to combine with Ctrl, the value can be C-Space, C-\, C-], C-^, C-_ or C-a to C-z.

For key to combine with Alt, the value can be A-Space or A- with the character you want.

Or you can use function key, the value can be F1 to F64.

See the example in keymap.yaml file. This file should be located at $XDG_CONFIG_HOME/gtt/keymap.yaml or $HOME/.config/gtt/keymap.yaml.

Customize theme

You can create a theme with theme name. And you must provide the color of bg, fg, gray, red, green, yellow, blue, purple, cyan, orange.

And note that:

See the example in theme.yaml file. This file should be located at $XDG_CONFIG_HOME/gtt/theme.yaml or $HOME/.config/gtt/theme.yaml.

Language in argument

You can pass -src and -dst in argument to set source and destination language.

gtt -src "English" -dst "Chinese (Traditional)"

See available languages on:

Credit

soimort/translate-shell, SimplyTranslate-Engines, s0ftik3/reverso-api For request method.

snsd0805/GoogleTranslate-TUI For inspiration.

turk/free-google-translate For Google translate in Golang.