Skip to main content

MIDI Objects for Python

Project description

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 msg in input:
...         print(msg)
>>> msg = mido.Message('program_change', program=10)
>>> msg.type
'program_change'
>>> msg.channel = 2
>>> msg2 = msg.copy(program=9)
<message program_change channel=2 program=9 time=0>

Full documentation at http://mido.readthedocs.org/

Main Features

  • 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.

  • 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.

Status

1.1 is the second stable release.

See CHANGELOG.rst for a full list of changes.

Requirements

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.

Alternative backends are included for python-rtmidi and Pygame. These can be selected with the environment variable MIDO_BACKEND or by calling mido.set_backend().

Like PortMidi, these are loaded on demand.

Installing

To install:

$ pip install mido

The PortMidi wrapper is written with ctypes, so no compilation is required.

If you want to use ports, you need the PortMidi shared library. The Ubuntu package is called libportmidi-dev, while the MacPorts and Homebrew packages are called portmidi.

Documentation

Documentation is available at http://mido.readthedocs.org/

Source code

Latest stable release: http://github.com/olemb/mido/

Development version: http://github.com/olemb/mido/tree/develop/

Known Bugs

  • 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...

    See https://bugs.launchpad.net/ubuntu/+source/portmidi/+bug/890600

    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.

License

Mido is released under the terms of the MIT license.

Source Code

Latest version of the code: http://github.com/olemb/mido/ .

Latest development version: http://github.com/olemb/mido/tree/develop/

Contact

Ole Martin Bjorndalen - ombdalen@gmail.com

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

mido-1.1.5.tar.gz (69.3 kB view details)

Uploaded Source

File details

Details for the file mido-1.1.5.tar.gz.

File metadata

  • Download URL: mido-1.1.5.tar.gz
  • Upload date:
  • Size: 69.3 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No

File hashes

Hashes for mido-1.1.5.tar.gz
Algorithm Hash digest
SHA256 98e02885c078a83d1c3f211cecef5561d7bcf4c0109e1e7019bd66217349de39
MD5 af47c2512963c31b6689ffedc24262a1
BLAKE2b-256 ae6ba24d266e679bbfc05687c7dd5174b8c4ce23da66124543f5fcf8ec6b7e96

See more details on using hashes here.

Supported by

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