Skip to content

Terminal user interface for the DeepL language translation API.

License

Notifications You must be signed in to change notification settings

DeepLcom/deepl-tui

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

31 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

DeepL TUI

deepl-tui is a terminal user interface for the DeepL language translation API.

Changelog

Notable changes to this project will be documented in the CHANGELOG.md

Installation

To install deepl-tui you can download a prebuilt binary that matches your system and place it in a directory that's part of your system's search path, e.g.

# download latest release archive
RELEASE_TAG=$(curl -sSfL https://api.github.com/repos/DeepLcom/deepl-tui/releases/latest | jq -r '.tag_name')
curl -sSfL -o /tmp/deepl-tui.tar.gz \
    https://github.com/DeepLcom/deepl-tui/releases/download/${RELEASE_TAG}/deepl-tui_${RELEASE_TAG}_linux_amd64.tar.gz

# extract executable binary into install dir (must exist)
INSTALL_DIR=$HOME/.local/bin
tar -C ${INSTALL_DIR} -zxof /tmp/deepl-tui.tar.gz deepl-tui

Usage

Since deepl-tui uses the DeepL API you'll need an API authentication key. To get a key, please create an account here. With a DeepL API Free account you can translate up to 500,000 characters per month.

You can either pass the authentication key as an environment variable or via the --auth-key option, i.e.

$ export DEEPL_AUTH_KEY="f63c02c5-f056..."  # replace with your key
$ deepl-tui

or

$ deepl-tui --auth-key=f63c02c5-f056...

Key bindings

Global

Action Keys Comment
Cycle through pages alt-tab
Quit the application ctrl-q

Translate Page

Action Keys Comment
Focus input text area alt-i
Focus source language dropdown alt-s Hit enter to list options
Focus target language dropdown alt-t Hit enter to list options
Focus formality option dropdown alt-f Hit enter to list options
Focus glossary option button alt-g Hit enter to open dialog

Glossaries Page

Action Keys Comment
Focus glossary entry form alt-e
Focus glossary info form alt-i
Focus glossaries list alt-l
Focus glossary entries table alt-t

License

This project is released under the MIT License.