Skip to main content

Remote mouse control server with web interface and REST API

Project description

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

PyPI version Python 3.9+ License: MIT

Quick Start

Installation

pip install aircursor

Running the Server

# 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

GET /api/v1/cursor

Set Cursor Position

PUT /api/v1/cursor
Content-Type: application/json

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

Move Cursor (Relative)

PATCH /api/v1/cursor
Content-Type: application/json

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

Mouse Click

POST /api/v1/click
Content-Type: application/json

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

Scroll

POST /api/v1/scroll
Content-Type: application/json

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

Contributing

Contributions are welcome! Please visit the GitHub repository for more information.

License

This project is licensed under the MIT License.


** Give it a star on GitHub!**

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

aircursor-1.0.6.tar.gz (11.5 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

aircursor-1.0.6-py3-none-any.whl (11.3 kB view details)

Uploaded Python 3

File details

Details for the file aircursor-1.0.6.tar.gz.

File metadata

  • Download URL: aircursor-1.0.6.tar.gz
  • Upload date:
  • Size: 11.5 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.10.11

File hashes

Hashes for aircursor-1.0.6.tar.gz
Algorithm Hash digest
SHA256 3401a3d46f8d52d22b1739060e6c8a156d69044badb99eceada40fc8e10bd07c
MD5 b3da801f40dc9c2bd422edf4f0b406c2
BLAKE2b-256 75a79c971a4bed7d177f8f33b159cd8b179d6dd8590dea5d3f591e77f3562723

See more details on using hashes here.

File details

Details for the file aircursor-1.0.6-py3-none-any.whl.

File metadata

  • Download URL: aircursor-1.0.6-py3-none-any.whl
  • Upload date:
  • Size: 11.3 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.10.11

File hashes

Hashes for aircursor-1.0.6-py3-none-any.whl
Algorithm Hash digest
SHA256 2a862f47b7781a03918b52ef27ecdcf4bfc87de68368c2574765eac6110939b4
MD5 d314e84acc62032b2bb7be2d2accb67f
BLAKE2b-256 fdf574b80310a27b8b7fa087e3e6ab4d8006903a157c56b4d0d43b0de57cf3be

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page