README.md

Gesture Control ✋💡

Manage Philips Hue Lights with Hand Gestures

Table of Contents

1. Note for Non-Linux Systems
2. About The Project
   • Built With
3. Getting Started
   • Installation
4. Run The Application

Note for Non-Linux Systems

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.

About The Project

Gesture Control is a project that empowers you to control your Philips Hue lights using hand gestures.

Built With

• Python
• MediaPipe
• OpenCV

Getting Started

To get a local copy up and running follow these simple example steps.

Installation

1. Clone the repo

   git clone https://github.com/iammatthi/gesture-control.git

2. Move into the newly created folder

   cd gesture-control

3. Configure the application
   • Use automatic configuration (recommended)

     chmod +x configure.sh
     ./configure.sh

   • Use manual configuration
     1. Create virtual environment

     python3 -m venv venv

     2. Activate virtual environment

     source venv/bin/activate

     3. Install dependencies

     pip install -r requirements.txt

     4. 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

     5. Create and edit config.yml file (see config.yml.example for an example)
        • Follow this guide to get all information needed for the config file

Run The Application

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