Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/skratchdot/ble-midi
A Bluetooth Low Energy MIDI library written in javascript
https://github.com/skratchdot/ble-midi
ble bluetooth cli javascript midi node web-bluetooth
Last synced: 3 months ago
JSON representation
A Bluetooth Low Energy MIDI library written in javascript
- Host: GitHub
- URL: https://github.com/skratchdot/ble-midi
- Owner: skratchdot
- License: mit
- Created: 2017-02-26T13:31:34.000Z (almost 8 years ago)
- Default Branch: master
- Last Pushed: 2017-03-01T22:32:34.000Z (almost 8 years ago)
- Last Synced: 2024-10-19T00:27:18.421Z (3 months ago)
- Topics: ble, bluetooth, cli, javascript, midi, node, web-bluetooth
- Language: JavaScript
- Homepage: https://projects.skratchdot.com/ble-midi/
- Size: 1.63 MB
- Stars: 39
- Watchers: 5
- Forks: 11
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- License: LICENSE-MIT
Awesome Lists containing this project
README
# ble-midi
[](http://badge.fury.io/js/ble-midi)
[](https://travis-ci.org/skratchdot/ble-midi)
[](https://codeclimate.com/github/skratchdot/ble-midi)
[](https://coveralls.io/github/skratchdot/ble-midi?branch=master)
[](https://david-dm.org/skratchdot/ble-midi)
[](https://david-dm.org/skratchdot/ble-midi?type=dev)
[](https://npmjs.org/package/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
```bash
# 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](https://www.midi.org/specifications/item/bluetooth-le-midi)
- [Apple](https://developer.apple.com/bluetooth/Apple-Bluetooth-Low-Energy-MIDI-Specification.pdf)
### Helpful MIDI Tools
- [fluidsynth](http://www.fluidsynth.org/)
- [midikeys](http://www.manyetas.com/creed/midikeys.html)
- [S. Christian Collins GeneralUser GS Soundfont](http://www.schristiancollins.com/generaluser.php)
### Android
- [Bluetooth Low Energy on Android](https://developer.android.com/guide/topics/connectivity/bluetooth-le.html)
- [MIDI Package Summary](https://developer.android.com/reference/android/media/midi/package-summary.html)
- [BLE Test Peripheral](https://github.com/WebBluetoothCG/ble-test-peripheral-android)
- [BLE MIDI Example App for Android](https://github.com/kshoji/BLE-MIDI-for-Android)
### Products
- [Yamaha MD-BT01](https://www.amazon.com/Yamaha-Wireless-5-PIN-MIDI-Adapter/dp/B01CFOHF6U/)
- [Quicco Sound mi.1](https://www.amazon.com/Wireless-MIDI-Interface-mi-1-Rev-3/dp/B01D61QK6W/)
### 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](https://www.skratchdot.com/)
Licensed under the
[MIT license](https://github.com/skratchdot/ble-midi/blob/master/LICENSE-MIT).