KO | EN

GitLite

Minimalist Open Source Repository Search Engine

gitlite — search

#dsh #dsh-plugin #developer-tools #ai-agent #claude-code #codex #typescript #ai-agents #deepseek-harness #mcp #cli #rust

virtual-painter

★ 18 Open GitHub ↗

A virtual painting app built with Python that lets you draw using hand gestures or mouse input. Powered by OpenCV & MediaPipe for real-time gesture tracking. Ideal for AI, CV, and creative tech enthusiasts!

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# 🎨 Virtual Painter

This project is a A professional-grade virtual painting application that transforms your webcam into an interactive canvas, enabling you to create digital art using hand gestures or mouse controls.. If you find this repository helpful or interesting, please consider giving it a star! ⭐ and Follow Me for cool Projects

## Why Star This Repository?

- It helps others discover the project.
- It motivates the me to keep improving it.
- It supports open-source development!

## How to Contribute

If you want to contribute, feel free to fork the repository and submit a pull request. Also, don’t forget to star the repo!

Thanks for your support! ❤

[Star the project](https://github.com/sayyedrabeeh/virtual-painter)

### 🖼️ Click any image below to watch the demo video:

### 🖼️ Click   image below :

## ✨ Features

- **Intuitive Controls** - Paint using either hand gestures (via webcam) or traditional mouse input
- **Multiple Tools** - Express your creativity with various drawing tools:
  - Brush
  - Eraser
  - Rectangle (outline and filled)
  - Circle (outline and filled)
  - Line tool
- **Color Palette** - Choose from 12 vibrant colors
- **Adjustable Brush Sizes** - Customize your brush thickness for precise control
- **Gesture Recognition** - Uses MediaPipe hand tracking for pinch-to-draw functionality
- **Canvas Manipulation** - Clear canvas option to start fresh
- **Smooth Drawing** - Point averaging for smoother lines and reduced jitter
- **Professional UI** - Clean, intuitive interface with visual feedback

## 🚀 Run Without Installing Python

If you **don’t want to install Python or dependencies manually**, you can use the pre-built `.exe` file:

### ✅ How to Use the `.exe` Version

1. **Download the `.exe` file** from the [Releases Section](https://github.com/sayyedrabeeh/virtual-painter/releases).

2. Ensure your system has a **working webcam** connected.

3. Double-click the `.exe` file to launch the app.

4. Start drawing instantly using your **mouse** or **hand gestures**.

> ⚠️ **Note:** Windows SmartScreen may block the file. Click **“More Info” → “Run Anyway”** to continue.

## 🖥️ Requirements

- Python 3.6+
- OpenCV (`cv2`)
- NumPy
- MediaPipe
- Webcam (for hand gesture functionality)

## 📋 Installation

1. Clone this repository:
   ```bash
   git clone https://github.com/sayyedrabeeh/virtual-painter.git
   cd virtual-painter
   ```

2. Install the required packages:
   ```bash
   pip install opencv-python numpy mediapipe
   ```

3. Run the application:
   ```bash
   python virtual_painter.py
   ```

## 🎮 How to Use

### Mouse Controls
- **Select Colors/Tools**: Click on the buttons at the top of the screen
- **Draw**: Click and drag on the canvas area
- **Create Shapes**: Click to set the starting point, drag to adjust size/position, and release to place the shape

### Hand Gesture Controls
- **UI Interaction**: Move your index finger to the top of the screen to select tools and colors
- **Drawing**:
  - Make a pinching gesture with your index and middle fingers to start drawing
  - Release the pinch to stop drawing
  - For shapes, pinch at the starting point, move to adjust size, and release to place

### Buttons and Functions
- **Color Selection**: Choose from 12 vibrant colors (top left)
- **Tool Selection**: Select your desired drawing tool (middle top)
- **Brush Size Control**: Adjust the thickness of your brush using + and - buttons (top right)
- **Clear Canvas**: Reset your entire canvas to start over

## 🔧 Technical Details

The application uses:
- **OpenCV** for image processing and UI rendering
- **MediaPipe** for hand landmark detection and tracking
- **NumPy** for efficient array operations
- **Collections.deque** for smooth point tracking and interpolation

Hand detection tracks your index finger for pointing and detects "pinch" gestures (index finger and middle finger proximity) for drawing actions.

## 🛠️ Customization

You can easily customize the application by modifying these parameters in the code:

- Add more colors to the `colors` list
- Adjust brush sizes in the `brush_size` list
- Add new tools to the `tools` list (requires implementing corresponding drawing functions)
- Change UI dimensions in the initialization section

## 💫 Support This Project
If you find Virtual Painter fun, helpful, or inspiring, please consider giving it a ⭐️ on GitHub — it helps boost visibility, supports the project, and motivates further development!
Your star is like a digital high-five 🙌 — and it truly means a lot!

🌟 Click the star at the top-right corner of this page to support!

Want to see more gesture-controlled creativity tools?
A star helps us bring more magic to your screen. ✨🎨

![GitHub Repo stars](https://img.shields.io/github/stars/sayyedrabeeh/virtual-painter?style=social)

## 🙏 Acknowledgements

- [OpenCV](https://opencv.org/) - The backbone of our computer vision functionality
- [MediaPipe](https://mediapipe.dev/) - For the amazing hand tracking capabilities
- [NumPy](https://numpy.org/) - For efficient numerical operations

---

<p align="center">Developed with ❤️ for Art Enthusiasts</p>

<h3 align="center">Happy Coding 🎨</h3>

virtual-painter

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README