sunbox/ble-midi

A Bluetooth Low Energy MIDI library written in javascript

ble-midi

Description

A Bluetooth Low Energy MIDI library written in javascript.

The following service and characteristic are defined:

• MIDI Service (UUID: 03B80E5A-EDE8-4B33-A751-6CE34EC4C700)
• MIDI Data I/O Characteristic (UUID: 7772E5DB-3868-4112-A1A9-F2669D106BF3)
• Supports:
  • write (encryption recommended, write without response is required)
  • read (encryption recommended, respond with no payload)
  • notify (encryption recommended)

Getting Started

# install cli
npm install -g ble-midi

# install helper tool
brew install fluidsynth

# download soundfont
wget https://dl.dropboxusercontent.com/u/8126161/GeneralUser_GS_1.471.zip
unzip -p GeneralUser_GS_1.471.zip "GeneralUser GS 1.471/GeneralUser GS v1.471.sf2" > gs.sf2

# start fluidsynth
fluidsynth -d ./gs.sf2

# find fluidsynth port
ble-midi list-devices

# start advertising (if fluidsynth was device #2- if not, just use correct device number)
ble-midi advertise --midi-out 2

# now connect to "skratchdot-ble-midi" from another device and start playing

Links

Specifications

• midi.org
• Apple

Helpful MIDI Tools

• fluidsynth
• midikeys
• S. Christian Collins GeneralUser GS Soundfont

Android

• Bluetooth Low Energy on Android
• MIDI Package Summary
• BLE Test Peripheral
• BLE MIDI Example App for Android

Products

• Yamaha MD-BT01
• Quicco Sound mi.1

Random

• http://shawnhymel.com/703/bluetooth-low-energy-peripherals-with-javascript/

Credits

• MIDI Icon by Kurt Lorenz from the Noun Project
• Bluetooth Icon by Barracuda from the Noun Project

License

Copyright (c) 2017 skratchdot
Licensed under the MIT license.