Skip to content
Web MIDI API Wrapper with Web Components (polymer)
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
extras
.gitignore
LICENSE
README.md
index.html
xwebmidi.css
xwebmidi.js

README.md

x-webmidi

Live Demo

http://ryoyakawai.github.io/x-webmidi/

What is this?

This is a polymer component, and this is a wrapping Web MIDI API.

Purpose of using this component

MIDI is well defined protocol. But to use the protocol you must learn 7bit code, such as NoteOn: 9nH, NoteOff: 8nH. With using this component you do NOT have to learn those 7bit code. And also, you do NOT have to know about method in Web MIDI API. What you need to understand to use this component are HTML and a few JavaScript, which is eventlistener. Using this component allow you a quick and an easy MIDI application development.

Supported to send MIDI Message (as is 2014 Dec. 12)

  • NoteOn
  • NoteOff
  • Program Change
  • PitchBend
  • Sustain
  • Modulation
  • AllSoundOff
  • ResetAllController
  • AllNoteOff

Requirements (as is 2014 Dec 15)

Google Chrome to use this component.

Preparation

Get component

Clone this repository

$ git clone https://github.com/ryoyakawai/x-webmidi.git;

How to use xwebmidi.js

  • import xwebmidi.js
  • create an instance of xwebmidi.js
  • create div element and tell xwebmidi.js that where to add pull down menu input/output device to provide.
  • add eventlistener to handle for MIDI input, and send MIDI message against MIDI OUTPUT

include and import

<html>
  <head>
    <link rel="stylesheet" href="./xwebmidi.css">
  </head>
  <body>
    INPUT:
    <select id="midiin" class="xwebmidi-select-midi">
      <option value="false">Not Selected</option>
    </select>
    <br>
    OUTPUT:
    <select id="midiout" class="xwebmidi-select-midi">
      <option value="false">Not Selected</option>
    </select>

    <script type="module">
     import { xWebMIDI } from "./xwebmidi.js";
     (async () => {
       const xwm = new xWebMIDI();
       await xwm.requestMIDIAccess(true);
       xwm.initInput('midiin');
       xwm.initOutput('midiout');

       window.addEventListener('midiin-event:midiin', event => {
         console.log(event.detail.data);
         xwm.sendRawMessage(event.detail.data)
       });
     })();
    </script>
  </body>
</html>

Note: Second parameter of initInput()/initOutput() is NOT REQURED parameter. And the parameter for to specifying the class where to update when MIDI message is incoming/outgoing.

MIDI input

Basic Demo

MIDI output

Basic Demo

License

Apache License, Version 2.0

Copyright

Copyright (c) 2014 Ryoya Kawai

You can’t perform that action at this time.