[{"_1":2,"_161":-5,"_162":-5},"loaderData",{"_3":4,"_13":14,"_20":21,"_138":139},"root",{"_5":-5,"_6":-7,"_7":8,"_9":-7,"_10":11,"_12":-7},"currentUser","primaryEmail","siteVerification","6LeIxAcTAAAAAJcZVRqyHh71UMIEGNQ_MXjiZKhI","toast","enableDev",false,"incidentStatus","routes/_layout",{"_15":-5,"_16":17,"_18":17,"_19":11},"username","isAskGordonEnabled",true,"isUsingNewTemplate","showMinimalLanding","routes/_layout.r.$namespace.$reponame",{"_22":23,"_24":-5,"_25":11,"_26":11,"_27":28,"_29":30,"_31":-5,"_32":11,"_33":34,"_90":-5,"_91":92,"_131":-5,"_132":11,"_133":17,"_134":11,"_135":-5,"_136":137},"canonicalUrl","https://hub.docker.com/r/lifailon/multranslate/tags","mcpServer","canSeeDockerfile","canSeeAutobuilds","namespace","lifailon","reponame","multranslate","cloudBuildSource","isAutobuildsAvailable","repo",{"_35":36,"_45":46,"_48":49,"_50":51,"_52":11,"_53":54,"_55":56,"_57":58,"_38":30,"_27":28,"_60":61,"_62":47,"_63":64,"_65":66,"_67":68,"_69":-5,"_70":64,"_71":72,"_73":11,"_74":28,"_75":76,"_81":11,"_82":83,"_87":28,"_88":89},"categories",[37,42],{"_38":39,"_40":41},"name","Machine learning & AI","slug","machine-learning-and-ai",{"_38":43,"_40":44},"Developer tools","developer-tools","content_types",[47],"image","date_registered","2025-03-31T17:28:07.468899Z","description","Cross-platform TUI for translating text in multiple translators simultaneously as well as LLM.","is_private","last_updated","2025-03-31T18:12:17.677047Z","last_modified","2025-03-31T18:17:49.491222Z","media_types",[59],"application/vnd.docker.container.image.v1+json","pull_count",681,"repository_type","star_count",0,"status",1,"status_description","active","source","collaborator_count","full_description","

\n multranslate\n

\n\n

\n $\"NPM\"src=\"https://img.shields.io/npm/v/multranslate?logo=npm&logoColor=red\"$ \n $\"Docker\"$ \n $\"Language\"src=\"https://img.shields.io/github/languages/top/Lifailon/multranslate?logo=JavaScript&color=yellow\"$ \n $\"License\"src=\"https://img.shields.io/github/license/Lifailon/multranslate?logo=readme&logoColor=white&color=white\"$ \n

\n\n

\n English | Русский\n

\n\nCross-platform terminal user interface based on the [Blessed](https://github.com/chjj/blessed) library for simultaneous text translation using several popular translation sources and `LLM`. All sources do not require an API access token (with the exception of official OpenAI or OpenRouter). 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 requests, after which old records from the history are automatically cleared).\n\n![interface](/image/interface.jpg)\n\n## Translation providers\n\n- [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 the Vercel platform. Available for translation more than 5000 characters.\n- [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) platform. There are limits on the number of translation requests that can be made frequently, and there may also be a limit on the number of characters that can be used (the official limit is 5000 characters per request).\n- [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 in the application, through the `API` can get up to 8000). Does not contain official documentation, request was received from official site via *DevTools*.\n- [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.\n- [LLM](https://en.wikipedia.org/wiki/Large_language_model) - using large language models with a pre-installed system `prompt` for text translation or in chat mode with support for streaming responses.\n- - [OpenAI](https://platform.openai.com/docs/overview) is the official provider of the `ChatGPT` model. To use, you must pass the `API` key via the `--key` parameter (has a higher priority) or use the `OPENAI_API_KEY` environment variable (similarly for `OpenRouter`).\n- - [OpenRouter](https://openrouter.ai) is a universal provider that provides unified access to different models. Supports free models (e.g. [DeepSeek R1](https://openrouter.ai/deepseek/deepseek-r1:free)), allowing you to use it without replenishing your account immediately after registration. To use, you need to pass the url and the `API` key via parameters or environment variables, similar to `OpenAI`.\n- - [LM Studio](https://lmstudio.ai) is an interface for running and using local models in offline mode (the `API` request and response scheme corresponds to `OpenAI`). It is recommended to choose a model pre-trained in the desired language (for example, using the `translation` filter on [Hugging Face](https://huggingface.co/models?pipeline_tag=translation)).\n\n## Install\n\nUse the [NPM](https://www.npmjs.com/package/multranslate) package manager to install a stable version:\n\n```shell\nnpm install -g multranslate\n```\n\nOr install from the GitHub repository:\n\n```shell\nnpm install -g https://github.com/Lifailon/multranslate\n```\n\nRun the application:\n\n```shell\nmultranslate\n```\n\nGet help:\n\n```shell\nmultranslate --help\n\nUsage: multranslate [options]\n\nCross-platform TUI for translating text in multiple translators simultaneously and LLM, with support for\ntranslation history and automatic language detection.\n\nOptions:\n -V, --version output the version number\n -l, --language Select the language: ru, ja, zh, ko, ar, tr, uk, sk, pl, de, fr, it, es, el, hu, nl,\n sv, ro, cs, da, pt, vi (default: \"ru\" or the environment \"TRANSLATE_LANGUAGE\")\n -t, --translator Select the translator: all, Google, DeepL, Reverso, MyMemory, OpenAI (default: \"all\")\n -k, --key API key parameter for OpenAI (high priority) or using the environment \"OPENAI_API_KEY\"\n -u, --urlOpenai Url address for OpenAI, OpenRouter or local LLM API (default: \"https://api.openai.com\"\n or the environment \"OPENAI_URL\")\n -m, --model Select the LLM model (default: \"gpt-4o-mini\" or the environment \"OPENAI_MODEL\")\n -e, --temp Select the temperature for LLM (default: \"0.7\" or the environment \"OPENAI_TEMP\")\n -h, --help display help for command\n```\n\nTo use `OpenAI`, you need to pass parameters to connect to `API` (has high priority) or use environment variables (recommended).\n\n### OpenAI\n\nUsing environment variables in **Linux**:\n\n```Bash\nexport OPENAI_API_KEY=\"sk-proj-...\"\nmultranslate\n```\n\nYou can save the environment variable for later use after reconnecting to the current terminal session.\n\n```Bash\necho 'export OPENAI_API_KEY=\"sk-proj-...\"' >> ~/.bashrc\nsource ~/.bashrc\nmultranslate\n```\n\nIt is recommended to make changes to the profile file through any text editor, for example, `nano`, so that the key content is not saved in the command history.\n\n### OpenRouter\n\nUsing the `DeepSeek R1` free model via parameters:\n\n```Bash\nmultranslate -u \"https://openrouter.ai/api\" -m \"deepseek/deepseek-r1:free\" -k \"sk-or-v1-...\"\n```\n\nNote that the default `/v1/chat/completions` append path is used for all requests.\n\n### LM Studio\n\nUsing environment variables in **Windows**:\n\n```PowerShell\n$env:OPENAI_URL = \"http://127.0.0.1:1234\"\n$env:OPENAI_MODEL = \"llama-3-8b-gpt-4o-ru1.0\"\nmultranslate\n```\n\nSave variables in the current user's environment via `PowerShell` for later use:\n\n```PowerShell\n[System.Environment]::SetEnvironmentVariable(\"OPENAI_API_KEY\", \"sk-or-v1-...\", \"User\")\n[System.Environment]::SetEnvironmentVariable(\"OPENAI_URL\", \"https://openrouter.ai/api\", \"User\")\n[System.Environment]::SetEnvironmentVariable(\"OPENAI_MODEL\", \"deepseek/deepseek-r1:free\", \"User\")\n```\n\nTo apply, restart the terminal.\n\n## Build\n\nClone the repository:\n\n```shell\ngit clone https://github.com/Lifailon/multranslate\ncd multranslate\n```\n\nInstall dependencies and run the application:\n\n```shell\nnpm install\nnpm start\n```\n\n## Docker\n\nConfigure the [env](.env) environment variable file for language selection and connection to the LLM.\n\nBuild the image and run a temporary container (`volume` is used to store history between runs):\n\n```shell\ndocker build -t multranslate .\ndocker run --env-file .env -it --rm -v multranslate:/multranslate multranslate\n```\n\n## Supported languages\n\nYou can change the language for automatic definition between English and any of those presented in the table below:\n\n| Parameter | Language |\n| - | - |\n| ru | Russian (default) |\n| ja | Japanese |\n| zh | Chinese |\n| ko | Korean |\n| ar | Arabic |\n| tr | Turkish |\n| uk | Ukrainian |\n| sk | Slovak |\n| pl | Polish |\n| de | German |\n| fr | French |\n| it | Italian |\n| es | Spanish |\n| el | Greek |\n| hu | Hungarian |\n| nl | Dutch |\n| sv | Swedish |\n| ro | Romanian |\n| cs | Czech |\n| da | Danish |\n| pt | Portuguese ([#1](https://github.com/Lifailon/multranslate/issues/1)) |\n| vi | Vietnam ([#2](https://github.com/Lifailon/multranslate/issues/2)) |\n\nAll passed letters are analyzed to compare them between the English alphabet and the language specified in the `--language` parameter.\n\nYou can also use any of the translators individually by specifying the appropriate option at startup:\n\n\n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n

`multranslate --translator Google --language tr`\n	`multranslate --translator DeepL --language de`\n

`multranslate --translator Reverso --language it`\n	`multranslate --translator MyMemory --language es`\n

\n\n## Hotkeys\n\n- `Ctrl+` - translation of text without breaking to a new line.\n- `Ctrl+V` - paste text from the clipboard (defined at the code level).\n- `Alt+C` - copy text from the input field to clipboard.\n- `Alt+<1/2/3/4/5>` - copying translation results from output window to the clipboard (for each translator, the key combination is indicated in brackets), and the selected form will change its color to green.\n- `Ctrl+` - move to the previous entry in the translation history.\n- `Ctrl+

` - move to the next entry in the translation history.\n- `Shift+` - simultaneous scrolling of all output panels.\n- `Ctrl+` - scrolling the text input panel without changing the cursor position.\n- `Ctrl+` - quick cursor navigation through phrases.\n- `Ctrl+` - move the cursor to the ahead or end of text input.\n- `Ctrl+` - clear the text input field.\n- `Ctrl+W/Alt+Back` - delete the word before the cursor.\n- `Del/Ctrl+K` - deletes one letter or character after the cursor.\n- `F2` - switch to OpenAI with a preset translation prompt.\n- `F3` - switch to OpenAI in chat mode.\n- `Escape` - exit the program.\n\nUse the `F1` key to get help on available keyboard shortcuts:\n\n![interface](/image/hotkeys.jpg)\n\n## Contributing\n\nIf your language is not listed or you have problems with translation, please open an issue in the [Issues](https://github.com/Lifailon/multranslate/issues).\n\nYou can also offer another source for translating the text through `API`, which does not require an access key.\n\nIf you like to use this interface, you can make a contribution, just translate this readme file to your own language and pass it through [Pull Request](https://github.com/Lifailon/multranslate/pulls).\n\n## Backlog\n\n- Rewrite code to `TypeScript`.\n- Write tests to check the functions of translation.\n- Implement native cursor support (developments in [multranslate-native-cursor](multranslate-native-cursor.js)).\n- Check texts for style and grammar (spelling) via [LanguageTool](https://languagetool.org/http-api).\n- Add support for storing and clearing history via `SQLite` for `LLM` in chat mode.\n\n## Text buffer\n\nThe Blessed library is great and has no analogues in its functionality for `JavaScript` or `TypeScript` (and even surpasses some libraries in other languages), but it is outdated (not supported since 2015) and has a number of technical limitations, for example, there is no ability to navigate the cursor in the text input field. For this reason, a mechanism for managing the input content through a text buffer was implemented, which allows you to use a custom cursor for navigation using keyboard arrows and automatic scrolling.\n\nIf you plan to use this library for similar tasks where text input is required, then add `class TextBuffer` and control of hotkeys (`keypress`) via `inputBox.on()` to your code. It took me several weeks to achieve full functionality for working with text, the key problem is the built-in line break (`autowrap`) and the shift of the custom cursor.\n\nOver the course of daily use for 6 months, I can confirm that it works stably.\n\n## License\n\nThis project is licensed under the **MIT License**. See the [LICENSE](LICENSE) file for details.\n\nCopyright (C) 2024 Lifailon (Alex Kup)\n","has_starred","hub_user","immutable_tags_settings",{"_77":11,"_78":79},"enabled","rules",[80],".*","is_automated","permissions",{"_84":17,"_85":11,"_86":11},"read","write","admin","user","storage_size",69715439,"orgData","recentTags",[93],{"_94":47,"_95":96,"_97":98,"_99":100,"_101":102,"_103":104,"_53":120,"_121":96,"_122":28,"_123":59,"_38":124,"_125":126,"_127":111,"_128":120,"_129":68,"_130":17},"content_type","creator",23112928,"digest","sha256:044dfc8de09925609079c28f4e8df63e5c60f83060c852b6bde724e39aca26a8","full_size",57310354,"id",873625004,"images",[105],{"_106":107,"_97":98,"_108":109,"_110":111,"_112":113,"_114":115,"_116":109,"_117":-5,"_118":100,"_65":68,"_119":-5},"architecture","amd64","features","","last_pulled","2026-09-15T05:12:30.03847161Z","last_pushed","2025-03-31T18:12:16.027152109Z","os","linux","os_features","os_version","size","variant","2025-03-31T18:12:16.604196Z","last_updater","last_updater_username","media_type","latest","repository",26905122,"tag_last_pulled","tag_last_pushed","tag_status","v2","sbxKitMetadata","isPotentialSpam","isHubSbxKitsEnabled","displaySecurityMetadata","tagAttestations","tagsHaveAttestations",[],"routes/_layout.r.$namespace.$reponame.tags",{"_33":140,"_149":150,"_136":159,"_160":11},{"_35":141,"_45":144,"_48":49,"_50":51,"_52":11,"_53":54,"_55":56,"_57":145,"_38":30,"_27":28,"_60":61,"_62":47,"_63":64,"_65":66,"_67":68,"_69":-5,"_70":64,"_71":72,"_73":11,"_74":28,"_75":146,"_81":11,"_82":148,"_87":28,"_88":89},[142,143],{"_38":39,"_40":41},{"_38":43,"_40":44},[47],[59],{"_77":11,"_78":147},[80],{"_84":17,"_85":11,"_86":11},"tags",{"_151":66,"_152":-5,"_153":-5,"_154":155},"count","next","previous","results",[156],{"_94":47,"_95":96,"_97":98,"_99":100,"_101":102,"_103":157,"_53":120,"_121":96,"_122":28,"_123":59,"_38":124,"_125":126,"_127":111,"_128":120,"_129":68,"_130":17},[158],{"_106":107,"_97":98,"_108":109,"_110":111,"_112":113,"_114":115,"_116":109,"_117":-5,"_118":100,"_65":68,"_119":-5},[],"canDeleteTags","actionData","errors"]

lifailon/multranslate

Tags for lifailon/multranslate