multranslate

English | Русский

A terminal user interface (TUI) based on the Blessed library for simultaneous text translation using multiple translation sources. All sources do not require an access token or other settings. Supports automatic source and target language definition at code level between English and any of the supported languages, as well as access to translation history via SQLite (up to 500 queries, after which the old values from history are automatically cleared).

📚 Translation providers

• Google - free and unlimited API using serverless hosted on Vercel. Available for translation more than 5000 characters.
• DeepL - free API via DeepLX using serverless hosted on Vercel. There are limitations on the number of frequent requests for translation, can have limitations when using a large number of
• Reverso - the most stable, free and without any limitation on the number of characters (version on the site is limited to 2000 characters and 900 through the application, through the API can get up to 8000). Does not contain official documentation, request was received from official site via DevTools.characters (official limit of 5000 characters per request).
• MyMemory - free and open API (limit of 500 characters per request). Supports up to 3 response options for short queries.

⚠ Reverso does not support working via Axios (error: Invalid header value char), Fetch is used instead.

🚀 Install

Use the npm package manager:

npm install -g multranslate

Run the application:

multranslate

Get help:

multranslate --help

Usage: multranslate [options]

Cross-platform TUI for translating text in multiple translators simultaneously, with support for translation
history and automatic language detection.

Options:
  -V, --version            output the version number
  -l, --language <name>    select language: ru, ja, zh, ko, ar, tr, uk, sk, pl, de, fr, it, es, pt, el, hu, nl, sv,
                           ro, cs, da (default: "ru")
  -t, --translator <name>  select translator: all, Google, DeepL, Reverso, MyMemory (default: "all")
  -h, --help               display help for command

🔨 Build

Clone the repository:

git clone https://github.com/Lifailon/multranslate
cd multranslate

Run the application:

npm start

💬 Supported languages

You can change the language to automatically detect the language between English and any of those in the table below:

Parameter	Language
ru	Russian (default)
ja	Japanese
zh	Chinese
ko	Korean
ar	Arabic
tr	Turkish
uk	Ukrainian
sk	Slovak
pl	Polish
de	German
fr	French
it	Italian
es	Spanish
pt	Portuguese
el	Greek
hu	Hungarian
nl	Dutch
sv	Swedish
ro	Romanian
cs	Czech
da	Danish

If a language is not on the list or if you have problems with translation, please open a request under Issues.

You can also use any of the translators individually by specifying the appropriate option at startup:

multranslate --translator Google --language tr	multranslate --translator DeepL --language de
multranslate --translator Reverso --language it	multranslate --translator MyMemory --language es

⌨ Hotkeys

• Enter - is used each time to translate the text simultaneously with moving to a new line.

• Ctrl+<Q/W/E/R> - copying translation results from output forms to the clipboard (for each translator, the key combination is indicated in brackets), and the selected form will change its color to green.

• Ctrl+V - paste text from the clipboard (defined at the code level).

• Ctrl+Z: Navigate through the history of translation requests from the end.

• Ctrl+X: Navigate through the translation history in reverse order.

• Shift+<⬆/⬇> - simultaneous scrolling of all output panels.

• Ctrl+<⬆/⬇> - scrolling the text input panel without navigation.

• Ctrl+<⬅/➡> - quick cursor navigation through phrases.

• Ctrl+<A/D> - move the cursor to the beginning or end of text input.

• Ctrl+Del - delete the phrase before the cursor.

• Ctrl+C - clear the text input field.

• Escape - exit the program.

To get hotkey help, use the keyboard shortcut: Ctrl+S

💡 Text buffer

The Blessed library is outdated (no longer supported) and has a number of technical limitations, such as not being able to navigate the cursor in the input field. For this reason, a mechanism for managing input text via text buffer has been implemented, which allows using a custom cursor for navigation using keyboard arrows and automatic scrolling for swiping.

If you plan to use this library for similar tasks where text input is required, then add class TextBuffer and control of keypress shortcuts to your code via inputBox.on().