JZZ-midi-Gear

Retrieve your MIDI device model and manufacturer

See the online demo (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

Usage

Plain HTML

1<script src="JZZ.js"></script>
2<script src="JZZ.midi.Gear.js"></script>
3//...

CDN (jsdelivr)

1<script src="https://cdn.jsdelivr.net/npm/jzz"></script>
2<script src="https://cdn.jsdelivr.net/npm/jzz-midi-gear"></script>
3//...

CDN (unpkg)

1<script src="https://unpkg.com/jzz"></script>
2<script src="https://unpkg.com/jzz-midi-gear"></script>
3//...

CommonJS

1var JZZ = require('jzz');
2require('jzz-midi-gear')(JZZ);
3//...

TypeScript / ES6

1import { JZZ } from 'jzz';
2import { Gear } from 'jzz-midi-gear';
3Gear(JZZ);
4//...

AMD

1require(['JZZ', 'JZZ.midi.Gear'], function(JZZ, gear) {
2  // ...
3});

//...

1// start the MIDI engine:
2JZZ({sysex:true}).and(function() {
3  var inputs = this.info().inputs;
4  var outputs = this.info().outputs;
5  // enable message handlers on all MIDI-In ports:
6  for (var i in inputs) this.openMidiIn(i).connect(function(msg) {
7    if (msg.isIdResponse()) {
8      var gear = msg.gearInfo();
9      console.log('ID Response SysEx received:');
10      console.log('   port:    ' + this.name());
11      console.log('   message: ' + msg);
12      console.log('   brand:   ' + gear.brand);
13      console.log('   model:   ' + gear.model);
14      console.log('   device:  ' + gear.descr);
15    }
16  });
17  // send the ID Request SysEx to all MIDI-Out ports:
18  for (var i in outputs) this.openMidiOut(i).sxIdRequest();
19});
20// ...
21// in Node.js - don't forget to stop the engine when done:
22JZZ().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

or,

- do it yourself!

• Clone the project repository from https://github.com/jazz-soft/JZZ-midi-Gear.git
• 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!