AnywhereInput

Control your Windows, Linux, or macOS PC from any browser. No app install, no account, no cloud dependency.

Run a Python server on your PC and control it from any browser — mouse, keyboard, scrolling, real-time screen capture, with zero-config tunnel support.

⚡ Quick Install

pip install anywhereinput
anywhereinput --tunnel cloudflare   # or: tailscale, pinggy, zrok2, local

Ubuntu (recommended via pipx):

sudo apt install pipx && pipx ensurepath
pipx install anywhereinput
anywhereinput --tunnel cloudflare

🖥️ Desktop Admin App (Optional)

pip install anywhereinput[app]    # includes PyQt6
anywhereinput --app               # visual GUI — no terminal needed

The desktop app lets you start/stop the server, pick tunnel providers, manage access tokens with IP allowlists, and monitor connected clients — all from a visual window.

Why AnywhereInput?

✨ Features

• Mouse — move, click (left/right/middle), double-click, scroll
• Keyboard — key press, text typing, arrow keys, hotkey combos (Ctrl+C, Ctrl+Alt+Del, etc.)
• Screen Capture — real-time JPEG stream to browser, up to 120 FPS
• Touchpad Gestures — two-finger scroll, long-press right click, tap-to-click
• Screen Overlay Click — tap anywhere on the live stream to move the cursor there
• Watch Mode — fullscreen stream with fit/fill toggle (⛶ button), keyboard always visible
• Multi-monitor — auto cursor tracking across all detected displays
• Tunnels — Cloudflare (free, auto-download), Tailscale P2P, Pinggy.io SSH, Zrok2, or LAN-only
• Security — per-token input permissions, IP allowlists (CIDR), rate limiting (10 auth/min/IP), auto-rotating tokens

🚀 Usage

Interactive Menu (Default)

anywhereinput
# Select tunnel provider from the menu

Direct Start with Tunnel

anywhereinput --tunnel cloudflare    # Fastest global access
anywhereinput --tunnel tailscale       # Peer-to-peer on your tailnet
anywhereinput --tunnel pinggy          # SSH tunnel, works behind firewalls
anywhereinput --tunnel zrok2           # Open source, zero-trust
anywhereinput --tunnel local           # Same WiFi/LAN only

Full Configuration

anywhereinput   --host 127.0.0.1   --port 8008   --fps 60   --quality 80   --scale 0.75   --monitor 1   --tunnel cloudflare

🔒 Security

• Auto-generated 32-character access token on every server start
• Per-token permissions — grant/restrict move, click, scroll, keyboard, screen_toggle, ping
• IP allowlists per token — CIDR ranges and single-host support
• Rate limiting — 10 auth attempts/min per IP with automatic lockout
• Token rotation — press n + Enter or Ctrl+N to invalidate all previous tokens
• HTTPS/WSS encryption when using any tunnel provider
• Zero data stored on external servers

⚠️ Designed for personal/trusted environments. For production exposure, add a reverse proxy (nginx/Traefik) with OAuth or mTLS.

📡 WebSocket API

Authenticate

{"type": "auth", "token": "***"}

Send Commands

{"type": "move", "mode": "relative", "dx": 10, "dy": 15}
{"type": "move", "mode": "absolute", "dx": 0.5, "dy": 0.5}
{"type": "click", "button": "left", "clicks": 1}
{"type": "scroll", "amount": 15}
{"type": "key", "key": "enter"}
{"type": "hotkey", "keys": ["ctrl", "c"]}
{"type": "screen_toggle", "enabled": true}
{"type": "ping"}

Receive Events

{"type": "screen", "data": "<base64-jpeg>"}
{"type": "screen_status", "status": "rebuilding", "message": "Reconnecting to display..."}
{"error": "capture_error", "message": "Input engine is recovering.", "recovering": true}

HTTP Endpoints

🧰 Troubleshooting

📋 System Requirements

📦 Dependencies

pyautogui==0.9.54
aiohttp==3.14.1
requests==2.34.2
qrcode[pil]==8.2
mss==10.2.0
Pillow==12.3.0
pyyaml==6.0.3
PyQt6==6.11.0   # Optional, for --app GUI

🔗 Links

• Website: https://www.anywhereinput.com
• GitHub: https://github.com/Z-Hussein/AnywhereInput
• PyPI: https://pypi.org/project/anywhereinput/
• Issues: https://github.com/Z-Hussein/AnywhereInput/issues
• License: MIT

Built with ❤️ for developers who value simplicity over complexity.