translate-shell

Translate text by google, bing, youdaozhiyun, haici, stardict, etc at same time from CLI, GUI (GNU/Linux, Android, macOS and Windows), REPL, python, shell and vim.

Usage

UI

CLI

trans --translators=google,bing,haici,stardict crush

REPL

$ trans  # enter REPL
> en:ja  # change source language to english and target language to japanese
> :  # swap source and target languages
> =stardict  # use stardict to translate text
> !cat example/test.txt  # execute a shell command
ハッカー
> <example/test.txt   # translate a file
hacker
> 画家  # translate text
painter; artist
> !  # enter shell
$ echo $SHELL  # execute a shell command
/usr/bin/zsh
$ exit  # exit shell
>

TUI

Vim

Translate --translators=google,bing Free as in Freedom

GUI

GNU/Linux

Android

Script

Python

>>> from translate_shell.translate import translate
>>> translate("The Mythical Man-Month", "zh_TW")
... Translation(
...     status=1,
...     results=[
...         {
...             "translator": "google",
...             "sl": "auto",
...             "tl": "zh_TW",
...             "text": "The Mythical Man-Month",
...             "phonetic": "",
...             "paraphrase": "人月神話",
...             "explains": {},
...             "details": {},
...             "alternatives": ["神话般的人月"],
...         }
...     ],
...     text="The Mythical Man-Month",
...     to_lang="zh_TW",
...     from_lang="auto",
... )

Shell Script

$ xsel -o | trans --format json | jq -r '"《\(.results[].paraphrase)》的英文是 \(.text)."'
《大教堂和集市》的英文是 the cathedral and the bazaar.

Vim Script

:let g:text = 'Just for Fun'
:let g:translation = json_decode(translate_shell#call('--format=json', g:text))
:echo g:text 'is' g:translation.results[0].paraphrase 'in Chinese.'
Just for Fun is 纯娱乐 in Chinese.

Features

• Translate with different translators at same time, like translator
• Translate clipboard contents automatically, like ydcv
• Speak the pronunciation of words
• Support online translate engines
• Support offline dictionaries
• Many methods to use, from shell, python and vim
• Magic text, like en: to change source language, :zh_CN to change target language, <file to translate file, etc.
• Allow customization by config.py
• Good shell completions, especially for zsh, complete options and translation history
• Manpage: man trans
• Beautiful UI
• Cross platforms
• Rich API, can be easily called from shell and python
• Good document
• Unit test, keep code quality
• CI/CD
• clean code
• Respect PEP484
• Respect PEP621
• Respect XDG

The last but not least: it is a libre software.

See document to know more.

PS: PR is welcome! Please make code clean and keep test pass!