Awesome Open Source
Awesome Open Source

ESP32 BLE Mouse library

This library allows you to make the ESP32 act as a Bluetooth Mouse and control what it does. E.g. move the mouse, scroll, make a click etc.

You might also be interested in:


  • [x] Left click
  • [x] Right click
  • [x] Middle click
  • [x] Back/Forwards click
  • [x] Move mouse pointer left/right
  • [x] Move mouse pointer up/down
  • [x] Scroll up/down
  • [x] Scroll left/right
  • [x] Report optional battery level to host (basically works, but it doesn't show up in Android's status bar)
  • [x] Customize Bluetooth device name/manufacturer
  • [x] Compatible with Android
  • [x] Compatible with Windows
  • [x] Compatible with Linux
  • [x] Compatible with MacOS X (not stable, some people have issues, doesn't work with old devices)
  • [x] Compatible with iOS (not stable, some people have issues, doesn't work with old devices)



 * This example turns the ESP32 into a Bluetooth LE mouse that scrolls down every 2 seconds.
#include <BleMouse.h>

BleMouse bleMouse;

void setup() {
  Serial.println("Starting BLE work!");

void loop() {
  if(bleMouse.isConnected()) {
    Serial.println("Scroll Down");

API docs

The BleMouse interface is almost identical to the Mouse Interface, so you can use documentation right here:

Just remember that you have to use bleMouse instead of just Mouse and you need these two lines at the top of your script:

#include <BleMouse.h>
BleMouse bleMouse;

This library supports a few additional features that the Mouse library does not support at the time of writing:

  • Scrolling left/right E.g.: bleMouse.move(0,0,0,1) (Scroll left) and bleMouse.move(0,0,0,-1) (Scroll right)
  • Using the back and forward buttons E.g.: and

There is also Bluetooth specific information that you can use (optional):

Instead of BleMouse bleMouse; you can do BleMouse bleMouse("Bluetooth Device Name", "Bluetooth Device Manufacturer", 100);. The third parameter is the initial battery level of your device. To adjust the battery level later on you can simply call e.g. bleMouse.setBatteryLevel(50) (set battery level to 50%). By default the battery level will be set to 100%, the device name will be ESP32 Bluetooth Mouse and the manufacturer will be Espressif.


Credits to chegewara as this library is based on this piece of code that he provided.

Alternative Project Comparisons
Related Awesome Lists
Top Programming Languages
Top Projects

Get A Weekly Email With Trending Projects For These Topics
No Spam. Unsubscribe easily at any time.
C Plus Plus (241,813
Arduino (30,783
Esp (8,403
Mouse (6,847
Bluetooth (6,752
Esp32 (4,165
Ble (2,952
Arduino Library (2,354
Arduino Ide (1,327
Bluetooth Le (748