Linux屏幕取词翻译软件CuteTranslation安装与配置全攻略

Linux屏幕取词翻译软件CuteTranslation安装与配置全攻略

项目基础介绍及编程语言

CuteTranslation是一款专为Linux系统设计的屏幕取词翻译软件，采用X11架构，完美适配多种Linux桌面环境。它通过对接Google翻译与百度翻译API，实现快速的文字选取与翻译功能，同时支持OCR图像文字识别。此项目主要使用C++进行开发，并结合QMake进行项目管理，同时也涉及Shell脚本等辅助工具。

关键技术和框架

• 核心技术: 利用X11进行屏幕捕获与监听，集成Google翻译和百度翻译API进行翻译工作，以及OCR技术（可能是借助第三方库）进行图像内文字识别。
• 框架: 应用了Qt框架，这是一个跨平台的应用程序开发框架，使得软件拥有友好的图形界面和高度的可配置性。
• 其他组件: 项目可能还利用了gnome-screenshot进行截图，以及Node.js、tidy等工具来支持特定功能或构建流程。

准备工作与详细安装步骤

步骤一：系统准备 确保您的Linux系统已安装必要的开发工具和库，包括git, qt5-default, libqt5x11extras5-dev等。可以通过以下命令安装基础开发环境：

sudo apt-get update
sudo apt-get install git qt5-default libqt5x11extras5-dev qtmultimedia5-dev libqt5svg5-dev libxtst-dev libxcb-util0-dev build-essential nodejs gnome-screenshot tidy qmake

步骤二：获取项目源码 打开终端，克隆项目代码：

git clone https://github.com/jiangzc/CuteTranslation.git
cd CuteTranslation

步骤三：编译与安装 项目提供了自动化构建脚本，但为了详细指导，我们将手动执行编译过程。首先，你需要创建一个构建目录并进入该目录：

mkdir build && cd build

接下来，使用qmake生成Makefile，然后编译安装：

qmake ..
make -j4
sudo make install

如果遇到权限问题，确保使用sudo以管理员权限进行安装。

步骤四：配置文件调整 CuteTranslation的配置文件默认位于~/.local/share/CuteTranslation/config.ini。你可以根据需要编辑此文件来调整界面大小、快捷键等个性化设置。比如，若要修改窗口尺寸适应你的屏幕，可按需调整[MainWindow]下的MainWindowHeight和MainWindowWidth。

步骤五：运行与测试 安装完成后，你可以直接从终端运行CuteTranslation：

CuteTranslation

或者，在应用菜单中找到它。首次启动，尝试一些基本功能如取词翻译、截图翻译和悬浮搜索框，确认是否正常运作。

故障排查：

• 若启动失败，检查日志文件位于~/.local/share/CuteTranslation/log.txt，寻找错误提示。
• 确保所有必要的依赖项已正确安装。
• 遇到配置文件版本不匹配的问题，删除配置文件(~/.local/share/CuteTranslation/config.ini)并重新启动软件。

现在，您已经完成了CuteTranslation的安装与基本配置，享受便捷的翻译体验吧！