[!重要]
该项目已迁移至 KDE 旗下，开发工作将在 https://invent.kde.org/office/crow-translate 继续进行。

Crow Translate

Crow Translate 是一个简单轻量的翻译器，使用 C++ / Qt 编写，允许您使用谷歌、Yandex、必应、LibreTranslate 和 Lingva 翻译 API 来翻译和朗读文本。您可能还会对我在这个项目中使用的库 QOnlineTranslator 感兴趣。

内容

截图
特性
默认键盘快捷键
命令行界面命令
D-Bus API
Wayland 中的全局快捷键
依赖项
图标
安装
构建
本地化

截图

Plasma

Plasma Mobile

Windows 10

特性

翻译和朗读屏幕或选中的文本
支持 125 种不同的语言
内存消耗低（约 20MB）
高度可定制的快捷键
具有丰富选项的命令行界面
D-Bus API
可用于 Linux 和 Windows

默认键盘快捷键

您可以在设置中更改它们。由于操作系统限制，某些按键序列可能不可用。

Wayland 不支持全局快捷键注册，但您可以使用 D-Bus 在系统设置中绑定操作。对于支持额外应用程序操作的桌面环境（例如 KDE），您将在系统快捷键设置中看到预定义的快捷键。您也可以在 X11 会话中使用它们，但需要在应用程序设置中禁用全局快捷键注册以避免冲突。

全局

按键	描述
<kbd>Ctrl</kbd> + <kbd>Alt</kbd> + <kbd>E</kbd>	翻译选中的文本
<kbd>Ctrl</kbd> + <kbd>Alt</kbd> + <kbd>S</kbd>	朗读选中的文本
<kbd>Ctrl</kbd> + <kbd>Alt</kbd> + <kbd>F</kbd>	朗读选中文本的翻译
<kbd>Ctrl</kbd> + <kbd>Alt</kbd> + <kbd>G</kbd>	停止朗读
<kbd>Ctrl</kbd> + <kbd>Alt</kbd> + <kbd>C</kbd>	显示主窗口
<kbd>Ctrl</kbd> + <kbd>Alt</kbd> + <kbd>I</kbd>	识别屏幕区域的文本
<kbd>Ctrl</kbd> + <kbd>Alt</kbd> + <kbd>O</kbd>	翻译屏幕区域的文本

在主窗口中

按键	描述
<kbd>Ctrl</kbd> + <kbd>Return</kbd>	翻译
<kbd>Ctrl</kbd> + <kbd>R</kbd>	交换语言
<kbd>Ctrl</kbd> + <kbd>Q</kbd>	关闭窗口
<kbd>Ctrl</kbd> + <kbd>S</kbd>	朗读源文本 / 暂停朗读
<kbd>Ctrl</kbd> + <kbd>Shift</kbd> + <kbd>S</kbd>	朗读翻译 / 暂停朗读
<kbd>Ctrl</kbd> + <kbd>Shift</kbd> + <kbd>C</kbd>	复制翻译到剪贴板

命令行界面命令

该程序还具有控制台界面。

用法： crow [选项] 文本

选项	描述
`-h, --help`	显示帮助信息
`-v, --version`	显示版本信息
`-c, --codes`	显示语言代码
`-s, --source <代码>`	指定源语言（默认情况下，引擎会尝试自动确定语言）
`-t, --translation <代码>`	指定目标语言，多个语言用'+'分隔（默认使用系统语言）
`-l, --locale <代码>`	指定翻译器语言（默认使用系统语言）
`-e, --engine <引擎>`	指定翻译引擎（'google'、'yandex'、'bing'、'libretranslate'或'lingva'），默认使用Google
`-p, --speak-translation`	朗读翻译结果
`-u, --speak-source`	朗读源文本
`-f, --file`	从文件读取源文本。参数将被解释为文件路径
`-i, --stdin`	将标准输入数据添加到源文本
`-a, --audio-only`	使用`--speak-translation`或`--speak-source`时只打印用于朗读的文本
`-b, --brief`	只打印翻译结果
`-j, --json`	以JSON格式打印输出

**注意：**如果不向程序传递启动参数，将启动图形用户界面。

D-Bus API

io.crow_translate.CrowTranslate
├── /io/crow_translate/CrowTranslate/Ocr
|   └── 方法 void io.crow_translate.CrowTranslate.Ocr.setParameters(QVariantMap parameters);
└── /io/crow_translate/CrowTranslate/MainWindow
    |   # 全局快捷键
    ├── 方法 void io.crow_translate.CrowTranslate.MainWindow.translateSelection();
    ├── 方法 void io.crow_translate.CrowTranslate.MainWindow.speakSelection();
    ├── 方法 void io.crow_translate.CrowTranslate.MainWindow.speakTranslatedSelection();
    ├── 方法 void io.crow_translate.CrowTranslate.MainWindow.playPauseSpeaking();
    ├── 方法 void io.crow_translate.CrowTranslate.MainWindow.stopSpeaking();
    ├── 方法 void io.crow_translate.CrowTranslate.MainWindow.open();
    ├── 方法 void io.crow_translate.CrowTranslate.MainWindow.copyTranslatedSelection();
    ├── 方法 void io.crow_translate.CrowTranslate.MainWindow.recognizeScreenArea();
    ├── 方法 void io.crow_translate.CrowTranslate.MainWindow.translateScreenArea();
    ├── 方法 void io.crow_translate.CrowTranslate.MainWindow.delayedRecognizeScreenArea();
    ├── 方法 void io.crow_translate.CrowTranslate.MainWindow.delayedTranslateScreenArea();
    |   # 主窗口快捷键
    ├── 方法 void io.crow_translate.CrowTranslate.MainWindow.clearText();
    ├── 方法 void io.crow_translate.CrowTranslate.MainWindow.cancelOperation();
    ├── 方法 void io.crow_translate.CrowTranslate.MainWindow.swapLanguages();
    ├── 方法 void io.crow_translate.CrowTranslate.MainWindow.openSettings();
    ├── 方法 void io.crow_translate.CrowTranslate.MainWindow.setAutoTranslateEnabled(bool enabled);
    ├── 方法 void io.crow_translate.CrowTranslate.MainWindow.copySourceText();
    ├── 方法 void io.crow_translate.CrowTranslate.MainWindow.copyTranslation();
    ├── 方法 void io.crow_translate.CrowTranslate.MainWindow.copyAllTranslationInfo();
    └── 方法 void io.crow_translate.CrowTranslate.MainWindow.quit();

例如，你可以使用dbus-send显示主窗口：

dbus-send --type=method_call --dest=io.crow_translate.CrowTranslate /io/crow_translate/CrowTranslate/MainWindow io.crow_translate.CrowTranslate.MainWindow.open

或者通过qdbus：

qdbus io.crow_translate.CrowTranslate /io/crow_translate/CrowTranslate/MainWindow io.crow_translate.CrowTranslate.MainWindow.open
# 或更简短的
qdbus io.crow_translate.CrowTranslate /io/crow_translate/CrowTranslate/MainWindow open

Wayland下的全局快捷键

Wayland不提供全局快捷键的API，你需要自己注册它们。

KDE

KDE有一个方便的功能，可以在.desktop文件中定义快捷键并在设置中导入。这些快捷键默认已启用并应该可以正常工作。

GNOME

对于GNOME，你需要手动将D-Bus命令设置为全局快捷键。例如，要翻译选定的文本，请使用以下命令：

qdbus io.crow_translate.CrowTranslate /io/crow_translate/CrowTranslate/MainWindow translateSelection

你可以在GNOME系统设置中为此命令设置热键。

依赖项

必需

CMake 3.16+
Extra CMake Modules
Qt 5.9+，包含Widgets、Network、Multimedia、Concurrent、X11Extras（Linux）、DBus（Linux）和WinExtras（Windows）模块
Tesseract 4.0+
Png2Ico或IcoTool用于生成可执行文件图标（Windows）

可选

KWayland

外部库

本项目使用以下作为git子模块包含的外部库：

QOnlineTranslator - 提供免费使用Google、Yandex和Bing翻译API的功能。
QGitTag - 使用GitHub API提供发布信息。
QHotkey - 为桌面平台提供全局快捷键。
QTaskbarControl - 为所有桌面平台创建任务栏/启动器进度条。
SingleApplication - 防止启动多个应用程序实例。

图标

bundled了Fluent图标主题，以在Windows上提供图标和在Linux上提供备用图标。

使用circle-flags图标作为国旗。

安装

可以在Releases页面下载。也可以查看网站了解其他安装方法。

注意： 在Linux上，为了使应用程序在非KDE桌面环境下看起来更原生，你需要配置Qt应用程序样式。可以使用qt5ct、adwaita-qt5或qtstyleplugins来实现。请查看适合你发行版的安装指南。

注意： Windows需要安装Microsoft Visual C++ Redistributable 2019才能运行。

构建

构建可执行文件

你可以使用以下命令构建Crow Translate：

mkdir build
cd build
cmake .. # 或对于单配置生成器（如Ninja或GNU Make）使用 `cmake -D CMAKE_BUILD_TYPE=Release ..`
cmake --build . # 或对于多配置生成器（如Visual Studio生成器或Xcode）使用 `cmake --build . --config Release`

然后你将得到一个名为crow的二进制文件。

使用CPack构建软件包

CMake可以自动创建指定类型的软件包。

如果你使用Makefile、Ninja或Xcode生成器，可以使用package目标：

mkdir build
cd build
cmake -D CMAKE_BUILD_TYPE=Release -D CPACK_GENERATOR=DEB .. # 你可以在双引号中用分号分隔指定多种类型的包，例如：`CPACK_GENERATOR="DEB;ZIP;NSIS"`
cmake --build . --target package

或者你可以对任何生成器使用CPack工具：

mkdir build
cd build
cmake .. # 或对于单配置生成器（如Ninja或GNU Make）使用 `cmake -D CMAKE_BUILD_TYPE=Release ..`
cpack -G DEB # 或对于多配置生成器（如Visual Studio生成器或Xcode）使用 `cpack -G DEB -C Release`

在Windows上，你需要VCPKG来捆绑所有必要的DLL。

构建参数

WITH_PORTABLE_MODE - 启用便携功能。如果你在应用程序文件夹中创建名为settings.ini的文件，Crow将在其中存储配置。它还会在应用程序设置中添加"便携模式"选项，功能相同。
WITH_KWAYLAND - 查找并使用KWayland库以获得更好的Wayland集成。

构建参数在配置阶段传递：cmake -D WITH_PORTABLE_MODE ..。

本地化

要帮助进行本地化，你可以使用Crowdin或直接用Qt Linguist翻译data/translations中的文件。要添加新语言，请在Crowdin页面上与我联系，或将data/translations/crow-translate.ts复制为data/translations/crow-translate_<ISO 639-1语言代码>_<ISO 3166-1国家代码>.ts，翻译它并发送拉取请求。