https://github.com/ramessesn/robomaster-sdk-ultra

Make robomaster library compatible with the later version of python
https://github.com/ramessesn/robomaster-sdk-ultra

cmake ffmpeg opus robomaster sdk-python

Last synced: 14 days ago
JSON representation

Make robomaster library compatible with the later version of python

• Host: GitHub
• URL: https://github.com/ramessesn/robomaster-sdk-ultra
• Owner: RamessesN
• License: other
• Created: 2025-09-02T16:37:24.000Z (9 months ago)
• Default Branch: main
• Last Pushed: 2025-09-15T03:01:07.000Z (9 months ago)
• Last Synced: 2025-09-15T05:23:25.878Z (9 months ago)
• Topics: cmake, ffmpeg, opus, robomaster, sdk-python
• Language: C++
• Homepage:
• Size: 42 MB
• Stars: 0
• Watchers: 0
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

          
# Robomaster-SDK-Ultra

![docs](https://img.shields.io/badge/docs-passing-brightgreen)

![docs](https://img.shields.io/badge/docs-stable-brightgreen)

![latest version](https://img.shields.io/badge/latest%20version-v1.2.0-darkblue)

![compatible sys](https://img.shields.io/badge/compatible%20sys-macOS%20|%20Linux-yellow) \

![python](https://img.shields.io/badge/python-3.8%20|%203.9%20|%203.10%20|%203.11%20|%203.12%20|%203.13-blue)

---

## Usage

> [!IMPORTANT]

> The video module of Robomaster-SDK-Ultra is not compatible with `python 3.x.20`, therefore `python 3.x.12` (e.g. 3.10.12) are recommended.

### Description: 

Rewrite the **robomaster** library to make it compatible with the later version of Python.

---

### Notice:

- It includes `libmedia_codec_ultra` for media decoding / encoding support (H264 / Opus).

- Python Compatibility: `3.7` ~ `3.13`

---

### Robomaster-SDK-Ultra Installation:

 install by automator-script 

1. clone to local

2. `cd Robomaster-SDK-Ultra`

3. `sudo chmod 755 ./installer.sh`

4. `./installer.sh`

 Manual Installation 

1. clone to local

2. **robomaster-sdk-ultra** depends on `ffmpeg` and `opus` libraries. Install them via `homebrew` or system package manager

    - macOS (Apple Silicon / Intel): `brew install ffmpeg@4 opus`

    - Linux (Ubuntu / Debian): `sudo apt update; sudo apt install ffmpeg libopus-dev`

3. install **robomaster sdk ultra** library:

   - `cd Robomaster-SDK-Ultra`

   - `pip install -e .`

4. install **media decoder** dependency: 

   - `cd robomaster_lib/libmedia_codec_ultra`

   - `pip install -e .`

5. install **pybind11** dependency:

   - `cd pybind11`

   - `pip install -e .`

---

### Test Installation:

1. start your `xxx.py` with `from robomaster_ultra import xxx`

2. details of the api-usage: Reference - [robomaster documentaton](https://robomaster-dev.readthedocs.io/zh-cn/latest/index.html)

---

### TODO:

1. Port into `Windows` system (Crazy Difficult)

2. ...

---

#### ⚠️ License: The project now is completely open source. See details [MIT LICENSE](./LICENSE).

---

#### @ author: [RamessesN](https://github.com/RamessesN)

#### @ date: 2025-09-07