REMI-z 0.5.4

Manipulate your MIDI file in bar level, and converting between MIDI and REMI-z format.

This is the official implementation of the REMI-z tokenizer in the paper Unlocking Potential in Pre-Trained Music Language Models for Versatile Multi-Track Music Arrangement.

This tool helps to convert your music between MIDI and REMI-z representation, meanwhile facilitate manipulate the music at bar level.

The core of this tokenizer is the MultiTrack class as the data structure for multitrack music, which is a hierachical format. Here are the structural details:

• The music is represented by an MultiTrack object, which is list of bars.
  • Each Bar object represents all notes being played within one bar, grouped by Track object, together with time signature and tempo info of this bar.
    • Each Track object represents one instrument, contatining notes of that instrument in this bar.
      • Each Note object represent one note, including onset, offset, pitch, velocity information.

This Multitrack object can be create from various formats (supporting MIDI for now), and convert into various formats (e.g., MIDI, and REMI-z representation).