multranslate
v0.5.2
Published
Cross-platform TUI for translating text in multiple translators simultaneously, with support for translation history and automatic language detection.
Downloads
102
Maintainers
Readme
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:
⌨ 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()
.