Skip to content

Wireless HID v0.9.0-beta

Latest
Latest

Choose a tag to compare

View all tags
@Marak123 Marak123 released this 05 Jul 15:39
v0.9.0-beta
4cca2cc

Wireless HID v0.9.0-beta

First public release. WireHID turns your laptop into a wireless keyboard, mouse and clipboard for another PC, via an ESP32-S3 USB dongle (LilyGO T-Dongle-S3). The target PC sees a plain USB HID device - nothing to install on it.

Highlights

  • Wireless keyboard + mouse over BLE (primary) with Wi-Fi/TCP fallback.
  • Clipboard typed paste from host to target (Ctrl+Shift+V).
  • Per-monitor capture with a clear full-screen overlay and global hotkeys (Ctrl+Alt+F12).
  • Safety guards: heartbeat, session timeout, automatic release-all.
  • Low-latency input path: dedicated event pump thread + batched BLE writes (write-without-response).
  • Two firmware images: plain HID (default) and HID+ADB with the experimental ADB Wireless Bridge.

⚠️ ADB Wireless Bridge - experimental

The HID+ADB image previews a mode where the dongle becomes a USB Host for an Android phone and tunnels adb over Wi-Fi (no cable). It is a work in progress and not reliable for daily use yet - see docs/ADB_BRIDGE.md. If you just want a wireless keyboard/mouse, flash the plain HID image.

Assets

Asset What it is
wirehid-firmware-hid-v0.9.0-beta.zip HID firmware image (bootloader + partition table + app) + flash instructions
wirehid-firmware-hid-adb-v0.9.0-beta.zip HID+ADB firmware image + flash instructions
WireHIDHost-v0.9.0-beta-win64.zip Windows host app (standalone EXE, bundled native DLL - no Python needed) + autostart scripts

Quick start

  1. Flash the HID image (see FLASH.txt inside the zip, or build from source with ESP-IDF v6.0).
  2. Run WireHIDHost.exe (or python run_host.py from source), pick a monitor, Connect.
  3. Ctrl+Alt+F12 to arm, move the cursor onto the armed monitor, type away. Ctrl+Shift+V pastes your clipboard.

Known issues

  • ADB Bridge handshake/framing still being hardened; large adb push/pull may stall.
  • Clipboard paste is ASCII-first (non-ASCII gets transliterated).
  • Host app is Windows-only for now.

Full changelog: see CHANGELOG.md.

Author: Marak123 - built with AI tooling (Claude Code: Opus 4.6 & Fable 5). License: MIT.

Assets 5
Loading