同步操作将从 neucrack/COMTool 强制同步,此操作会覆盖自 Fork 仓库以来所做的任何修改,且无法恢复!!!
确定后同步将在后台操作,完成时将刷新页面,请耐心等待。
English | 中文
跨平台开源串口调试助手,使用 python 编写
Windows | Linux | Raspberry Pi | macOS |
---|---|---|---|
白色主题 | 黑色主题 | 协议插件 | TCP/UDP | 终端 | 图表绘制 |
---|---|---|---|---|---|
截图可能不是最新的版本, 最新的版本只会更好用更好看
ASII,GBK(Chinese),UTF-8,UTF-16
等rts
和 dtr
手动控制\r \n \t \x
等unix
终端风格颜色支持,比如\x1b[33;42mhello\x1b[0mhello2
有两种安装方式:
.zip
文件,点击comtool.exe
运行另外你也可以使用 scoop 安装, 由 StudentWeis 维护
scoop bucket add Nightly https://github.com/StudentWeis/Nightly scoop install comtool
Linux版本太多,我们只为ubuntu编译二进制。 其他发行版请从 pypi 或源码安装。 如果你有什么好的跨平台打包想法,比如 flatpak 或 appimage,你可以贡献一个 PR 或添加一个 issue 来告诉我如何可以做到
Arch Linux 及其衍生版本可以通过 AUR 仓库在线安装:(目前由 taotieren 维护):
# 发行版 yay -S python-comtool # 开发版 yay -S python-comtool-git
sudo
命令自动软件,则需要将当前用户添加到dialout
组sudo usermod -a -G dialout $USER
grep 'dialout' /etc/group
reboot #must reboot to take effect
.zip
文件,双击comtool
运行打开终端,先用包管理器安装依赖:
sudo apt install git python3-pyqt5 python3-numpy
先用包管理器安装 pyqt5 numpy 等包更容易安装。 后面如果
pip
安装过程中某个包遇到了错误,也可以先尝试用系统自带的包管理器安装对应的包。 找到包名的技巧就是用sudo apt-cache search 包名 | grep 包名
来搜索包名,然后安装
然后用 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
sudo
命令自动软件,则需要将当前用户添加到dialout
组sudo usermod -a -G dialout $USER
grep 'dialout' /etc/group
reboot #must reboot to take effect
然后通过命令启动
comtool
如果你想同时打开多个comtool
,只需要右键 dock 栏图标,选择新建窗口
即可。
另外也可以打开终端并输入
open -n /Application/comtool.app
或者
cd /Applicatioin/comtool.app/Contents/MacOS
./comtool
因为程序没有开发者签名,所以第一次打开时会警告,需要到
设置 -> 安全和隐私 -> 通用
看到提示comtool
点击仍要打开
即可
如果你的软件是从这里下载的,没关系,这是打包产生的问题,所有的源码和打包脚本都在这里,连打包过程都是用github action
完全自动化,没有人手动打包。
如果你仍然担心,只需下载源代码,然后使用 python
运行或自己打包。
当然,如果你找到更好的打包方式,请来 issue
告诉我们。
对于开发者,或者没有你的平台的预编译软件, 可以使用这种方式安装
先安装 Python3
windows
或 macOS
:下载 python3
linux
: 比如ubuntu
, sudo apt install python3 python3-pip
, macOS brew install python3 python3-pip
确保你有pip
pip3 --version
# 或者
pip --version
如果没有这个命令,安装
python3 -m ensurepip
pypi
安装:pip3 install comtool
comtool
在国内,为了下载速度更快, 你可以用 tuna
镜像更快地下载:
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
安装过程中遇到了错误,比如最容易出错的pyqt5
,也可以先尝试用系统自带的包管理器安装对应的包,比如sudo apt install python3-pyqt5 python3-numpy
要知道包名的技巧就是用
sudo apt-cache search 包名 | grep 包名
来搜索包名,然后安装
sudo
命令自动软件,则需要将当前用户添加到dialout
组sudo usermod -a -G dialout $USER
grep 'dialout' /etc/group
reboot #must reboot to take effect
/usr/share/applications
目录(可能需要 root
权限)/usr/share/applications/comtool.desktop
,替换里面的图标路径 Icon=/usr/local/COMTool/assets/logo.ico
为实际的图标路径或者你喜欢的图标,保存即可pip3 install pyinstaller
python pack.py
cd dist
ls
打包前最好创建一个虚拟环境,这样打包出来的可执行文件会小很多
pip install virtualenv
virtualenv venv
source venv/bin/activate
# linuxvenv/Scripts/activate
# windows 如果遇到因为在此系统上禁止运行脚本
, 可以临时允许当前终端执行脚本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
在树莓派上,可以通过 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
requirments.txt
中的python pip
包)apt install python3 python3-pip
pip3 install -r requirements.txt
在 i18n.py 中添加语言
locales=["en", "zh_CN", "zh_TW", "ja"]
将你的语言附加到此列表中,可以在 此处 或 wikipedia,例如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 以将你的更改合并到 comtool 仓库
在源码或者二进制程序目录下的assets/qss
目录中,从style-dark.qss
或者style-light.qss
复制一个文件,文件名为style-xxx.qss
,这里xxx
就是主题的名字,这样软件里就能检测到这个主题了。
然后根据你的喜好修改qss
文件即可, qss
和css
语法类似,不过支持得不是很完全,css
语法能不能用以实际效果为准哈哈。
欢迎提交主题代码(PR)
另外软件没有为主题刻意优化过,class 和 id 可能都是随手写的,所以不保证未来的代码能完全兼容现在的 qss。
创建 issue
以库的方式使用了以下开源项目:
如果项目帮助到你了,可以请作者喝杯下午茶~
此处可能存在不合适展示的内容,页面不予展示。您可通过相关编辑功能自查并修改。
如您确认内容无涉及 不当用语 / 纯广告导流 / 暴力 / 低俗色情 / 侵权 / 盗版 / 虚假 / 无价值内容或违法国家有关法律法规的内容,可点击提交进行申诉,我们将尽快为您处理。