Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/jazz-soft/JZZ-midi-Gear
Retrieve your MIDI device model and manufacturer
https://github.com/jazz-soft/JZZ-midi-Gear
midi web-midi web-midi-api webmidi webmidiapi
Last synced: 25 days ago
JSON representation
Retrieve your MIDI device model and manufacturer
- Host: GitHub
- URL: https://github.com/jazz-soft/JZZ-midi-Gear
- Owner: jazz-soft
- License: mit
- Created: 2016-05-04T23:42:49.000Z (over 8 years ago)
- Default Branch: master
- Last Pushed: 2024-09-09T23:18:09.000Z (3 months ago)
- Last Synced: 2024-11-10T07:40:22.926Z (about 1 month ago)
- Topics: midi, web-midi, web-midi-api, webmidi, webmidiapi
- Language: JavaScript
- Homepage:
- Size: 126 KB
- Stars: 17
- Watchers: 3
- Forks: 7
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Funding: .github/FUNDING.yml
- License: LICENSE.md
Awesome Lists containing this project
- awesome-javascript-audio - jazz-soft/JZZ-midi-Gear - get info about your MIDI device (Libraries: Web MIDI API / Web MIDI API)
- awesome-webaudio - JZZ-midi-Gear - Retrieve your MIDI device model and manufacturer. (Packages / MIDI)
README
# JZZ-midi-Gear
[](https://www.npmjs.com/package/jzz-midi-gear)
[](https://www.npmjs.com/package/jzz-midi-gear)
[](https://github.com/jazz-soft/JZZ-midi-Gear/actions)
[](https://coveralls.io/github/jazz-soft/JZZ-midi-Gear?branch=master)
## Retrieve your MIDI device model and manufacturer
See the [**online demo**](https://jazz-soft.github.io/modules/gear/index.html)
(requires a MIDI insrument connected to your computer).
## Install
`npm install jzz-midi-gear`
or `yarn add jzz-midi-gear`
or get the full development version and minified scripts from [**GitHub**](https://github.com/jazz-soft/JZZ-midi-Gear)
## Usage
##### Plain HTML
```html
//...
```
##### CDN (jsdelivr)
```html
//...
```
##### CDN (unpkg)
```html
//...
```
##### CommonJS
```js
var JZZ = require('jzz');
require('jzz-midi-gear')(JZZ);
//...
```
##### TypeScript / ES6
```ts
import { JZZ } from 'jzz';
import { Gear } from 'jzz-midi-gear';
Gear(JZZ);
//...
```
##### AMD
```js
require(['JZZ', 'JZZ.midi.Gear'], function(JZZ, gear) {
// ...
});
```
##### //...
```js
// start the MIDI engine:
JZZ({sysex:true}).and(function() {
var inputs = this.info().inputs;
var outputs = this.info().outputs;
// enable message handlers on all MIDI-In ports:
for (var i in inputs) this.openMidiIn(i).connect(function(msg) {
if (msg.isIdResponse()) {
var gear = msg.gearInfo();
console.log('ID Response SysEx received:');
console.log(' port: ' + this.name());
console.log(' message: ' + msg);
console.log(' brand: ' + gear.brand);
console.log(' model: ' + gear.model);
console.log(' device: ' + gear.descr);
}
});
// send the ID Request SysEx to all MIDI-Out ports:
for (var i in outputs) this.openMidiOut(i).sxIdRequest();
});
// ...
// in Node.js - don't forget to stop the engine when done:
JZZ().wait(500).close();
```
##### The expected output will look similar to the following:
```
ID Response SysEx received:
port: Roland RD
message: f0 7e 10 06 02 41 2b 02 00 00 00 01 00 00 f7
brand: Roland
model: RD-700GX
device: Digital Stage Piano
```
## Updates
If **JZZ.midi.Gear** cannot correctly identify your device, please help us fix the script:
### - tell us!
* Please post your device **model name**, **brief description**, **manufacturer**, and **ID Response SysEx message**
at the [**GitHub issues page**](https://github.com/jazz-soft/JZZ-midi-Gear/issues)
or,
### - do it yourself!
* Clone the project repository from [`https://github.com/jazz-soft/JZZ-midi-Gear.git`](https://github.com/jazz-soft/JZZ-midi-Gear)
* In the project root directory run `npm install`
* Update the `data/models.txt` and/or `data/vendors.txt`
* In the project root directory run `grunt`
* Commit to your branch
* Create a pull request
## Thanks for your support!
[](https://github.com/jazz-soft/JZZ-midi-Gear/stargazers)
[](https://github.com/jazz-soft/JZZ-midi-Gear/network/members)