MusicXML Player
A TypeScript component that loads and plays MusicXML files in the browser using Web Audio and Web MIDI.
Getting started
npm install
npm run build
npm test
Running the demo
This is a demo showcasing MusicXML rendering, MIDI conversion, Web Audio and Web MIDI playback. It is an enhanced replica of the earlier demo where the above functionality was hard-coded into the HTML app. By contrast, in this demo, the playback and rendering functionalities are all encapsulated in the present module, with only the demo UI coded in demo.mjs
.
- Start this demo
npm run demo
- Open http://127.0.0.1:8080/
Theory of operation
This component synchronizes rendering and playback of MusicXML documents. Rendering is done using existing Web-based music engraving libraries such as OpenSheetMusicDisplay or Verovio. Playback uses standard MIDI files that are expected to correspond to the given MusicXML, and sends the MIDI events to either a Web MIDI output, or to a Web Audio synthesizer.
The crucial part of this functionality is to synchronize the measures and beats in the MusicXML file with the events of the MIDI file. In a nutshell, the player expects the provider of the MIDI file (an implementation of IMidiConverter
) to supply a "timemap", which associates each measure in the MusicXML file to a timestamp at which this measure occurs. In the case of repeats and jumps, the same measure will be referenced several times in the timemap.
To produce such MIDI files and timemaps from a MusicXML score, the player utilizes the companion tool musicxml-mma
. The demo above automatically installs and runs musicxml-mma
in the background.