- After downloading the compressed file(.zip), please unzip it first.
- Do NOT move the UI.exe to another location in Windows.
Petoi Desktop App provides a neat graphical user interface to configure the firmware, calibrate the robot, and design customized motions for your robot. The major function modules are the Firmware Uploader, Joint Calibrator, and Skill Composer.
The source code is written with Tkinker in Python3 and is open source at https://github.com/PetoiCamp/OpenCat/tree/main/pyUI.
UI.py is the general entry for all the modules:
translate.py provides multi-language support for the UI. You may help to translate the UI into your language.
Before running the app, you must use the included USB adapter or the Bluetooth dongle to connect to a Petoi robot.
You can download the pre-compiled executables of the desktop App to avoid the programming interface.
After downloading the Mac version, you must drag it into the Application folder.
If you see the error message that "Petoi Desktop App" cannot be opened because the developer cannot be verified, you can right-click the icon, hold the Shift key and click Open.
In the case of compatibility issues, or if you want to modify the source and test, you can also run the code from the Terminal.
The Terminal is a built-in interface on Mac or Linux machines. The equivalent environment on Windows machines is called the Command-Line Tool (CMD). It's recommended that you install Anaconda to manage your Python environment. It can also provide the Powershell as a Terminal for older Windows machines.
Depending on your existing Python configuration, you may need to upgrade to Python3 and install the following libraries:
You can install them by entering
pip3 install pyserial pillowin the Terminal or use the package manager in Anaconda.
To run the code:
- 1.In the Terminal, use the
cdcommand to navigate to the
OpenCat/pyUI/folder. You can use the Tab key to auto-complete the path name.
- 2.After entering the pyUI/ folder, enter
lsand ensure you can see the UI.py and other python source codes listed.
For Linux system users, if you encounter the python error message "_tkinter.TclError: no display name and no $DISPLAY environment variable", you can try to install python3-tk, tk-dev, taking Debian / Ubuntu as an example, the command is as follows:
apt install python3-tk
apt install tk-dev
After the installation is complete, reboot the computer.