Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/eeeXun/GTT
Google Translate TUI (Originally). Now support Apertium, Argos, Bing, ChatGPT, DeepL, DeepLX, Google, Reverso.
https://github.com/eeeXun/GTT
apertium argos bing chatgpt deepl deeplx google reverso translator tui
Last synced: about 2 months ago
JSON representation
Google Translate TUI (Originally). Now support Apertium, Argos, Bing, ChatGPT, DeepL, DeepLX, Google, Reverso.
- Host: GitHub
- URL: https://github.com/eeeXun/GTT
- Owner: eeeXun
- License: mit
- Created: 2022-10-24T15:41:41.000Z (over 1 year ago)
- Default Branch: master
- Last Pushed: 2024-04-08T17:33:18.000Z (2 months ago)
- Last Synced: 2024-04-13T03:12:57.281Z (2 months ago)
- Topics: apertium, argos, bing, chatgpt, deepl, deeplx, google, reverso, translator, tui
- Language: Go
- Homepage:
- Size: 4.1 MB
- Stars: 225
- Watchers: 2
- Forks: 9
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Lists
- cli-apps - GTT - Google Translate TUI - A TUI interface to bring Google Translation in the terminal. (<a name="writing"></a>Writing)
- awesome-cli-apps - GTT - Google Translate TUI - A TUI interface to bring Google Translation in the terminal. (<a name="writing"></a>Writing)
README
# gtt
Google Translate TUI (Originally)
Supported Translator:
[`Apertium`](https://www.apertium.org/),
[`Argos`](https://translate.argosopentech.com/),
[`Bing`](https://www.bing.com/translator),
[`ChatGPT`](https://chat.openai.com/),
[`DeepL`](https://deepl.com/translator)(only free API),
[`Google`](https://translate.google.com/)(default),
[`Reverso`](https://www.reverso.net/text-translation)
## ⚠️ Note for ChatGPT and DeepL
ChatGPT and DeepL translations require API keys, which can be obtained from
[OpenAI API keys](https://platform.openai.com/account/api-keys) and
[DeepL API signup](https://www.deepl.com/pro-api) 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/gtt.yaml` or
`$HOME/.config/gtt/gtt.yaml`
```yaml
api_key:
chatgpt: CHATGPT_API_KEY # <- Replace with your API Key
deepl: DEEPL_API_KEY # <- Replace with your API Key
```
## ScreenShot
## 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`](https://github.com/astrand/xclip) (optional) - for Linux/X11 to copy text.
[`wl-clipboard`](https://github.com/bugaevc/wl-clipboard) (optional) - for Linux/Wayland to copy text.
### Arch Linux ([AUR](https://aur.archlinux.org/packages/gtt-bin))
```sh
yay -S gtt-bin
```
### Nix ❄️ ([nixpkgs-unstable](https://search.nixos.org/packages?channel=unstable&show=gtt&from=0&size=50&sort=relevance&type=packages&query=gtt))
add to your package list or run with:
```sh
nix-shell -p '(import {}).gtt' --run gtt
```
or with flakes enabled:
```sh
nix run github:nixos/nixpkgs#gtt
```
### Prebuild
Binary file is available in [Release Page](https://github.com/eeeXun/gtt/releases) for Linux and macOS on x86_64.
### From source
#### go install
```sh
go install -ldflags="-s -w" github.com/eeeXun/gtt@latest
```
And make sure `$HOME/go/bin` is in your `$PATH`
```sh
export PATH=$PATH:$HOME/go/bin
```
#### go build
```sh
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](https://hub.docker.com/r/eeexun/gtt/tags))
```sh
docker run -it eeexun/gtt:latest
```
## Key Map
``
Exit program.
``
Toggle pop out window.
``
Translate from source to destination window.
``
Swap language.
``
Clear all text in source of translation window.
``
Copy selected text.
``
Copy all text in source of translation window.
``
Copy all text in destination of translation window.
``
Play text to speech on source of translation window.
``
Play text to speech on destination of translation window.
``
Stop playing text to speech.
``
Toggle transparent.
``
Toggle Definition/Example & Part of speech.
``, ``
Cycle through the pop out widget.
`<1>`, `<2>`, `<3>`
Switch pop out window.
### Customize key map
You can overwrite the following key
- `exit`: Exit program.
- `translate`: Translate from source to destination window.
- `swap_language`: Swap language.
- `clear`: Clear all text in source of translation window.
- `copy_selected`: Copy selected text.
- `copy_source`: Copy all text in source of translation window.
- `copy_destination`: Copy all text in destination of translation window.
- `tts_source`: Play text to speech on source of translation window.
- `tts_destination`: Play text to speech on destination of translation window.
- `stop_tts`: Stop playing text to speech.
- `toggle_transparent`: Toggle transparent.
- `toggle_below`: Toggle Definition/Example & Part of speech.
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](example/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:
- `bg` is for background color
- `fg` is for foreground color
- `gray` is for selected color
- `yellow` is for label color
- `orange` is for KeyMap menu color
- `purple` is for button pressed color
See the example in [theme.yaml](example/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.
```sh
gtt -src "English" -dst "Chinese (Traditional)"
```
See available languages on:
- [Apertium Translate](https://www.apertium.org/) for `Apertium`
- [argosopentech/argos-translate](https://github.com/argosopentech/argos-translate#supported-languages) for `Argos`
- [Bing language-support](https://learn.microsoft.com/en-us/azure/cognitive-services/translator/language-support#translation) for `Bing`
- `ChatGPT` is same as `Google`. See [Google Language support](https://cloud.google.com/translate/docs/languages)
- [DeepL API docs](https://www.deepl.com/docs-api/translate-text/) for `DeepL`
- [Google Language support](https://cloud.google.com/translate/docs/languages) for `Google`
- [Reverso Translation](https://www.reverso.net/text-translation) for `Reverso`
## Credit
[soimort/translate-shell](https://github.com/soimort/translate-shell),
[SimplyTranslate-Engines](https://codeberg.org/SimpleWeb/SimplyTranslate-Engines),
[s0ftik3/reverso-api](https://github.com/s0ftik3/reverso-api)
For request method.
[snsd0805/GoogleTranslate-TUI](https://github.com/snsd0805/GoogleTranslate-TUI) For inspiration.
[turk/free-google-translate](https://github.com/turk/free-google-translate) For Google translate in Golang.