DeepL CLI

DeepL CLI is a simple command-line tool for the DeepL API, written in Crystal.

• Supports document translation
• Supports glossaries
• Precompiled binaries available

Installation

Download

• Download the Linux binary from the Releases
• Unzip: tar -xvf deepl.tar.gz
• Move to the executable path: sudo mv deepl /usr/local/bin/

Note: Binaries for Linux are statically linked. For macOS, we recommend using homebrew.

Homebrew

brew install kojix2/brew/deepl-cli

Proxy settings (optional)

export HTTP_PROXY=http://[IP]:[port]
export HTTPS_PROXY=https://[IP]:[port]

Prerequisites

You will need an API key for DeepL. Create one here and set it as an environment variable:

export DEEPL_AUTH_KEY=your_api_key_here

Usage

deepl [options] <file>

Translate text

deepl [options] <file>

Options:

    -i, --input TEXT                 Input text
    -f, --from [LANG]                Source language [AUTO]
    -t, --to [LANG]                  Target language [EN]
    -g, --glossary ID                Glossary ID
    -F, --formality OPT              Formality (default more less)
    -C, --context TEXT               Context (experimental)
    -S, --split-sentences OPT        Split sentences
    -A, --ansi                       Do not remove ANSI escape codes

Note: ANSI escape sequences are removed by default.

Translate documents

To translate a document, use the doc subcommand:

deepl doc [options] <file>

Options for document translation:

    -f, --from [LANG]                Source language [AUTO]
    -t, --to [LANG]                  Target language [EN]
    -g, --glossary ID                Glossary ID
    -F, --formality OPT              Formality (default more less)
    -o, --output FILE                Output file
    -O, --output-format FORMAT       Output file format

Manage Glossaries

For glossary management, use the glossary subcommand:

deepl glossary [options]

Options for glossary management:

    list                             List glossaries
    create                           Create a glossary
    delete                           Delete a glossary
    view                             View a glossary
    -l, --list                       List glossaries
    -p, --language-pairs             List language pairs

Examples

Below are examples for translating text, translating documents, and working with glossaries.

Translate Text

To translate the text "Hola mundo" from Spanish (ES) to English (EN):

deepl -i "Hola mundo" -t en        # Translation: Hello world

Or, using standard input:

echo "Hola mundo" | deepl -t en    # Translation: Hello world

Standard input translation is useful for quick references.

git --help | deepl -t fr | less

The man command can also be translated (by removing ANSI escape sequences):

man git | deepl -t de | less

To translate multiple lines, press Ctrl+D when you have finished typing. This is particularly useful when copying and pasting from the clipboard.

deepl -f es
# Hola
# mundo
# Ctrl + D

(Experimental feature) Translate text from the clipboard:

deepl --paste

You can also pass a text file as an argument:

deepl -t pl foo.txt

It's possible to pass multiple text files:

deepl -t nl foo.txt bar.txt

If you are translating multiple files, you might want to add the filename to the header:

bat --style header *.txt | deepl -t it

Translate documents

You can directly translate documents:

deepl doc your.pdf -t pt
# The translated document will be saved as your_EN.pdf

You can also translate multiple documents:

find . -name "*.pdf" -exec deepl doc -t ja {} +

ls -1 *.docx | xargs -L1 deepl doc -t ko

fd -e pdf -e docx -x deepl doc -t zh

Glossaries

To create a glossary:

deepl glossary create -n mydic -f ru -t pt mydict.tsv

To list glossaries:

deepl glossary list
# or you can use shorthand: deepl glossary -l

To use a glossary for translation:

deepl -g mydict

deepl doc -g mydict

To display the contents of the glossary:

deepl glossary view -n mydict

To list the languages in which glossaries can be created:

deepl glossary -p

Information

To display a list of available source languages:

deepl -f

To display a list of available target languages:

deepl -t

To output usage information:

deepl -u

# https://api.deepl.com/v2
# character_count: 614842
# character_limit: 1000000000000

Development

Contributions are always welcome.

• Report bugs
• Fix bugs and submit pull requests
• Write, clarify, or fix documentation
• Suggest or add new features

Compilation from source code

git clone https://github.com/kojix2/deepl-cli
cd deepl-cli
shards build --release
# sudo cp bin/deepl /usr/local/bin

A compiled binary file will be created in the bin directory.

DeepL API Library

• https://github.com/kojix2/deepl.cr/

License

This project is licensed under the MIT License.

Happy translating!