Mido - MIDI Objects for Python

.. image:: https://github.com/mido/mido/workflows/Test/badge.svg :target: https://github.com/mido/mido/actions

Mido is a library for working with MIDI messages and ports:

.. code-block:: python

import mido msg = mido.Message('note_on', note=60) msg.type 'note_on' msg.note 60 msg.bytes() [144, 60, 64] msg.copy(channel=2) Message('note_on', channel=2, note=60, velocity=64, time=0)

.. code-block:: python

port = mido.open_output('Port Name') port.send(msg)

.. code-block:: python

with mido.open_input() as inport:
    for msg in inport:

.. code-block:: python

mid = mido.MidiFile('song.mid')
for msg in mid.play():

Full documentation at https://mido.readthedocs.io/

Main Features

  • works in Python 2 and 3.

  • convenient message objects.

  • supports RtMidi, PortMidi and Pygame. New backends are easy to write.

  • full support for all 18 messages defined by the MIDI standard.

  • standard port API allows all kinds of input and output ports to be used interchangeably. New port types can be written by subclassing and overriding a few methods.

  • includes a reusable MIDI stream parser.

  • full support for MIDI files (read, write, create and play) with complete access to every message in the file, including all common meta messages.

  • can read and write SYX files (binary and plain text).

  • implements (somewhat experimental) MIDI over TCP/IP with socket ports. This allows for example wireless MIDI between two computers.

  • includes programs for playing MIDI files, listing ports and serving and forwarding ports over a network.


1.2 is the third stable release.


Mido targets Python 3.6 and 2.7.



pip install mido

If you want to use ports::

pip install python-rtmidi

See docs/backends/ for other backends.

Source Code



Mido is released under the terms of the MIT license <http://en.wikipedia.org/wiki/MIT_License>_.

Questions and suggestions

For questions and proposals which may not fit into issues or pull requests, we recommend to ask and discuss on Discussions <https://github.com/mido/mido/discussions>_.


MIDI Objects for Python

Mido Info

⭐ Stars 924
🔗 Source Code github.com
🕒 Last Update 8 months ago
🕒 Created 9 years ago
🐞 Open Issues 123
➗ Star-Issue Ratio 8
😎 Author mido