Metadata-Version: 2.4
Name: airmouse
Version: 0.1.0
Summary: A high-performance webcam-based Air Mouse using Python, MediaPipe, and OpenCV.
Project-URL: Homepage, https://github.com/Kisses99/airmouse
Project-URL: Repository, https://github.com/Kisses99/airmouse
Project-URL: Issues, https://github.com/Kisses99/airmouse/issues
Author-email: Kai Tao <kilotao@gmail.com>
License: MIT License
        
        Copyright (c) 2026 Kai Tao
        
        Permission is hereby granted, free of charge, to any person obtaining a copy
        of this software and associated documentation files (the "Software"), to deal
        in the Software without restriction, including without limitation the rights
        to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
        copies of the Software, and to permit persons to whom the Software is
        furnished to do so, subject to the following conditions:
        
        The above copyright notice and this permission notice shall be included in all
        copies or substantial portions of the Software.
        
        THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
        IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
        FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
        AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
        LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
        OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
        SOFTWARE.
License-File: LICENSE
Keywords: airmouse,computer-vision,gesture-control,mediapipe,mouse-control
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: End Users/Desktop
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: Microsoft :: Windows
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Multimedia :: Graphics
Classifier: Topic :: Utilities
Requires-Python: >=3.10
Requires-Dist: mediapipe==0.10.11
Requires-Dist: numpy<2.0
Requires-Dist: opencv-python<4.13
Requires-Dist: pyautogui>=0.9.54
Requires-Dist: pygame>=2.6.1
Requires-Dist: pygrabber>=0.2
Requires-Dist: pyopengl>=3.1.10
Description-Content-Type: text/markdown

# Lumina Air Mouse

A high-performance "Air Mouse" using Python, MediaPipe, and OpenCV. Control your computer cursor and perform gestures using just your webcam.

## Features
- **Precise Cursor Control**: Smooth index finger tracking.
- **Dwell Clicking**: Hover over an area to trigger a left click.
- **Drag Gestures**: Pinch (Index + Thumb) for left drag, Fist for right drag.
- **Scroll Support**: Two-finger vertical movement for scrolling.
- **Visual Feedback**: Real-time HUD showing tracking status and gesture progress.

## Installation

### Using pip
```bash
pip install airmouse
```

### From Source (Development)
1. Clone the repository:
   ```bash
   git clone https://github.com/Kisses99/airmouse.git
   cd airmouse
   ```
2. Install dependencies using `uv`:
   ```bash
   uv sync
   ```

## Usage

Run the air mouse via the command line:

```bash
airmouse
```

Or if running from source:
```bash
uv run airmouse
```

## Gestures
- **Move Cursor**: Point with your index finger.
- **Left Click**: Hold the cursor still on a point for 0.8s.
- **Left Drag**: Pinch your index finger and thumb together and move.
- **Right Drag**: Make a fist and move.
- **Scroll**: Hold your index and middle fingers up together and move up/down.

## Requirements
- Python 3.10 or higher
- A webcam
- Windows OS (Currently optimized for Windows via `DirectShow`)

## License
MIT
