MIDI Objects for Python
Mido is a library for working with MIDI messages and ports. It’s designed to be as straight forward and Pythonic as possible:
>>> import mido >>> output = mido.open_output() >>> output.send(mido.Message('note_on', note=60, velocity=64))
>>> with input as mido.open_input('SH-201'): ... for message in input: ... print(message)
>>> message = mido.Message('program_change', program=10) >>> message.type 'program_change' >>> message.channel = 2 >>> message.copy(program=9) <message program_change channel=2 program=9 time=0>
>>> from mido import MidiFile >>> for message in MidiFile('song.mid').play(): ... output.send(message)
Full documentation at http://mido.readthedocs.org/
- works in Python 2 and 3.
- convenient message objects.
- supports PortMidi, RtMidi 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 interchangingly. New port types can be written by subclassing and overriding a few methods.
- includes a reusable MIDI 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.1 is the second stable release.
See CHANGELOG.rst for a full list of changes.
Mido targets Python 2.7 and 3.2.
If you want to use message ports, you will need PortMidi installed on your system. The PortMidi library is loaded on demand, so you can use the parser and messages without it.
The PortMidi wrapper is tested on on Ubuntu and Mac OS X, but may also run on other systems where the portmidi.so/dll file is available.
Like PortMidi, these are loaded on demand.
$ pip install mido
The PortMidi wrapper is written with ctypes, so no compilation is required.
To build documentation locally:
python setup.py docs
This requires Sphinx. The resulting files can be found in docs/_build/.
in OS X, PortMidi and RtMidi usually hang for a second or two seconds while initializing. This is actually not a Mido bug, but something that happens at a lower level.
PortMidi in Ubuntu is mistakenly compiled in debug mode, which causes it to print out error message instead of returning an error code:
PortMidi: `Bad pointer' type ENTER...PortMidi call failed...
This means here is no way for Mido to catch the error and raise an exception.
This regularity occurs in two places: in PortMidi when you close a port that has a callback, and in pygame when you close any port.
Latest version of the code: http://github.com/olemb/mido/ .
Latest development version: http://github.com/olemb/mido/tree/develop/
Mido is released under the terms of the MIT license.
Ole Martin Bjorndalen - firstname.lastname@example.org
Release history Release notifications
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
|Filename, size & hash SHA256 hash help||File type||Python version||Upload date|
|mido-1.1.7-py2.py3-none-any.whl (47.0 kB) Copy SHA256 hash SHA256||Wheel||2.7||Aug 12, 2014|
|mido-1.1.7.tar.gz (72.6 kB) Copy SHA256 hash SHA256||Source||None||Aug 12, 2014|