{"id":13454350,"url":"https://github.com/crow-translate/crow-translate","last_synced_at":"2025-10-03T02:31:19.229Z","repository":{"id":37734342,"uuid":"122614130","full_name":"crow-translate/crow-translate","owner":"crow-translate","description":"A simple and lightweight translator that allows you to translate and speak text using Google, Yandex Bing, LibreTranslate and Lingva.","archived":true,"fork":false,"pushed_at":"2024-07-04T15:06:19.000Z","size":28436,"stargazers_count":1819,"open_issues_count":106,"forks_count":160,"subscribers_count":31,"default_branch":"master","last_synced_at":"2024-09-29T07:41:28.610Z","etag":null,"topics":["bing","dbus-api","google","libretranslate","lingva","linux","ocr","qt5","translator","windows","yandex"],"latest_commit_sha":null,"homepage":"https://crow-translate.github.io/","language":"C++","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/crow-translate.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"COPYING","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2018-02-23T11:41:36.000Z","updated_at":"2024-09-29T07:31:31.000Z","dependencies_parsed_at":"2024-01-29T02:29:46.447Z","dependency_job_id":"6f5b81a2-ddc6-4be3-a540-9a5557139c4c","html_url":"https://github.com/crow-translate/crow-translate","commit_stats":{"total_commits":1374,"total_committers":43,"mean_commits":"31.953488372093023","dds":0.08515283842794763,"last_synced_commit":"3ee31549c37c3391d26e06bb2fd343079e8ad5e3"},"previous_names":[],"tags_count":63,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/crow-translate%2Fcrow-translate","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/crow-translate%2Fcrow-translate/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/crow-translate%2Fcrow-translate/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/crow-translate%2Fcrow-translate/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/crow-translate","download_url":"https://codeload.github.com/crow-translate/crow-translate/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":235064305,"owners_count":18930088,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["bing","dbus-api","google","libretranslate","lingva","linux","ocr","qt5","translator","windows","yandex"],"created_at":"2024-07-31T08:00:53.282Z","updated_at":"2025-10-03T02:31:18.645Z","avatar_url":"https://github.com/crow-translate.png","language":"C++","funding_links":[],"categories":["C++","Overview","🖥 Desktop apps for translation management","Apps"],"sub_categories":["Google Translate","Python","Automated translation"],"readme":"\u003e [!IMPORTANT]  \n\u003e The project has migrated under the KDE umbrella, and development will continue at https://invent.kde.org/office/crow-translate.\n\n# ![Crow Translate logo](data/icons/app/48-apps-crow-translate.png) Crow Translate\n\n[![GitHub (pre-)release](https://img.shields.io/github/release/crow-translate/crow-translate/all.svg)](https://github.com/crow-translate/crow-translate/releases)\n[![Crowdin](https://badges.crowdin.net/crow-translate/localized.svg)](https://crowdin.com/project/crow-translate)\n\n**Crow Translate** is a simple and lightweight translator written in **C++ / Qt** that allows you to translate and speak text using Google, Yandex, Bing, LibreTranslate and Lingva translate API.\nYou may also be interested in my library [QOnlineTranslator](https://github.com/crow-translate/QOnlineTranslator \"A library for Qt5 that provides free usage of Google, Yandex, Bing, LibreTranslate and Lingva translate API.\") used in this project.\n\n## Content\n\n- [Screenshots](#screenshots)\n- [Features](#features)\n- [Default keyboard shortcuts](#default-keyboard-shortcuts)\n- [CLI commands](#cli-commands)\n- [D-Bus API](#d-bus-api)\n- [Global shortcuts in Wayland](#global-shortcuts-in-wayland)\n- [Dependencies](#dependencies)\n- [Icons](#icons)\n- [Installation](#installation)\n- [Building](#building)\n- [Localization](#localization)\n\n## Screenshots\n\n**Plasma**\n\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"https://raw.githubusercontent.com/crow-translate/crow-translate.github.io/master/static/screenshots/plasma/main.png\" alt=\"Main\"/\u003e\n\u003c/p\u003e\n\n**Plasma Mobile**\n\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"https://raw.githubusercontent.com/crow-translate/crow-translate.github.io/master/static/screenshots/plasma-mobile/main-landscape.png\"alt=\"Main\"/\u003e\n\u003c/p\u003e\n\n**Windows 10**\n\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"https://raw.githubusercontent.com/crow-translate/crow-translate.github.io/master/static/screenshots/windows/main.png\" alt=\"Main\"/\u003e\n\u003c/p\u003e\n\n## Features\n\n- Translate and speak text from screen or selection\n- Support 125 different languages\n- Low memory consumption (~20MB)\n- Highly customizable shortcuts\n- Command-line interface with rich options\n- D-Bus API\n- Available for Linux and Windows\n\n## Default keyboard shortcuts\n\nYou can change them in the settings. Some key sequences may not be available due to OS limitations.\n\nWayland does not support global shortcuts registration, but you can use [D-Bus](#d-bus-api) to bind actions in the system settings. For desktop environments that support [additional applications actions](https://specifications.freedesktop.org/desktop-entry-spec/desktop-entry-spec-latest.html#extra-actions) (KDE, for example) you will see them predefined in the system shortcut settings. You can also use them for X11 sessions, but you need to disable global shortcuts registration in the application settings to avoid conflicts.\n\n### Global\n\n| Key                                             | Description                        |\n| ----------------------------------------------- | ---------------------------------- |\n| \u003ckbd\u003eCtrl\u003c/kbd\u003e + \u003ckbd\u003eAlt\u003c/kbd\u003e + \u003ckbd\u003eE\u003c/kbd\u003e | Translate selected text            |\n| \u003ckbd\u003eCtrl\u003c/kbd\u003e + \u003ckbd\u003eAlt\u003c/kbd\u003e + \u003ckbd\u003eS\u003c/kbd\u003e | Speak selected text                |\n| \u003ckbd\u003eCtrl\u003c/kbd\u003e + \u003ckbd\u003eAlt\u003c/kbd\u003e + \u003ckbd\u003eF\u003c/kbd\u003e | Speak translation of selected text |\n| \u003ckbd\u003eCtrl\u003c/kbd\u003e + \u003ckbd\u003eAlt\u003c/kbd\u003e + \u003ckbd\u003eG\u003c/kbd\u003e | Stop speaking                      |\n| \u003ckbd\u003eCtrl\u003c/kbd\u003e + \u003ckbd\u003eAlt\u003c/kbd\u003e + \u003ckbd\u003eC\u003c/kbd\u003e | Show main window                   |\n| \u003ckbd\u003eCtrl\u003c/kbd\u003e + \u003ckbd\u003eAlt\u003c/kbd\u003e + \u003ckbd\u003eI\u003c/kbd\u003e | Recognize text in screen area      |\n| \u003ckbd\u003eCtrl\u003c/kbd\u003e + \u003ckbd\u003eAlt\u003c/kbd\u003e + \u003ckbd\u003eO\u003c/kbd\u003e | Translate text in screen area      |\n\n### In main window\n\n| Key                                               | Description                             |\n| ------------------------------------------------- | --------------------------------------- |\n| \u003ckbd\u003eCtrl\u003c/kbd\u003e + \u003ckbd\u003eReturn\u003c/kbd\u003e               | Translate                               |\n| \u003ckbd\u003eCtrl\u003c/kbd\u003e + \u003ckbd\u003eR\u003c/kbd\u003e                    | Swap languages                          |\n| \u003ckbd\u003eCtrl\u003c/kbd\u003e + \u003ckbd\u003eQ\u003c/kbd\u003e                    | Close window                            |\n| \u003ckbd\u003eCtrl\u003c/kbd\u003e + \u003ckbd\u003eS\u003c/kbd\u003e                    | Speak source / pause text speaking      |\n| \u003ckbd\u003eCtrl\u003c/kbd\u003e + \u003ckbd\u003eShift\u003c/kbd\u003e + \u003ckbd\u003eS\u003c/kbd\u003e | Speak translation / pause text speaking |\n| \u003ckbd\u003eCtrl\u003c/kbd\u003e + \u003ckbd\u003eShift\u003c/kbd\u003e + \u003ckbd\u003eC\u003c/kbd\u003e | Copy translation to clipboard           |\n\n## CLI commands\n\nThe program also has a console interface.\n\n**Usage:** `crow [options] text`\n\n| Option                     | Description                                                                                                         |\n| -------------------------- | ------------------------------------------------------------------------------------------------------------------- |\n| `-h, --help`               | Display help                                                                                                        |\n| `-v, --version`            | Display version information                                                                                         |\n| `-c, --codes`              | Display language codes                                                                                              |\n| `-s, --source \u003ccode\u003e`      | Specify the source language (by default, engine will try to determine the language on its own)                      |\n| `-t, --translation \u003ccode\u003e` | Specify the translation language(s), splitted by '+' (by default, the system language is used)                      |\n| `-l, --locale \u003ccode\u003e`      | Specify the translator language (by default, the system language is used)                                           |\n| `-e, --engine \u003cengine\u003e`    | Specify the translator engine ('google', 'yandex', 'bing', 'libretranslate' or 'lingva'), Google is used by default |\n| `-p, --speak-translation`  | Speak the translation                                                                                               |\n| `-u, --speak-source`       | Speak the source                                                                                                    |\n| `-f, --file`               | Read source text from files. Arguments will be interpreted as file paths                                            |\n| `-i, --stdin`              | Add stdin data to source text                                                                                       |\n| `-a, --audio-only`         | Print text only for speaking when using `--speak-translation` or `--speak-source`                                   |\n| `-b, --brief`              | Print only translations                                                                                             |\n| `-j, --json`               | Print output formatted as JSON                                                                                      |\n\n**Note:** If you do not pass startup arguments to the program, the GUI starts.\n\n## D-Bus API\n\n    io.crow_translate.CrowTranslate\n    ├── /io/crow_translate/CrowTranslate/Ocr\n    |   └── method void io.crow_translate.CrowTranslate.Ocr.setParameters(QVariantMap parameters);\n    └── /io/crow_translate/CrowTranslate/MainWindow\n        |   # Global shortcuts\n        ├── method void io.crow_translate.CrowTranslate.MainWindow.translateSelection();\n        ├── method void io.crow_translate.CrowTranslate.MainWindow.speakSelection();\n        ├── method void io.crow_translate.CrowTranslate.MainWindow.speakTranslatedSelection();\n        ├── method void io.crow_translate.CrowTranslate.MainWindow.playPauseSpeaking();\n        ├── method void io.crow_translate.CrowTranslate.MainWindow.stopSpeaking();\n        ├── method void io.crow_translate.CrowTranslate.MainWindow.open();\n        ├── method void io.crow_translate.CrowTranslate.MainWindow.copyTranslatedSelection();\n        ├── method void io.crow_translate.CrowTranslate.MainWindow.recognizeScreenArea();\n        ├── method void io.crow_translate.CrowTranslate.MainWindow.translateScreenArea();\n        ├── method void io.crow_translate.CrowTranslate.MainWindow.delayedRecognizeScreenArea();\n        ├── method void io.crow_translate.CrowTranslate.MainWindow.delayedTranslateScreenArea();\n        |   # Main window shortcuts\n        ├── method void io.crow_translate.CrowTranslate.MainWindow.clearText();\n        ├── method void io.crow_translate.CrowTranslate.MainWindow.cancelOperation();\n        ├── method void io.crow_translate.CrowTranslate.MainWindow.swapLanguages();\n        ├── method void io.crow_translate.CrowTranslate.MainWindow.openSettings();\n        ├── method void io.crow_translate.CrowTranslate.MainWindow.setAutoTranslateEnabled(bool enabled);\n        ├── method void io.crow_translate.CrowTranslate.MainWindow.copySourceText();\n        ├── method void io.crow_translate.CrowTranslate.MainWindow.copyTranslation();\n        ├── method void io.crow_translate.CrowTranslate.MainWindow.copyAllTranslationInfo();\n        └── method void io.crow_translate.CrowTranslate.MainWindow.quit();\n\nFor example, you can show main window using `dbus-send`:\n\n```bash\ndbus-send --type=method_call --dest=io.crow_translate.CrowTranslate /io/crow_translate/CrowTranslate/MainWindow io.crow_translate.CrowTranslate.MainWindow.open\n```\n\nOr via `qdbus`:\n\n```bash\nqdbus io.crow_translate.CrowTranslate /io/crow_translate/CrowTranslate/MainWindow io.crow_translate.CrowTranslate.MainWindow.open\n# or shorter\nqdbus io.crow_translate.CrowTranslate /io/crow_translate/CrowTranslate/MainWindow open\n```\n\n## Global shortcuts in wayland\n\nWayland doesn't provide API for global shortcuts and you need to register them by yourself. \n\n### KDE\n\nKDE have a convenient feature to define shortcuts in .desktop file and import them in settings. These shortcuts are already enabled and should work by default.\n\n### GNOME\n\nFor GNOME you need to manually set D-Bus commands as global shortcuts. For example, to translate selected text use the following:\n\n```bash\nqdbus io.crow_translate.CrowTranslate /io/crow_translate/CrowTranslate/MainWindow translateSelection\n```\n\nYou can set a hotkey for this command in GNOME system settings.\n\n## Dependencies\n\n### Required\n\n- [CMake](https://cmake.org) 3.16+\n- [Extra CMake Modules](https://github.com/KDE/extra-cmake-modules)\n- [Qt](https://www.qt.io) 5.9+ with Widgets, Network, Multimedia, Concurrent, X11Extras (Linux), DBus (Linux) and WinExtras (Windows) modules\n- [Tesseract](https://tesseract-ocr.github.io) 4.0+\n- [Png2Ico](https://www.winterdrache.de/freeware/png2ico) or [IcoTool](https://www.nongnu.org/icoutils) for generating executable icon (Windows)\n\n### Optional\n\n- [KWayland](https://invent.kde.org/frameworks/kwayland)\n\n### External libraries\n\nThis project uses the following external libraries, which included as git submodules:\n\n- [QOnlineTranslator](https://github.com/crow-translate/QOnlineTranslator) - provides free usage of Google, Yandex and Bing translate API.\n- [QGitTag](https://github.com/crow-translate/QGitTag) - uses the GitHub API to provide information about releases.\n- [QHotkey](https://github.com/Skycoder42/QHotkey) - provides global shortcuts for desktop platforms.\n- [QTaskbarControl](https://github.com/Skycoder42/QTaskbarControl) - to create a taskbar/launcher progress for all desktop platforms.\n- [SingleApplication](https://github.com/itay-grudev/SingleApplication) - prevents launch of multiple application instances.\n\n## Icons\n\n[Fluent](https://github.com/vinceliuice/Fluent-icon-theme) icon theme is bundled to provide icons on Windows and fallback icons on Linux.\n\n[circle-flags](https://github.com/HatScripts/circle-flags \"A collection of 300+ minimal circular SVG country flags\") icons are used for flags.\n\n## Installation\n\nDownloads are available on the [Releases](https://github.com/crow-translate/crow-translate/releases/latest) page. Also check out the [website](https://crow-translate.github.io/#installation) for other installation methods.\n\n**Note:** On Linux to make the application look native on a non-KDE desktop environment, you need to configure Qt applications styling. This can be done by using [qt5ct](https://github.com/RomanVolak/qt5ct) or [adwaita-qt5](https://github.com/FedoraQt/adwaita-qt) or [qtstyleplugins](https://github.com/qt/qtstyleplugins). Please check the appropriate installation guide for your distribution.\n\n**Note:** Windows requires [Microsoft Visual C++ Redistributable 2019](https://support.microsoft.com/en-us/topic/the-latest-supported-visual-c-downloads-2647da03-1eea-4433-9aff-95f26a218cc0) to work.\n\n## Building\n\n### Building executable\n\nYou can build **Crow Translate** by using the following commands:\n\n```bash\nmkdir build\ncd build\ncmake .. # Or `cmake -D CMAKE_BUILD_TYPE=Release ..` for single-configuration generators such as Ninja or GNU Make\ncmake --build . # Or `cmake --build . --config Release` for multi-config generators such as Visual Studio Generators or Xcode\n```\n\nYou will then get a binary named `crow`.\n\n### Building a package using CPack\n\nCMake can create [specified package types](https://cmake.org/cmake/help/latest/manual/cpack-generators.7.html) automatically.\n\nIf you use Makefile, Ninja, or Xcode generator you can use [package](https://cmake.org/cmake/help/latest/module/CPack.html#targets-package-and-package-source) target:\n\n```bash\nmkdir build\ncd build\ncmake -D CMAKE_BUILD_TYPE=Release -D CPACK_GENERATOR=DEB .. # You can specify several types of packages separated by semicolons in double quotes, for example: `CPACK_GENERATOR=\"DEB;ZIP;NSIS\"`\ncmake --build . --target package\n```\n\nOr you can use [CPack](https://cmake.org/cmake/help/latest/module/CPack.html) utility for any generators:\n\n```bash\nmkdir build\ncd build\ncmake .. # Or `cmake -D CMAKE_BUILD_TYPE=Release ..` for single-configuration generators such as Ninja or GNU Make\ncpack -G DEB # Or `cpack -G DEB -C Release` for multi-config generators such as Visual Studio Generators or Xcode\n```\n\nOn Windows you need [VCPKG](https://github.com/microsoft/vcpkg) to bundle all necessary DLLs.\n\n### Build parameters\n\n- `WITH_PORTABLE_MODE` - Enable portable functionality. If you create file named `settings.ini` in the app folder and Crow will store the configuration in it. It also adds the “Portable Mode” option to the application settings, which does the same.\n- `WITH_KWAYLAND` - Find and use KWayland library for better Wayland integration.\n\nBuild parameters are passed at configuration stage: `cmake -D WITH_PORTABLE_MODE ..`.\n\n## Localization\n\nTo help with localization you can use [Crowdin](https://crowdin.com/project/crow-translate) or translate files in `data/translations` with [Qt Linguist](https://doc.qt.io/Qt-5/linguist-translators.html) directly. To add a new language, write me on the Crowdin page or copy `data/translations/crow-translate.ts` to `data/translations/crow-translate_\u003cISO 639-1 language code\u003e_\u003cISO 3166-1 country code\u003e.ts`, translate it and send a pull request.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcrow-translate%2Fcrow-translate","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcrow-translate%2Fcrow-translate","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcrow-translate%2Fcrow-translate/lists"}