Metadata-Version: 2.4
Name: aircursor
Version: 1.0.4
Summary: Remote mouse control server with web interface and REST API
Author-email: NiqueWrld <niquewrld@outlook.com>
Project-URL: Homepage, https://github.com/NiqueWrld/AirCursor
Project-URL: Repository, https://github.com/NiqueWrld/AirCursor
Project-URL: Issues, https://github.com/NiqueWrld/AirCursor/issues
Project-URL: Documentation, https://github.com/NiqueWrld/AirCursor#readme
Keywords: flask,mouse,automation,remote,control,REST,qr,web
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: End Users/Desktop
Classifier: Topic :: System :: Hardware
Classifier: Topic :: Internet :: WWW/HTTP :: HTTP Servers
Classifier: Topic :: Desktop Environment
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Requires-Python: >=3.9
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: Flask<4,>=3.0.3
Requires-Dist: flask-cors<5,>=4.0.1
Requires-Dist: pyautogui==0.9.54
Requires-Dist: qrcode[pil]==7.4.2
Requires-Dist: pillow>=9.2.0
Requires-Dist: PyScreeze>=0.1.30
Requires-Dist: PyTweening>=1.0.4
Requires-Dist: mouseinfo>=0.1.3
Requires-Dist: pymsgbox>=1.0.9
Requires-Dist: pygetwindow>=0.0.9
Requires-Dist: pyrect>=0.2.0
Dynamic: license-file

﻿# AirCursor - Remote Mouse Control Server

```
     _    ___ ____   ____ _   _ ____  ____   ___  ____  
    / \  |_ _|  _ \ / ___| | | |  _ \/ ___| / _ \|  _ \ 
   / _ \  | || |_) | |   | | | | |_) \___ \| | | | |_) |
  / ___ \ | ||  _ <| |___| |_| |  _ < ___) | |_| |  _ < 
 /_/   \_\___|_| \_\____\___/|_| \_\____/ \___/|_| \_\
```

A lightweight, cross-platform HTTP server that transforms your computer into a remote-controllable mouse. Perfect for presentations, media centers, IoT projects, and accessibility solutions.

**Created by:** [NiqueWrld](https://github.com/NiqueWrld)

[![PyPI version](https://badge.fury.io/py/aircursor.svg)](https://badge.fury.io/py/aircursor)
[![Python 3.9+](https://img.shields.io/badge/python-3.9+-blue.svg)](https://www.python.org/downloads/)
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)

##  Quick Start

### Installation

```bash
pip install aircursor
```

### Running the Server

```bash
# Run directly
aircursor

# Or with Python module
python -m aircursor
```

##  Features

-  **Full Mouse Control**: Move cursor, click, scroll, and drag operations
-  **Web Interface**: Clean, responsive interface accessible from any device
-  **RESTful API**: Programmatic control for automation and integration
-  **QR Code Access**: Instant connection via generated QR codes
-  **Multi-Platform**: Works on Windows, macOS, and Linux
-  **Local Network**: Secure operation within your local network
-  **Lightweight**: Minimal resource usage and fast response times

##  API Reference

### Get Cursor Position
```http
GET /api/v1/cursor
```

### Set Cursor Position
```http
PUT /api/v1/cursor
Content-Type: application/json

{"x": 500, "y": 300}
```

### Move Cursor (Relative)
```http
PATCH /api/v1/cursor
Content-Type: application/json

{"dx": 10, "dy": -5}
```

### Mouse Click
```http
POST /api/v1/click
Content-Type: application/json

{
  "button": "left",
  "count": 1,
  "at": {"x": 100, "y": 200}
}
```

### Scroll
```http
POST /api/v1/scroll
Content-Type: application/json

{"dx": 0, "dy": -3}
```

##  Contributing

Contributions are welcome! Please visit the [GitHub repository](https://github.com/NiqueWrld/AirCursor) for more information.

##  License

This project is licensed under the MIT License.

---

** Give it a star on [GitHub](https://github.com/NiqueWrld/AirCursor)!**
