pluginbuilder / doc / index.rst

Full commit

pluginbuilder - Create standalone Mac OS X plugins with Python

pluginbuilder is a Python package which will allow you to make standalone plugins from Python scripts.This plugin can then be used by an Objective-C application (through NSBundle). pluginbuilder is a fork of py2app, but without the distutils based command or the ability to create application bundles.

Why forking py2app just to remove stuff from it? Because the resulting code is much simpler (distutils sucks), which makes it much easier to maintain. The release of Python 3.2 broke py2app and being, I think, the only user of its "plugin" feature, I had to fix it myself and was thus exposed to the messiness of the code. I had to do something about it.

The logical name for such a fork of py2app would have been py2plugin, but a project named "pyplugin" already exists, hence this name.

Online Resources

Source code repository:
PyPI Entry:
Issue tracker:
Online Documentation (this doc):

If you're looking for help, pay special attention to the examples folder in the source, which demonstrates some (one in fact...) common use cases.


pluginbuilder may be distributed under the MIT or PSF open source licenses.

Copyright (c) 2004-2006 Bob Ippolito <bob at>.

Copyright (c) 2010 Ronald Oussoren <ronaldoussoren at>.

Copyright (c) 2011 Virgil Dupras <hsoft at>.