An open API service indexing awesome lists of open source software.

https://github.com/krishbharadwaj5678/palmeter

Palmeter is a real time hand tracking tool which detect multiple hands and measure the distance between them.
https://github.com/krishbharadwaj5678/palmeter

computer-vision cv2 cvzone distance-calculation gesture-recognition hand-detection hand-tracking measurement mediapipe opencv python real-time realtime-processing tracking

Last synced: 5 months ago
JSON representation

Palmeter is a real time hand tracking tool which detect multiple hands and measure the distance between them.

Awesome Lists containing this project

README

          

# โœ‹ Palmeter

**Palmeter** is a Python powered real time hand tracking tool that detect multiple hands and calculate the **distance between them**.๐Ÿ“

![PalmeterDemo](https://github.com/KrishBharadwaj5678/Palmeter/raw/main/PalmeterDemo.png)

---

## ๐ŸŒŸ Features

| Feature | Description |
|----------------------------------|-----------------------------------------------------------------------------|
| โœ‹ Multi Hand Detection | Detects **two hands** in real time using MediaPipe |
| ๐Ÿ“ Palm Distance Calculation | Calculates **distance between palms** |
| ๐ŸŽฏ Real Time Display | Dynamically displays distance on the screen |
| ๐Ÿ–ผ๏ธ Visual Overlays | Draws hand landmarks for better understanding |
| ๐Ÿ” Continuous Tracking | Continuously updates hand positions frame by frame |
| โšก Lightweight Performance | Runs fast even on low spec machines using only CPU |
| ๐Ÿงช Easy to Extend | Clean codebase ready for gesture recognition |

---

## ๐Ÿ› ๏ธ Tech Stack

| Technology | Description |
| ------------------ | ------------------------------------------------------------------- |
| ๐Ÿง  MediaPipe | Hand landmark detection |
| ๐ŸŽฅ OpenCV | Real time computer vision library |
| โš™๏ธ CvZone | Simplifies hand tracking |
| ๐Ÿ Python 3.x | Programming language |

---

## ๐Ÿš€ Installation

1. Clone the repository:
```bash
git clone https://github.com/KrishBharadwaj5678/Palmeter.git
cd Palmeter
````

2. Install dependencies:

```bash
pip install -r requirements.txt
```

3. Run the script:

```bash
python app.py
```

---

## ๐Ÿค Contributing

We welcome contributions to **Palmeter**!

1. **๐Ÿด Fork the repository**

2. **๐Ÿ“ฅ Clone your fork**

```bash
git clone https://github.com/KrishBharadwaj5678/Palmeter.git
cd Palmeter
```

3. **๐ŸŒฟ Create a new branch**

```bash
git checkout -b feature/your-feature-name
```

4. **๐Ÿ› ๏ธ Make your changes**

5. **โœ… Test your changes**

6. **๐Ÿ’พ Commit your changes**

```bash
git add .
git commit -m "Add feature XYZ or Fix bug ABC"
```

7. **๐Ÿš€ Push to your fork**

```bash
git push origin feature/your-feature-name
```

8. **๐Ÿ“ฌ Create a Pull Request (PR)**
- Go to your fork on GitHub and click **Compare & pull** request.
- Describe your changes clearly and submit the PR.