Racket MIDI reader

8.12

Racket MIDI reader🔗ℹ

John Clements <clements@racket-lang.org>

This package can read and parse MIDI files written in the "Standard MIDI File" format, also known as "SMF", and usually appearing in files ending with ".mid".

The output of this parser is currently ad-hoc but non-ambiguous; the best way to understand it is to read the source in "midi-structs.rkt"

procedure
(midi-file-parse path) → MIDIFile?
path : path-string?

Given a path, parse the file as a standard MIDI file.

procedure
(midi-port-parse port) → MIDIFile?
port : port?

Given a port searchable with file-position, parse the content as a standard MIDI file.

I bet there’s a nice way to format this....

struct
(struct MIDIFile (format division tracks)
    #:extra-constructor-name make-MIDIFile)
  format : MIDIFormat
  division : MIDIDivision
  tracks : (listof MIDITrack)

Represents a MIDI file.

Too lazy to format the rest of these right now....

(define-type MIDIFormat (U 'multi 'single 'sequential))

(define-type MIDIDivision (U TicksPerQuarter SMPTE))

(define-struct: TicksPerQuarter ([ticks : Clocks]) #:transparent)

(define-struct: SMPTE ([a : Natural] [b : Natural]) #:transparent)

;; hidden invariant: the events in the track must have increasing times

(define-type MIDITrack (Listof MIDIEvent))

;; Clocks absolute, relative to start of track.

(define-type MIDIEvent (List Clocks MIDIMessage))

(define-type Clocks Natural)

(define-type MIDIMessage (U MetaMessage ChannelMessage SysexMessage))

(define-struct: MetaMessage ([content : Any]) #:transparent)

(define-struct: SysexMessage ([content : Any]) #:transparent)

(define-struct: ChannelMessage ([kind : MIDIKind]

[channel : Byte]

[operands : (List Byte (U Byte False))])

#:transparent)

(define-type MIDIKind Symbol)

procedure
(MIDIFile->notelist file
#:careful? careful?) → (listof note?)
file : MIDIFile?
careful? : #f

Returns a list of the notes occurring in the file. This is principally useful for a "getting started quickly" application that wants to ignore all of the performance, tempo, channel, and other information in the MIDI file and just get a list of all the notes in the file.

The "careful?" flag will cause this function to signal errors when an already-playing note is started again, or when a not-currently-playing note is stopped.

This function has been tested on only two midi files. Let me know if you have trouble with it.

struct
(struct note (pitch time duration)
    #:extra-constructor-name make-note)
  pitch : midi-note-num?
  time : tick?
  duration : tick?

Represents a note, for the purposes of MIDIFile->notelist