❤
npm
Sign UpSign In

x-webmidi

0.9.0 • Public • Published

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

Dependencies (0)

    Dev Dependencies (0)

      Package Sidebar

      Install

      npm i x-webmidi

      Repository

      github.com/ryoyakawai/x-webmidi

      Homepage

      github.com/ryoyakawai/x-webmidi#readme

      Weekly Downloads

      1

      Version

      0.9.0

      License

      Apache-2.0

      Unpacked Size

      173 kB

      Total Files

      17

      Last publish

      Collaborators

      • ryoyakawai
      Try on RunKit
      Report malware