deepl command line utility¶ ↑

Unix-style commandline application for integrating the DeepL API into toolchains without any programming effort.

If you are looking for the deepl-api API library, please refer to its documentation instead.

Requirements¶ ↑

You need to have a valid DeepL Pro Developer account with an associated API key. This key must be made available to the application, e. g. via environment variable:

export DEEPL_API_KEY=YOUR_KEY

Examples¶ ↑

Overview¶ ↑

To get an overview of the available commands, just invoke the program.

shell> deepl
Usage: deepl [OPTIONS] COMMAND [ARGS]...

Options:
  --help  Show this message and exit.

Commands:
  languages
  translate
  usage-information

You can call deepl help translate to get a detailed reference for the various options of the translate command, for example.

Translating Text¶ ↑

By default, deepl reads from STDIN and writes to STDOUT, which means that you can integrate it nicely into toolchains.

shell> echo "Please go home." | deepl translate --source-language EN --target-language DE | cat -
Bitte gehen Sie nach Hause.

By providing the options --input-file and / or --output-file, you can tell deepl to read from / write to files, rather than STDIN / STDOUT.

Retrieving Account Usage & Limits¶ ↑

shell> deepl usage-information
Available characters per billing period: 250000
Characters already translated in the current billing period: 3317

Retrieving Available Languages¶ ↑

shell> deepl languages
DeepL can translate from the following source languages:
  DE    (German)
  EN    (English)
  ES    (Spanish)
  ...

DeepL can translate to the following target languages:
  DE    (German)
  EN-GB (English (British))
  EN-US (English (American))
  ES    (Spanish)
  ...