dptran
English | 日本語版はこちら
A tool to run DeepL translations on your command line.
It's written in Rust, and uses curl to connect to the DeepL API.
To use, you need to get the DeepL API key from https://www.deepl.com/en/pro-api/.
Installation
Binary crate
dptran is available on crates.io.
- Install
rustuporcargoto your computer. - run this:
Library crate
dptran includes the binary crate's dependent crates (such as clap, serde_json and confy) by the default features.
To install only the library crate, please disable the default features by adding --no-default-features argument.
Or, add this to your Cargo.toml:
[]
= { = "2.1.1", = false }
Binary crate
The binary crate provides a command-line tool to translate text using the DeepL API.
Features
- Translate text from the command line arguments.
- Translate text interactively.
- Translate multiple lines.
- Translate text from the pipeline.
- Translate text from a file. (v2.1.0-)
- Translate text from an editor. (v2.1.0-)
- Remove line breaks from the source text. (v2.1.0-)
- Output to a text file. (v2.1.0-)
- Check the number of characters remaining to be translated.
- Check valid language codes.
- Cache the translation results. (v2.1.0-)
Language codes
If you omit the destination language option, the translation will be done in English (EN) by default.
For more information about language codes, see the language list getting from DeepL API:
)
)
) )
)
) )
Usage
Setting API key
Please be sure to get your DeepL API key and set it up on dptran before using the service.
The API key is available for free (up to 500,000 characters per month).
https://www.deepl.com/en/pro-api/
Translate from the command line arguments
If any language is not specified, the source language is automatically detected and the destination language is set to English (EN) by default.
It is possible to specify the source language with the -f option and the destination language with the -t option.
Translate in interactive mode
> ありがとうございます。
> Ich
> La
> 今天玩儿得真开心！
> quit
Multiple source texts can be translated interactively.
Exit with quit.
If you want to translate the source texts into a specific language, use the -t option.
Translate multiple lines
To enter multiple lines, use the -m option.
Then enter a blank line to send the input.
> A
Translate from the pipeline
You can translate the output of other commands with dptran.
e.g. Translate the content of the man page into Japanese.
| |
Translate from a file
You can translate the contents of a text file with dptran by using the -i option.
Translate from an editor application (e.g. vi, vim, nano, emacs, etc.)
You can translate the contents from an editor with dptran by using the -e option.
Example: vi
Example: vim
Example: nano
Example: emacs
Remove line breaks
You can remove line breaks from the source text with the -r option.
For example, the following input (in the editor):
will be translated as one line like this:
Output to a text file
You can output the translation result to a text file with the -o option.
Show help
For more information about commands, see help:
Displays the number of characters remaining to be translated
)
You can see the number of remaining characters that can be translated by DeepL API in the current month.
The free DeepL API plan lets you translate up to 500,000 characters per month.
Change default target language
It is set to English (EN) by default.
You can change it with set --target-lang.
For example, to change it to Japanese (JA), do the following:
Reset settings
You can reset all settings.
Note: The API key will be reset as well. If you wish to use dptran again, please set the API key again.
Uninstall
Library crate (v2.0.0-)
See the documentation for the library crate here.