Skip to content
This repository has been archived by the owner on Mar 14, 2021. It is now read-only.

newlandsvalley/elm-comidi

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

74 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

elm-comidi

Build Status

This is a parser for MIDI written in pure Elm 0.18 and using the elm-combine parser combinator library.

Unfortunately, Elm has very poor support for binary data. As from Elm 0.18, you can no longer load MIDI via http - instead you must rely on ports. The native javascript must use the readAsBinaryString function to access the MIDI recording which is then loaded into an Elm String. elm-comidi's normalise function is used to make sense of this String.

To parse a MIDI string that represents a MIDI file you can use:

midiFileData
  |> Midi.Parse.normalise
  |> Midi.Parse.file

This attempts to parse the contents and also translates running status messages to the appropriate underlying channel message (note on, note off, aftertouch etc.).

On the other hand, you may merely need to parse MIDI events (such as note on or note off) that come from a Web MIDI connection. In other words, you are connecting directly to a MIDI device through the browser and need to parse the stream of event messages as the instrument is played. To do this, use:

midiEventData
  |> Midi.Parse.event

This will attempt to parse an individual event. Note that Web MIDI does not generate running status messages and this method will not attempt to parse them.

The parser is intended to be a fully conformant with the MIDI standard and accepts Type-0, Type-1 and Type-2 files.

Dependencies

  • Bogdanp/elm-combine 3.1.1
  • elm-lang/core 5.0.0