Skip to content

v1.0.0 First stable release 🎉

Choose a tag to compare

@markusg1234 markusg1234 released this 17 Jul 11:49
· 241 commits to main since this release

The first tagged release of the ESP32 BLE HID Keyboard component for ESPHome (ESP-IDF / Bluedroid). Everything you need to turn an ESP32 into a fully native Bluetooth keyboard, mouse, and media remote.

Highlights

  • Native BLE HID keyboard — pairs with Windows, Android, and iOS (HOGP-compliant, battery + device info services, optional 6-digit passkey with legacy / secure_connections modes)
  • Typing & shortcuts — string typing with us / uk / de / be layouts (UTF-8 + dead keys), hex key combos, Ctrl-Alt-Del, sleep / hibernate / shutdown / power
  • Media & consumer control — volume, playback, mute, or any HID consumer code
  • Basic mouse — left/middle/right click, relative movement, scroll wheel
  • Multi-host switching — up to 10 bonded hosts with per-slot passkey and layout, fast directed-advertising reconnect
  • Web control page — full keyboard, mouse touchpad, remote, and editable macros (persisted to NVS) from any browser, no Home Assistant required
  • Home Assistant cards — keyboard, mouse, and remote Lovelace cards with matching services
  • Sensors — host RSSI with proximity triggers, keyboard LED state (Num/Caps/Scroll)

Install

external_components:
  - source:
      type: git
      url: https://github.com/markusg1234/ESPHome-espidf_ble_keyboard
      ref: v1.0.0
      path: components
    components: [ espidf_ble_keyboard ]

See the README for full configuration.