COMTool下载 - COMTool源码下载

COMTool

其他类别

v3.4.1

下载

COM工具

英语 | 中文

python编写的跨平台串口调试工具

视窗	Linux	树莓派	macOS

白色主题	深色主题	协议插件	TCP/UDP	终端	图形

截图可能是旧版本，最新的可能完全不一样！但性能更好、更易用、更优雅

特征

安装

有两种方法安装 COMTool：

下载二进制文件并运行：适用于Windows或macOS以及简单使用的用户
安装为python包（源代码）：对于Linux，或需要使用插件的用户，或了解python的用户

安装二进制文件

视窗

在发布页面或sourceforge下载最新的bin文件
解压.zip文件，点击comtool.exe运行

你可以通过 scoop 安装，由 StudentWeis 维护
 scoop bucket add Nightly https://github.com/StudentWeis/Nightly
scoop install comtool

Linux

Linux版本太多，所以我们只为ubuntu编译二进制文件。其他发行版请从 pypi 或源代码安装。如果您有任何想法打包跨平台二进制文件（例如 flatpak 或 appimage），您可以贡献一个拉取请求或添加一个问题来告诉我如何

Arch Linux 及其衍生发行版可以从 AUR 安装（由 taotieren 维护）：
 # Release version
yay -S python-comtool
# Development version
yay -S python-comtool-git

在release页面下载release，并从.zip文件中解压文件，然后单击comtool运行
将当前用户添加到 dialout 组以避免sudo命令

sudo usermod -a -G dialout $USER
grep ' dialout ' /etc/group
reboot # must reboot to take effect

树莓派

打开终端，使用包管理器安装依赖项：

sudo apt install git python3-pyqt5 python3-numpy

使用包管理器安装 pyqt5 numpy 等。这种方式使安装更容易。如果使用pip安装时遇到错误，可以先尝试使用包管理器安装。要查找包名称，技巧是使用sudo apt-cache search package_name | grep package_name搜索包名，然后安装。

然后使用pip安装其他包：

 git clone https://github.com/Neutree/COMTool.git --depth=1
cd COMTool
pip3 install . --verbose
# 或者
# python setup.py bdist_wheel
# sudo pip3 install dist/COMTool-*.*.*-py3-none-any.whl --verbose

将当前用户添加到 dialout 组以避免sudo命令

sudo usermod -a -G dialout $USER
grep ' dialout ' /etc/group
reboot # must reboot to take effect

然后通过命令享受

 comtool

macOS

在发布页面或 sourceforge 下载版本
安装dmg包

如果要打开多个comtool，只需右键单击dock图标，然后单击New Window 。

或者你可以打开终端并输入

 open -n /Application/comtool.app

或者

 cd /Applicatioin/comtool.app/Contents/MacOS
./comtool

由于该程序没有经过开发者签名，因此第一次打开时会发出警告。您需要进入Settings -> Security and Privacy -> General才能看到提示comtool ，然后单击Open anyway 。

Windows Defender 显示 comtool 二进制文件是恶意软件？

如果你的程序是从这里下载的，没关系，是pack问题导致的错误，所有的源码和pack脚本都在这里，连打包进度都是完全用github动作自动化的，没有人手动打包。

如果您仍然担心，只需下载源代码以使用 python 运行或自行打包。

当然，如果您发现更好的打包方式，请开issue告诉我们。

安装python包

对于开发人员或二进制文件不支持您的平台，请使用此方式安装

首先安装Python3
- 如果是 Windows 或 macOS：下载 python3
- 如果 linux: ubuntu 例如sudo apt install python3 python3-pip , macOS brew install python3 python3-pip
确保你pip

pip3 --version
# or
pip --version

如果没有这个命令，则安装

python3 -m ensurepip

然后从 pypi 安装：

pip3 install comtool
comtool

对于中文，您可以使用金枪鱼镜像来更快地下载：

pip install -i https://pypi.tuna.tsinghua.edu.cn/simple comtool

或者你可以直接从github安装

 pip3 install git+https://github.com/Neutree/COMTool

或者您可以下载源代码，然后从源代码安装
- 下载源码，网页下载或者git clone https://github.com/Neutree/COMTool.git
- 安装

 cd COMTool
pip install .

或者构建你自己的wheel二进制文件

 pip3 install wheel
python setup.py bdist_wheel
pip install dist/COMTool-*.*.*-py3-none-any.whl
comtool

如果使用pip安装时遇到错误，可以尝试先使用包管理器安装，然后再次使用pip安装。例如

 sudo apt install python3-pyqt5 python3-numpy cython3

要查找包名称，技巧是使用sudo apt-cache search package_name | grep package_name搜索包名，然后安装。

顺便说一句，您应该将当前用户添加到 dialout 组以避免sudo命令

sudo usermod -a -G dialout $USER
grep ' dialout ' /etc/group
reboot # must reboot to take effect

在 Linux 上手动将应用程序添加到开始菜单

将 tool/comtool.desktop 复制到/usr/share/applications文件夹（可能需要root用户来执行此操作）
编辑/usr/share/applications/comtool.desktop ，将图标路径Icon=/usr/local/COMTool/assets/logo.ico更改为实际图标路径，您也可以使用您的爱心图标
然后您可以在开始菜单（或应用程序中心）找到comtool应用程序

打包二进制文件

pip3 install pyinstaller
python pack.py
cd dist
ls

最好在打包之前创建一个虚拟环境，以减少二进制文件的大小pip install virtualenv virtualenv venv source venv/bin/activate # linux venv/Scripts/activate # windows 如果遇到running scripts is disabled on this system ，可以暂时允许当前终端执行脚本Set-ExecutionPolicy -Scope Process -ExecutionPolicy RemoteSigned然后pip install pyinstaller和python pack.py

发展

安装 python(>=3.8) 和 pip3

Linux：

 sudo apt install python3 python3-pip

Windows：下载python3

安装pyserial和PyQt5等软件包（在requirements.txt中列出）

 cd COMTool
pip3 install -r requirements.txt

在Raspberry上，可以通过apt命令安装python3-pyqt5 ：

 sudo pip3 install --upgrade pyserial
sudo apt install python3-pyqt5

克隆项目

 git clone https://github.com/Neutree/COMTool.git

代码、解决错误或添加新功能

推荐使用PyCharm IDE 或vscode入门

如何运行：先生成翻译二进制文件( .mo )

 python COMTool/i18n.py finish

然后执行主程序

 python COMTool/Main.py

拉取请求

只需几分钟即可编写您自己的插件

请参阅文档/plugins.md

添加翻译

先安装环境（requirements.txt中的python pip包）

apt install python3 python3-pip
pip3 install -r requirements.txt

如果您需要添加新语言，或跳过

在 i18n.py 中添加语言环境

 locales=["en", "zh_CN", "zh_TW", "ja"]

将您的语言添加到此列表中，区域设置可以在此处或维基百科中找到，例如zh_CN表示中国大陆，对应的语言是简体中文字符， zh_TW表示中国台湾，语言是繁体中文字符，您也可以只使用zh来使用简体中文汉字。

生成翻译文件

python i18n.py prepare

该命令将在 locales 文件夹中生成.po文件

手动翻译

然后翻译.po文件，这是标准翻译文件格式，名为gettext

生成二进制翻译文件

为了使程序读取更快，文本文件.po应该转换为二进制文件.mo ，只需运行命令：

python i18n.py finish

然后你可以看到locales/<locale>/LC_MESSAGES/messages.mo文件

测试

运行应用程序，您将看到新的翻译

拉取请求

创建 PR 以将您的更改合并到此存储库

自定义主题

在源代码或二进制程序目录下的assets/qss目录中，复制一个style-dark.qss或style-light.qss文件，文件名为style-xxx.qss ，这里xxx是主题的名称，以便软件可以检测主题。然后根据自己的喜好修改qss文件。 qss的语法与css类似，但支持不完整。 css语法能不能用就看实际效果了，哈哈。欢迎添加主题代码！（PR）