TRANS(1)

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.

AUTHOR
Written by Wu Zhenyu <wuzhenyu@ustc.edu>

REPORTING BUGS
Report bugs to https://github.com/Freed-Wu/translate-shell/issues

COPYRIGHT
Copyright © 2023