ble_hid

Official

Turn your ESP32 into a BLE keyboard and mouse.

Authorespressif
Version1.0.0
Installs0

System Documentation

What problem does it solve?

It solves the need to control devices through standard HID inputs (keyboard, mouse, media keys) without writing a full host-side app, so your ESP32 can behave like a human user.

Core Features & Use Cases

  • Start BLE HID advertising: make the device appear as a composite HID peripheral supporting media, keyboard, and mouse actions at once.
  • Send media/keyboard/mouse actions: drive media playback controls, type keys or text, and perform mouse movement and clicks.
  • Composite report control by action type: choose which HID report is sent by the requested action type (media, keyboard_key, keyboard_combo, keyboard_text, or mouse_move).

Use case example: You need an ESP32 to quickly pause/play media and type a short command sequence on a nearby computer by emulating a keyboard and media controller.

Quick Start

Tell the agent: "Start the ble_hid skill, advertise as a BLE HID device named esp-claw-hid, then send a keyboard combo CTRL+C to trigger the action I need."

Dependency Matrix

Required Modules

None required

Components

scripts

💻 Claude Code Installation

Recommended: Let Claude install automatically. Simply copy and paste the text below to Claude Code.

Please help me install this Skill:
Name: ble_hid
Download link: https://github.com/espressif/esp-claw/archive/main.zip#ble-hid

Please download this .zip file, extract it, and install it in the .claude/skills/ directory.
View Source Repository

Agent Skills Search Helper

Install a tiny helper to your Agent, search and equip skill from 471,000+ vetted skills library on demand.