Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/lifailon/multranslate
Cross-platform TUI for translating text in multiple translators simultaneously, with support for translation history and automatic language detection.
https://github.com/lifailon/multranslate
api better-sqlite3 blessed deepl deeplx google-translate javascript linux macos mymemory nodejs npm npm-package reverso sqlite3 translate translation translator tui windows
Last synced: 27 days ago
JSON representation
Cross-platform TUI for translating text in multiple translators simultaneously, with support for translation history and automatic language detection.
- Host: GitHub
- URL: https://github.com/lifailon/multranslate
- Owner: Lifailon
- License: mit
- Created: 2024-08-31T08:57:22.000Z (2 months ago)
- Default Branch: rsa
- Last Pushed: 2024-10-03T12:51:42.000Z (about 1 month ago)
- Last Synced: 2024-10-12T08:04:21.287Z (27 days ago)
- Topics: api, better-sqlite3, blessed, deepl, deeplx, google-translate, javascript, linux, macos, mymemory, nodejs, npm, npm-package, reverso, sqlite3, translate, translation, translator, tui, windows
- Language: JavaScript
- Homepage: https://npmjs.com/package/multranslate
- Size: 4.33 MB
- Stars: 4
- Watchers: 1
- Forks: 0
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
multranslate
English | Русский
A terminal user interface (TUI) based on the [Blessed](https://github.com/chjj/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](#-supported-languages), as well as access to **translation history** via [SQLite](https://github.com/WiseLibs/better-sqlite3) (up to 500 queries, after which the old values from history are automatically cleared).
## 📚 Translation providers
- [Google](https://translate.google.com) - free and unlimited [API](https://github.com/vitalets/google-translate-api) using [serverless](https://github.com/olavoparno/translate-serverless-vercel) hosted on Vercel. Available for translation more than 5000 characters.
- [DeepL](https://www.deepl.com) - free API via [DeepLX](https://github.com/OwO-Network/DeepLX) using [serverless](https://github.com/LegendLeo/deeplx-serverless) hosted on [Vercel](https://github.com/bropines/Deeplx-vercel). There are limitations on the number of frequent requests for translation, can have limitations when using a large number of
- [Reverso](https://www.reverso.net) - 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](https://mymemory.translated.net/doc/spec.php) - 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](https://www.npmjs.com/package/multranslate) package manager:
```shell
npm install -g multranslate
```
Run the application:
```shell
multranslate
```
Get help:
```shell
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 select language: ru, ja, zh, ko, ar, tr, uk, sk, pl, de, fr, it, es, el, hu, nl, sv,
ro, cs, da (default: "ru")
-t, --translator select translator: all, Google, DeepL, Reverso, MyMemory (default: "all")
-h, --help display help for command
```
## 🔨 Build
Clone the repository:
```shell
git clone https://github.com/Lifailon/multranslate
cd multranslate
```
Run the application:
```shell
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 |
| 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](https://github.com/Lifailon/multranslate/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+` - 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+` - 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()`.