Hangyu Li
This document explains how to use our camera-based method to capture human motion and drive the TeleOpBench system. The pipeline consists of two components:
- Human motion capture via webcam using SMPLerX + MediaPipe
- Motion control in TeleOpBench with real-time visualization
We use a webcam to capture human motion, then process it using SMPLerX and MediaPipe.
Clone the repository:
git clone https://github.com/cyjdlhy/smpler_media.git
cd smpler_mediaInstall the required environment and download models by following instructions from the official SMPL-X repository: 👉 https://github.com/vchoutas/smplx
Then activate the environment:
conda activate smplerxInstall MediaPipe:
pip install mediapipeTo start capturing motion via webcam:
cd main
bash run.shThis will capture motion data (body pose + hand position) and send it for downstream processing.
The motion data is received by TeleOpBench, which performs inverse kinematics (IK) and controls a robot accordingly, with real-time visualization.
Activate the TeleOpBench environment:
conda activate teleopNavigate to the teleop directory and run:
cd teleop
./run.shOnce started, MeshCat will launch automatically, displaying real-time 3D visualization of the robot executing the motion.
This document explains how to use our VR-based method to capture human motion and drive the TeleOpBench system. The pipeline consists of two components:
- Hand motion capture via VR
- Motion control in TeleOpBench with real-time visualization
- check Host machine local ip address:
ifconfig | grep inet # Check the local IP address-
install mkcert
please refer to [https://github.com/FiloSottile/mkcert]
-
create certificate:
cd teleop
mkcert -install && mkcert -cert-file cert.pem -key-file key.pem 192.168.123.1 localhost 127.0.0.1- open firewall on server:
sudo ufw allow 8012- install ca-certificates on Apple Vision Pro:
mkcert -CAROOTCopy the rootCA.pem via AirDrop to Apple Vision Pro and install it.
Settings > General > About > Certificate Trust Settings. Under "Enable full trust for root certificates", turn on trust for the certificate.
In the new version of Vision OS 2, this step is different: After copying the certificate to the Apple Vision Pro device via AirDrop, a certificate-related information section will appear below the account bar in the top left corner of the Settings app. Tap it to enable trust for the certificate.
Settings > Apps > Safari > Advanced > Feature Flags > Enable WebXR Related Features.
- Open Safari on Apple Vision Pro and visit:
Make sure 192.168.123.1 is the IP address of your Host machine.
Click Enter VR and select Allow to start the VR session.
Activate the TeleOpBench environment:
conda activate teleopNavigate to the teleop directory and run:
./run.sh
Once started, MeshCat will launch automatically, displaying real-time 3D visualization of the robot executing the motion.
This project is built upon the work of several excellent research projects and open-source contributions. A big thank you to all the authors for sharing their work!
If you find this project useful in your research, please consider citing our paper:
@article{li2025teleopbench,
title={TeleOpBench: A Simulator-Centric Benchmark for Dual-Arm Dexterous Teleoperation},
author={Li, Hangyu and Zhao, Qin and Xu, Haoran and Jiang, Xinyu and Ben, Qingwei and Jia, Feiyu and Zhao, Haoyu and Xu, Liang and Zeng, Jia and Wang, Hanqing and others},
journal={arXiv preprint arXiv:2505.12748},
year={2025}
}