/XPianoRoll

a piano roll for max msp

Primary LanguageMaxMIT LicenseMIT

Midi Editor/Piano Roll for Max Msp

XPianoRoll is a pure midi-editor and written as the gui part of a sequencer. A sequencer is not part of XPianoRoll and the communication between a sequencer and XPianoRoll has to be created on your own.

Installation

download dependencies and third-party utility

  • XPianoRoll uses nw.js for the editor. It's preferable to use the sdk version to see the commands exchanged between max and nw. Console can be opened by F12. nw.js can be downloaded from here: https://nwjs.io/

  • To open nwjs the [shell] object is needed: https://github.com/jeremybernstein/shell/releases/tag/1.0b3

  • For the tcp connection the saddam library is needed. Install it inside of Max.

Download the XPianoRoll folder to your Max library folder.

Open xpianoroll.maxpat and adjust the path to nw.js inside [p open_gui]

Tested with Max 8.2.0 on win10.

Shortcuts and Controls

For a description and a list of available shortcuts click on the faces in the upper left corner of the editor.

  • ITEMS
    • created and deleted by clicking and drawing
    • can be moved and resized by dragging
  • SELECTIONS
    • selections of a row or by dragging
    • selections can be extended or deleted
    • selections can be moved on x an y-axis
  • SNAPSHOTS
    • up to 10 snapshots can be taken and recalled
  • TRANSPORT
    • possibility of defining an inner loop region
  • PARAMETERS
    • custom parameters with custom settings (start, scope, step)
  • SOLO/MUTE
    • usefull for replay and editing
  • MIDI
    • imports midi files of type 1

alt tag alt tag alt tag

The code of the midi import filter was taken from:

https://github.com/gasman/jasmid and https://github.com/NHQ/midi-file-parser

Thanks to the authors!