Table of Contents
The instructions provided in this README are tailored for Linux systems. If you are using a different operating system, such as macOS or Windows, please be aware that some commands may not work as-is.
Gesture Control is a project that empowers you to control your Philips Hue lights using hand gestures.
To get a local copy up and running follow these simple example steps.
- Clone the repo
git clone https://github.com/iammatthi/gesture-control.git
- Move into the newly created folder
cd gesture-control
- Configure the application
- Use automatic configuration (recommended)
chmod +x configure.sh ./configure.sh
- Use manual configuration
- Create virtual environment
python3 -m venv venv
- Activate virtual environment
source venv/bin/activate
- Install dependencies
pip install -r requirements.txt
- Download gesture recognition model
mkdir models wget -q https://storage.googleapis.com/mediapipe-models/gesture_recognizer/gesture_recognizer/float16/1/gesture_recognizer.task -O models/gesture_recognizer.task
- Create and edit
config.yml
file (seeconfig.yml.example
for an example)- Follow this guide to get all information needed for the config file
- Use automatic configuration (recommended)
Make sure you have a virtual environment activated (source venv/bin/activate
). Then run the following command:
python main.py
Now you can control your lights with hand gestures. The following gestures are supported:
- โ: Turn lights on
- โ: Turn lights off
- ๐: Increase brightness
- ๐: Decrease brightness