Gesture Remote Control

This project is a gesture-recognition–based remote video control demo implemented on the Quectel Pi H1 single-board computer.
The system captures hand images through a camera and uses an AI gesture-recognition model to enable natural interactions such as remote control of video playback, progress, and volume.

Development Resource Summary

Component List

The listed development accessories are provided for reference only. Different development environments may vary. For example, if you are developing via SSH remote connection, the USB expansion dock may not be necessary, and the display monitor can also be replaced as needed.

Component Physical Reference

Quick Start

Development Preparation

The Quectel Pi H1 single-board computer comes pre-installed with Debian 13 system image, so no additional image burning is required. Follow the steps below to get started.

Hardware Connection

Heat Sink Fan Installation

First, insert the cooling fan's ribbon cable into the FAN slot of the single-board computer. Then, fix the two ends of the heatsink into the pre-drilled holes on the single-board computer, as follows:

Display Connection

Connect one end of the HDMI cable to the HDMI port on the single-board computer and the other end to the HDMI port on the monitor.

Input Device Connection

Connect USB keyboard and mouse to the USB ports on the hub, then connect the hub to the USB port on the single-board computer. For wireless devices, insert the receiver into the hub's USB port.

Network Connection

Connect one end of the Ethernet cable to the Gigabit Ethernet port on the single-board computer and the other end to the router's port (ensure the router is connected to the internet).

Jumper Connection

Make sure the header pins marked AUTO_POWER_ON in the upper left corner of the single-board computer are shorted with jumper caps.

Power Connection

Connect the USB-A end of the power cable to the power adapter and the USB-C end to the power port on the single-board computer (usually labeled POWER IN).

Speaker Connection

Connect the 2PIN PH1.25 interface speaker to the SPK slot on the single-board computer.

Camera Connection

Connect the OV5693 camera module to the USB port on the single-board computer.

Completed Connection Reference

Project Implementation

Install ffmpeg

sudo apt update
sudo apt install -y ffmpeg

Configure Python Environment

The default system Python version is 3.13, but the MediaPipe model requires Python 3.9–3.12.
Since Python 3.10 is already installed, we switch the default Python version.

# Switch to Python3.10
sudo cp /usr/bin/python3 /usr/bin/python3.backup
sudo rm /usr/bin/python3
sudo ln -s /usr/bin/python3.10 /usr/bin/python3
# Install and upgrade pip
python3 -m ensurepip --upgrade
pip install --upgrade pip

Download Demo Code

1.Click to download the code
2.Use the scp command to upload files to the gesture-remote-control folder. Refer to the Remote Access SCP File Copying Chapter
3.Extract the archive:

tar -xzvf gesture-remote-control.tar.gz

Install Project Dependencies

Enter the gesture-remote-control folder and run:

pip install -r requirements.txt

Run the Program

Inside the gesture-remote-control directory, execute main.py to start the application.

Gesture Mapping

Ensure the camera faces the gesture interaction area under stable lighting conditions.

Application Demonstration