同步操作将从 neucrack/COMTool 强制同步,此操作会覆盖自 Fork 仓库以来所做的任何修改,且无法恢复!!!
确定后同步将在后台操作,完成时将刷新页面,请耐心等待。
English | 中文
A cross platform serial debug tools written by python
Windows | Linux | Raspberry Pi | macOS |
---|---|---|---|
White theme | Dark theme | protocol plugin | TCP/UDP | Terminal | Graph |
---|---|---|---|---|---|
screenshot maybe the old version, the latest may not the same totally! But better performance、more easy to use and more elegant
ASII,GBK(Chinese),UTF-8,UTF-16
etc.)\x1b[33;42mhello\x1b[0mhello2
)\r \n \t \x
etc.\r \n \t \x
etc.There are two ways to install COMTool:
.zip
file, and click comtool.exe
to runAnd you can install by scoop, maintained by StudentWeis
scoop bucket add Nightly https://github.com/StudentWeis/Nightly scoop install comtool
Linux has too much version, so we only compile binary for ubuntu. Other distribution please install from pypi or source code. If you have any idea to pack cross platform binary like flatpak or appimage, you can contribute a pull request or add an issue to tell me how to
Arch Linux and its derivative distributions can install from AUR(maintained by taotieren):
# Release version yay -S python-comtool # Development version yay -S python-comtool-git
Download release at release page, and extract files from .zip
file, and click comtool
to run
Add current user to dialout group to avoid sudo
command
sudo usermod -a -G dialout $USER
grep 'dialout' /etc/group
reboot #must reboot to take effect
just open terminal, type the command below:
sudo apt install git
git clone https://github.com/Neutree/COMTool.git --depth=1
cd COMTool
pip3 install .
# or
# python setup.py bdist_wheel
# sudo pip3 install dist/COMTool-*.*.*-py3-none-any.whl
sudo
commandsudo usermod -a -G dialout $USER
grep 'dialout' /etc/group
reboot #must reboot to take effect
then enjoy by command
comtool
If you want to open multiple comtool, just right click dock icon, then click New Window
.
or you can open terminal and type
open -n /Application/comtool.app
or
cd /Applicatioin/comtool.app/Contents/MacOS
./comtool
Because the program is not signed by the developer, it will warn when you open it for the first time. You need to go to
Settings -> Security and Privacy -> General
to see the promptcomtool
and clickOpen anyway
.
If your program is download from here, it's ok, the error caused by pack issue, all the source code and pack script is here, even the pack progress is totally automated with github action, no one manually pack.
If you remain have concern, just download source code to run with python or pack yourself.
Of course, if you find a better pack way, please open issue to tell us.
For developers or the binary not support your platform's, use this way to install
Install Python3 first
sudo apt install python3 python3-pip
, macOS brew install python3 python3-pip
Ensure you have pip
pip3 --version
# or
pip --version
If no this command, install by
python3 -m ensurepip
pip3 install comtool
comtool
for Chinese, you can use tuna mirrors to download faster by:
pip install -i https://pypi.tuna.tsinghua.edu.cn/simple comtool
pip3 install git+https://github.com/Neutree/COMTool
git clone https://github.com/Neutree/COMTool.git
cd COMTool
pip install .
or build your own wheel binary
pip3 install wheel
python setup.py bdist_wheel
pip install dist/COMTool-*.*.*-py3-none-any.whl
comtool
sudo
commandsudo usermod -a -G dialout $USER
grep 'dialout' /etc/group
reboot #must reboot to take effect
/usr/share/applications
folder(may need root
user to do this)/usr/share/applications/comtool.desktop
, change icon path Icon=/usr/local/COMTool/assets/logo.ico
to actual icon path, you can also use your love iconpip3 install pyinstaller
python pack.py
cd dist
ls
Linux:
sudo apt install python3 python3-pip
Windows: dowload python3
pyserial
and PyQt5
etc.(list in requirements.txt)cd COMTool
pip3 install -r requirements.txt
On Raspberry, python3-pyqt5
can be install by apt
command:
sudo pip3 install --upgrade pyserial
sudo apt install python3-pyqt5
git clone https://github.com/Neutree/COMTool.git
Recommended PyCharm
IDE or vscode
to get start
How to run:
Generate translate binary files first(.mo
)
python COMTool/i18n.py finish
Then execute main program
python COMTool/Main.py
see docs/plugins.md
apt install python3 python3-pip
pip3 install -r requirements.txt
Add locale in i18n.py
locales=["en", "zh_CN", "zh_TW", "ja"]
append your language to this list, locales can be found here or wikipedia, zh_CN
for example means China Mainland, corresponding language is simplified Chinese characters, zh_TW
means China Taiwan, and language is traditional Chinese characters, you can also only use zh
to use simplified Chinese characters.
python i18n.py prepare
This command will generate .po
files in locales folder
Then translate .po
files, this is a standard translate file format which named gettext
to make program read faster, the text files .po
should be convert to binary file .mo
, just run command:
python i18n.py finish
and then you can see locales/<locale>/LC_MESSAGES/messages.mo
file
Run application, you will see the new translation
Create a PR to merge your changes to this repo
Create issue here
And used these open source projects as libraries:
此处可能存在不合适展示的内容,页面不予展示。您可通过相关编辑功能自查并修改。
如您确认内容无涉及 不当用语 / 纯广告导流 / 暴力 / 低俗色情 / 侵权 / 盗版 / 虚假 / 无价值内容或违法国家有关法律法规的内容,可点击提交进行申诉,我们将尽快为您处理。