Skip to main content

A python package for working with MIDI data files.

Project description


A Python package for working with MIDI files.

PyPI version Python 3.7 GitHub CI GitHub license Downloads Code style

Miditoolkit works by loading/writing MIDIs with mido in a user-friendly way. It is inspired from pretty_midi, with similar usage and core features, but handles the MIDI events in native ticks time unit instead of seconds. It also comes with a few optimizations and speed-ups, and can parse MIDI tracks into piano-rolls for computation or visualization purposes. If you are working with seconds time units (for e.g. music transcription), you'll be likely better with pretty_midi. Otherwise, if you are working solely on MIDI and symbolic music, miditoolkit should provide slightly faster performances.

Main Features

  • MIDI
    • Global
      • ticks per beat
      • tempo changes
      • key signatures
      • time signatures
      • lyrics
      • markers
    • Instruments
      • control changes
      • pitch bend
    • Editing
      • chunk/cropping
    • IO
      • BytesIO
  • Piano-rolls
    • Tools
      • notes to piano-rolls
      • piano-rolls to notes
      • chromagram
    • Visualization
  • External Library


  • better documentation;
  • finish the code cleaning of the pianoroll methods (vis);
  • a way to switch the time in seconds across the whole MidiFile object;
  • cropping Control Changes and bars;
  • symbolic features
  • new structural analysis


You can install miditoolkit via PYPI:

pip install miditoolkit

... or directly from git if you want to get the latest features or fixes (only recommended if you need it):

pip install git+

Example Usage

from miditoolkit import MidiFile
from miditoolkit.midi.utils import example_midi_file

path_midi = example_midi_file()
midi_obj = MidiFile(path_midi)



ticks per beat: 480
max tick: 72002
tempo changes: 68
time sig: 2
key sig: 0
markers: 71
lyrics: False
instruments: 2

A. Parse and create MIDI files B. Piano-roll Manipulation


  • mido processes MIDI files in the lower level such as messages and ports, and is the backend pretty_midi and miditoolkit;
  • pretty_midi parses MIDI files and pianorolls in seconds time unit, plus has audio related features;
  • pypianoroll parses MIDI files into pianorolls in ticks time unit.

Miditoolkit is designed for handling MIDI in ticks, the native time unit of the MIDI protocol. We keep the midi parser as simple as possible, and offer several important functions to complete the versatility. For example, piano-rolls, tick-to-second, chromagram, etc.

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

miditoolkit-1.0.1.tar.gz (22.4 kB view hashes)

Uploaded Source

Built Distribution

miditoolkit-1.0.1-py3-none-any.whl (24.5 kB view hashes)

Uploaded Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page