# ESP32-BLE-HID

**Repository Path**: pikename/ESP32-BLE-HID

## Basic Information

- **Project Name**: ESP32-BLE-HID
- **Description**: 蓝牙Hid库开源-无需无障碍 Root Adb等权限即可实现自动化测试。                                      
Github仓库 ：https://github.com/0cococ/ESP32-BLE-HID
支持的功能：
Hid键盘 
Hid绝对鼠标 
蓝牙双向通信   
如果对你有用可以给个原作者一个star
- **Primary Language**: C/C++
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 4
- **Forks**: 1
- **Created**: 2024-08-09
- **Last Updated**: 2025-08-08

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# ESP32 BLE HID Keyboard, Abs Mouse, and Two-Way Communication Library
This library enables ESP32 development boards to function as Bluetooth HID devices, supporting features such as keyboard input, absolute mouse control, and two-way communication.

## Contact Me
- QQ群: 710985269
- QQ: 3560000009

## Installation
- In the Arduino IDE go to "Sketch" -> "Include Library" -> "Add .ZIP Library..." and select the file you just downloaded.
- You can now go to "File" -> "Examples" -> "ESP32 BLE HID" and select any of the examples to get started.

## Example
```
#include <BleCombo.h>
BleComboKeyboard keyboard("cheese-ble-hid", "Espressif", 100);
BleComboMouse mouse(&keyboard);
class MyCallbacks: public BLECharacteristicCallbacks {
	void onRead(BLECharacteristic* pCharacteristic) { }
	void onWrite(BLECharacteristic *pCharacteristic) { }
};
void setup() {
  Serial.begin(115200);
  Serial.println("Starting work!");
  MyCallbacks myCallbacks;
  keyboard.setCallbacks(&myCallbacks);
  keyboard.begin();
  mouse.begin(); 
}
void loop() {
  if(Keyboard.isConnected()) {
   mouse.click();
  }
  delay(2000);
}
```
- 本库仅供学习使用，请勿用于非法用途，否则后果自负。
- 用户明确理解并同意，任何违反法律法规、侵犯他人合法权益的行为，均与本项目及其开发者无关，后果由用户自行承担。

## Credits
This project is heavily based on their work:
- [ESP32-BLE-Mouse](https://github.com/T-vK/ESP32-BLE-Mouse)
- [ESP32-BLE-Keyboard](https://github.com/T-vK/ESP32-BLE-Keyboard)
- [ESP32-BLE-Abs-Mouse](https://github.com/sobrinho/ESP32-BLE-Abs-Mouse)
- [ESP32-BLE-Combo](https://github.com/blackketter/ESP32-BLE-Combo)