PYMIDI Framework (Version 1.1)

The PYMIDI Framework makes it very easy to do all the things that a MIDI application commonly wants to do:

• let the user select MIDI sources and destinations
• handle the addition and removal of MIDI devices on the fly
• save references to MIDI sources and destinations in files
• send and receive MIDI data

It also provides a nice Objective-C interface to a lot of Apple's CoreMIDI functionality, while still allowing you to get at the underlying CoreMIDI objects to do more advanced things.

License

This software is distributed under the terms of Pete's Public License. It's free (as in beer) but the license sets out a few restrictions on its distribution and modification.

If you want to use this library in a project that you then distribute you have to ask me first. If you're a freeware or small shareware author I'll more than likely say yes straight off. If you want to use it as part of a commercial app then we may have to negotiate a small fee.

If you use it I only ask for one thing: send me an e-mail. Tell me what you use it for, anything you like and don't like, anything you'd like to see in future versions, etc.

For other ways to reward me for producing this, see my web site.

Requirements

To build applications that use the PYMIDI Framework you will need:

• Mac OS X 10.3
• Xcode

There's no reason you shouldn't be able to build projects just as well using Mac OS X 10.2 and Project Builder, but I haven't tested it recently.

Using the Framework

The framework has been built to be embedded within your application. If you've never done this before, here are the basic steps:

• copy the framework into your Xcode project's folder
• drag the framework from the Finder into the “Linked Frameworks” group in the your project's “Groups & Files” pane
• select your target from the “Targets” section of the “Groups & Files" pane
• choose “New Copy Files Build Phase” from the “New Build Phase" sub-menu of the "Project" menu
• choose “Frameworks” from the “Destination:” popup menu in the “Copy Files Info” window
• in the “Groups & Files” pane, drag PYMIDI.framework from the “Linked Frameworks” group onto the new build phase inside your target

You'll also need to link against Apple's CoreMIDI framework by choosing “Add Frameworks…” from the “Project” menu and adding the CoreMIDI.framework to your application.

Full documentation for the framework APIs can be found in the Documentation folder.

Credits

The software was designed and written by Pete Yandell.