An Arduino library to use Midi over Bluetooth Low Energy (BLE) on ESP32 boards.
If you find it useful you can 
#include <Arduino.h>
#include <BLEMidi.h>
void setup() {
Serial.begin(115200);
Serial.println("Initializing bluetooth");
BLEMidiServer.begin("Basic MIDI device");
Serial.println("Waiting for connections...");
//BLEMidiServer.enableDebugging(); // Uncomment if you want to see some debugging output from the library
}
void loop() {
if(BLEMidiServer.isConnected()) { // If we've got a connection, we send an A4 during one second, at full velocity (127)
BLEMidiServer.noteOn(0, 69, 127);
delay(1000);
BLEMidiServer.noteOff(0, 69, 127); // Then we stop the note and make a delay of one second before returning to the beginning of the loop
delay(1000);
}
}
Check the header file here to view all available MIDI commands and callbacks.
-
v0.4.0
- 2026-07-15
- Integration of Nimble v2.x
- API change for BLE client : previously, a scan filtered the devices that advertised a MIDI service. But not all devices advertise a MIDI service, even if they support it (for example the MVAVE Chocolat footswitch). Now, a scan returns all the BLE devices, you have to check which one is your device, then connect to it.
- Added an example for the MVAVE Chocolate footswitch
- 2026-07-15
-
v0.3.2
- 2023-04-25
- Added BLEMidi::end() to stop the BLE client or server.
- 2023-04-25
-
v0.3.1
- 2023-03-12
- Added a simple knob example
- 2023-03-12
-
v0.3.0
- 2022-12-27
- Migrated to NimBLE using NimBLE-Arduino library
- 2022-12-27
-
2022-01-23
- Merged PR from trdenton : Support for MMC transport controls
-
v0.2.2
- 2021-09-20
- Bug corrections : connection/disconnection callbacks weren't called when they where set up after BLEMidiServer.begin(), and no more connection were accepted after a disconnection. Thanks to Kim for the information provided.
- 2021-09-20
-
v0.2.1
- 2021-03-16
- Bug correction : the WDT used to reset the ESP32 when lots of messages were received, because the IDLE task didn't have time to call esp_task_wdt_reset
- 2021-03-16
-
v0.2.0
- 2021-03-12
- Implemented support for running status messages
- 2021-03-13
- After touch support
- 2021-03-12
-
v0.1.2
- 2021-03-02
- Added pitch bend callback
- Added a range parameter for pitch bend sending
- 2021-03-11
- Added an a new overload for pitch bend sending
- 2021-03-02
-
v0.1.1
- 2020-12-29
- Integrated bug fix from Georaura
- 2020-12-30
- Implemented packet timestamps
- 2020-12-29
-
Add some more examples
-
Add documentation, with Doxygen ?
-
Add keywords.txt for Arduino IDE
-
Add support for realtime messages ?
-
Add debugging messages in BLEMidiServer ?
-
Better debug function
Thanks to the authors of those pages / pieces of code :
- https://github.com/neilbags/arduino-esp32-BLE-MIDI/blob/master/BLE_MIDI.ino (write midi messages)
- https://gist.github.com/johnty/cbfa66c3369a692410f3493c20b2b3e2 (read and write)
- https://circuitdigest.com/microcontroller-projects/esp32-ble-client-connecting-to-fitness-band-to-trigger-light (initiate the connection to another bluetooth device)
- and the Arduino BLE_Client example sketch for ESP32 boards
If you make some noise with it, I would be glad to see your projects ! Don't hesitate to drop me an e-mail.