1TRANS(1) TRANS(1)
2
6 trans - Command-line translator using Google Translate, Bing Transla‐
7 tor, Yandex.Translate, etc.
8
10 trans [OPTIONS] [SOURCE]:[TARGETS] [TEXT]...
11
13 This tool translates text into any language from the command-line, us‐
14 ing a translation engine such as Google Translate, Bing Translator and
15 Yandex.Translate.
16 Each argument which is not a valid option is treated as TEXT to be
18 translated.
19 If neither TEXT nor the input file is specified by command-line argu‐
21 ments, the program will read and translate from standard input.
22
24 Information options
25 -V, -version
26 Print version and exit.
27 -H, -help
29 Print help message and exit. -M, -man Show man page and exit.
30 -T, -reference
32 Print reference table of all supported languages and codes, and
33 exit. Names of languages are displayed in their endonyms (lan‐
34 guage name in the language itself).
35 -R, -reference-english
37 Print reference table of all supported languages and codes, and
38 exit. Names of languages are displayed in English.
39 -L CODES, -list CODES
41 Print details of languages and exit. When specifying two or
42 more language codes, concatenate them by plus sign "+".
43 -S, -list-engines
45 List available translation engines and exit.
46 -U, -upgrade
48 Check for upgrade of this program.
49 Translator options
51 -e ENGINE, -engine ENGINE
52 Specify the translation engine to use. (default: google)
53 Display options
55 -verbose
56 Verbose mode.
57 Show the original text and its most relevant translation, then
59 its phonetic notation (if any), then its alternative transla‐
60 tions (if any) or its definition in the dictionary (if it is a
61 word).
62 This option is unnecessary in most cases since verbose mode is
64 enabled by default.
65 -b, -brief
67 Brief mode.
68 Show the most relevant translation or its phonetic notation on‐
70 ly.
71 -d, -dictionary
73 Dictionary mode.
74 Show the definition of the original word in the dictionary.
76 -identify
78 Language identification.
79 Show the identified language of the original text.
81 -show-original Y/n
83 Show original text or not. (default: yes)
84 -show-original-phonetics Y/n
86 Show phonetic notation of original text or not. (default: yes)
87 -show-translation Y/n
89 Show translation or not. (default: yes)
90 -show-translation-phonetics Y/n
92 Show phonetic notation of translation or not. (default: yes)
93 -show-prompt-message Y/n
95 Show prompt message or not. (default: yes)
96 -show-languages Y/n
98 Show source and target languages or not. (default: yes)
99 -show-original-dictionary y/N
101 Show dictionary entry of original text or not. (default: no)
102 This option is enabled in dictionary mode.
104 -show-dictionary Y/n
106 Show dictionary entry of translation or not. (default: yes)
107 -show-alternatives Y/n
109 Show alternative translations or not. (default: yes)
110 -w NUM, -width NUM
112 Specify the screen width for padding.
113 This option overrides the setting of environment variable $COL‐
115 UMNS.
116 -indent NUM
118 Specify the size of indent (number of spaces). (default: 4)
119 -theme FILENAME
121 Specify the theme to use. (default: default)
122 -no-theme
124 Do not use any other theme than default.
125 -no-ansi
127 Do not use ANSI escape codes.
128 -no-autocorrect
130 Do not autocorrect. (if defaulted by the translation engine)
131 -no-bidi
133 Do not convert bidirectional texts.
134 -bidi Always convert bidirectional texts.
136 -no-warn
138 Do not write warning messages to stderr.
139 -dump Print raw API response instead.
141 Audio options
143 -p, -play
144 Listen to the translation.
145 You must have at least one of the supported audio players
147 (mplayer, mpv or mpg123) installed to stream from Google
148 Text-to-Speech engine. Otherwise, a local speech synthesizer
149 may be used instead (say on macOS, espeak on Linux or other
150 platforms).
151 -speak Listen to the original text.
153 -n VOICE, -narrator VOICE
155 Specify the narrator, and listen to the translation.
156 Common values for this option are male and female.
158 -player PROGRAM
160 Specify the audio player to use, and listen to the translation.
161 Option -play will try to use mplayer, mpv or mpg123 by default,
163 since these players are known to work for streaming URLs. Not
164 all command-line audio players can work this way. Use this op‐
165 tion only when you have your own preference.
166 This option overrides the setting of environment variable $PLAY‐
168 ER.
169 -no-play
171 Do not listen to the translation.
172 -no-translate
174 Do not translate anything when using -speak.
175 -download-audio
177 Download the audio to the current directory.
178 -download-audio-as FILENAME
180 Download the audio to the specified file.
181 Terminal paging and browsing options
183 -v, -view
184 View the translation in a terminal pager (less, more or most).
185 -pager PROGRAM
187 Specify the terminal pager to use, and view the translation.
188 This option overrides the setting of environment variable
190 $PAGER.
191 -no-view, -no-pager
193 Do not view the translation in a terminal pager.
194 -browser PROGRAM
196 Specify the web browser to use.
197 This option overrides the setting of environment variable
199 $BROWSER.
200 -no-browser
202 Do not open the web browser.
203 Networking options
205 -x HOST:PORT, -proxy HOST:PORT
206 Use HTTP proxy on given port.
207 This option overrides the setting of environment variables
209 $HTTP_PROXY and $http_proxy.
210 -u STRING, -user-agent STRING
212 Specify the User-Agent to identify as.
213 This option overrides the setting of environment variables $US‐
215 ER_AGENT.
216 -4, -ipv4, -inet4-only
218 Connect only to IPv4 addresses.
219 -6, -ipv6, -inet6-only
221 Connect only to IPv6 addresses.
222 Interactive shell options
224 -I, -interactive, -shell
225 Start an interactive shell, invoking rlwrap whenever possible
226 (unless -no-rlwrap is specified).
227 -E, -emacs
229 Start the GNU Emacs front-end for an interactive shell.
230 This option does not need to, and cannot be used along with -I
232 or -no-rlwrap.
233 -no-rlwrap
235 Do not invoke rlwrap when starting an interactive shell.
236 This option is useful when your terminal type is not supported
238 by rlwrap (e.g. emacs).
239 I/O options
241 -i FILENAME, -input FILENAME
242 Specify the input file.
243 Source text to be translated will be read from the input file,
245 instead of standard input.
246 -o FILENAME, -output FILENAME
248 Specify the output file.
249 Translations will be written to the output file, instead of
251 standard output.
252 Language preference options
254 -l CODE, -hl CODE, -lang CODE
255 Specify your home language (the language you would like to see
256 for displaying prompt messages in the translation).
257 This option affects only the display in verbose mode (anything
259 other than source language and target language will be displayed
260 in your home language). This option has no effect in brief
261 mode.
262 This option is optional. When its setting is omitted, English
264 will be used.
265 This option overrides the setting of environment variables
267 $LC_ALL, $LANG, and $HOME_LANG.
268 -s CODES, -sl CODES, -source CODES, -from CODES
270 Specify the source language(s) (the language(s) of original
271 text). When specifying two or more language codes, concatenate
272 them by plus sign "+".
273 This option is optional. When its setting is omitted, the lan‐
275 guage of original text will be identified automatically (with a
276 possibility of misidentification).
277 This option overrides the setting of environment variable
279 $SOURCE_LANG.
280 -t CODES, -tl CODES, -target CODES, -to CODES
282 Specify the target language(s) (the language(s) of translated
283 text). When specifying two or more language codes, concatenate
284 them by plus sign "+".
285 This option is optional. When its setting is omitted, every‐
287 thing will be translated into English.
288 This option overrides the setting of environment variables
290 $LC_ALL, $LANG, and $TARGET_LANG.
291 [SOURCE]:[TARGETS]
293 A simpler, alternative way to specify the source language and
294 target language(s) is to use a shortcut formatted string:
295 · SOURCE-CODE:TARGET-CODE
297 · SOURCE-CODE:TARGET-CODE1+TARGET-CODE2+...
299 · SOURCE-CODE=TARGET-CODE
301 · SOURCE-CODE=TARGET-CODE1+TARGET-CODE2+...
303 Delimiter ":" and "=" can be used interchangeably.
305 Either SOURCE or TARGETS may be omitted, but the delimiter char‐
307 acter must be kept.
308 Text preprocessing options
310 -j, -join-sentence
311 Treat all arguments as one single sentence.
312 Other options
314 -no-init
315 Do not load any initialization script.
316 -- End-of-options.
318 All arguments after this option are treated as TEXT to be trans‐
320 lated.
321
323 0 Successful translation.
324 1 Error.
326
328 PAGER Equivalent to option setting -pager.
329 BROWSER
331 Equivalent to option setting -browser.
332 PLAYER Equivalent to option setting -player.
334 HTTP_PROXY
336 Equivalent to option setting -proxy.
337 USER_AGENT
339 Equivalent to option setting -user-agent.
340 HOME_LANG
342 Equivalent to option setting -lang.
343 SOURCE_LANG
345 Equivalent to option setting -source.
346 TARGET_LANG
348 Equivalent to option setting -target.
349
351 /etc/translate-shell
352 Initialization script. (system-wide)
353 $HOME/.translate-shell/init.trans
355 Initialization script. (user-specific)
356 $XDG_CONFIG_HOME/translate-shell/init.trans
358 Initialization script. (user-specific)
359 ./.trans
361 Initialization script. (current directory)
362
364 <https://github.com/soimort/translate-shell/wiki>
365
367 <https://github.com/soimort/translate-shell/issues>
368
370 Mort Yao <soi@mort.ninja>.
3710.9.6.10 2019-04-20 TRANS(1)