Man¶

Name¶

trans - Translate text by google, bing, youdaozhiyun, haici, stardict, openai, large language model of local machine, etc at same time from CLI, GUI (GNU/Linux, Android, macOS and Windows), REPL, python, shell and vim.

Synopsis¶

trans [-h] [-V] [—-print-completion {bash,zsh,tcsh}] [—-print-setting [{config_file,history_file,dictionary_dirs,translators,languages,formats,clipper,speaker,dictionary_priorities}]] [-v] [-q] [—-lsp] [—-no-clipboard | —-clipboard] [—-no-notification | —-notification] [—-sleep-seconds SLEEP_SECONDS] [—-config CONFIG] [—-format {json,yaml,text}] [—-translators TRANSLATORS] [—-target-lang TARGET_LANG] [—-source-lang SOURCE_LANG] [—-options OPTIONS] [text …]

Description¶

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

Positional arguments¶

text¶

text needed to be translated, empty means entering REPL

Options¶

-h, —-help¶

show this help message and exit

-V, —-version¶

show program’s version number and exit

—-print-completion {bash,zsh,tcsh}¶

print shell completion script

—-print-setting [{config_file,history_file,dictionary_dirs,translators,languages,formats,clipper,speaker,dictionary_priorities}]¶

print some setting

-v, —-verbose¶

increase logger level

-q, —-quiet¶

reduce logger level

—-lsp¶

start language server

—-no-clipboard¶

disable clipboard

—-clipboard¶

enable clipboard (default)

—-no-notification¶

disable notification

—-notification¶

enable notification (default)

—-sleep-seconds SLEEP_SECONDS¶

avoid checkout clipboard too frequently. default: 0.1

—-config CONFIG¶

use a python file as config

—-format {json,yaml,text}¶

output format for jq(1), yq(1). default: text

—-translators TRANSLATORS¶

translate engines joined with ‘,’. default: google

—-target-lang TARGET_LANG¶

target languages. default: auto

—-source-lang SOURCE_LANG¶

source languages. default: auto

—-options OPTIONS¶

advanced usage, see https://translate- shell.readthedocs.io/en/latest/resources/config.html . default: []

Environment¶

LANG¶

When target_lang is “auto”, will use LANG as target_lang. If LANG is empty, will use zh_CN.

XDG_CONFIG_HOME¶

See https://specifications.freedesktop.org/basedir-spec/basedir-spec-latest.html

XDG_DATA_HOME¶

Same as above.

XDG_DATA_DIR¶

Same as above.

HOME¶

User’s home directory.

SHELL¶

User’s shell.

Files¶

…/config.py¶

Config file can be seen by:

trans ----print-setting config_file

…/history.txt¶

History file can be seen by:

trans ----print-setting history_file

…/stardict/dic/¶

stardict dictionary directory like STARDICT_DATA_DIR of sdcv(1) can be seen by:

trans ----print-setting stardict_dirs

Examples¶

clipper | trans¶

Translate clipboard. Clipper can be seen by

trans ----print-setting clipper

trans Free as in Freedom¶

Translate by CLI.

trans¶

Translate by REPL.