MIDI via WebSockets for browser and Node.js

Usage

Plain HTML

<scriptsrc="JZZ.js"></script><scriptsrc="JZZ.midi.WS.js"></script>//...

CDN (jsdelivr)

<scriptsrc="https://cdn.jsdelivr.net/npm/jzz"></script><scriptsrc="https://cdn.jsdelivr.net/npm/jzz-midi-ws"></script>//...

CDN (unpkg)

<scriptsrc="https://unpkg.com/jzz"></script><scriptsrc="https://unpkg.com/jzz-midi-ws"></script>//...

CommonJS

varJZZ=require('jzz');require('jzz-midi-ws')(JZZ);//...

Client

(Browser or Node.js)

JZZ.WS.connect('ws://localhost:8888');// not necessarily local :)// ...varport=JZZ().openMidiOut('ws://localhost:8888 - Microsoft GS Wavetable Synth');// ...port.noteOn(0,'C5',127);

Client API

varconnection=JZZ.WS.connect(url,timeout);

connection.close();

Asynchronous calls

functiongood(){console.log('Connected!');}functionbad(){console.log('Cannot connect!');}varurl='ws://localhost:8888';varconnection;// method 1 (and/or):connection=JZZ.WS.connect(url).and(good).or(bad);// method 2 (then):connection=JZZ.WS.connect(url).then(good,bad);// method 3 (within an async function):connection=awaitJZZ.WS.connect(url);

Server

(Node.js only)

constws=require('ws');constJZZ=require('jzz');require('jzz-midi-ws')(JZZ);// start a WebSocket server (see more ways of doing that at https://github.com/websockets/ws)constwss=newws.Server({port:8888});// start a MIDI via WebSockets serverconstserver=newJZZ.WS.Server(wss);// add actual MIDI portsJZZ().and(function(){varinfo=JZZ().info();for(varpofinfo.inputs)server.addMidiIn(p.id,JZZ().openMidiIn(p.id));for(varpofinfo.outputs)server.addMidiOut(p.id,JZZ().openMidiOut(p.id));});// and/or virtual portsserver.addMidiIn('Dummy',JZZ.Widget());server.addMidiOut('Debug',JZZ.Widget({_receive:function(msg){console.log(msg.toString());}}));

Server API

varserver=newJZZ.WS.Server(wss);

server.addMidiIn(name,port);server.addMidiOut(name,port);

server.removeMidiIn(name);server.removeMidiOut(name);

See also