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
pip install airmouse
From Source (Development)
- Clone the repository:
git clone https://github.com/Kisses99/airmouse.git cd airmouse
- Install dependencies using
uv:uv sync
Usage
Run the air mouse via the command line:
airmouse
Or if running from source:
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
1 maintainer
Metadata
1 maintainer
Release files for airmouse 0.1.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| airmouse-0.1.0.tar.gz | 115.6 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| airmouse-0.1.0-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 122.7 kB
Release files / airmouse-0.1.0.tar.gz
| Download URL | airmouse-0.1.0.tar.gz |
|---|---|
| Size | 115.6 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
2ee96f14b4c41c578dfcabcbed553625d7a05c4a4801b7679c5298abc461b5b1
|
|
BLAKE2b-256 checksum How to use checksums |
3f1434c3ff97973f81b54cec52c5f97645dfc4d95c9dd3385f185ca62cbed39b
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.11.8 {"installer":{"name":"uv","version":"0.11.8","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":null,"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
|
Release files / airmouse-0.1.0-py3-none-any.whl
| Download URL | airmouse-0.1.0-py3-none-any.whl |
|---|---|
| Size | 7.2 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
02a096bc9c97e1f1996606fc77bf463478bb12e3b00628e0bff61d13a4ba1768
|
|
BLAKE2b-256 checksum How to use checksums |
37ddb90d0e1411695434a36a7d06d53f660843f76b6fe119cc1004297ac4bd3b
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.11.8 {"installer":{"name":"uv","version":"0.11.8","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":null,"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
|
