Skip to main content

The Mission Pinball Framework

Project description

Mission Pinball Framework (MPF)

...Let's build a pinball machine!

What is Mission Pinball Framework?

Mission Pinball Framework (MPF) is an open source, cross-platform software for powering real pinball machines in restaurants, bars, arcades, and elsewhere. MPF is a community-developed project released under the MIT license. It's supported by volunteers in their spare time. Individual pinball hardware makers are responsible for their own platform interface maintenance and contributions.

Coverage Status Test Status CII Best Practices

Technology and Compatibility

You can use MPF as the software to run a custom-built machine, or (with appropriate interface hardware) existing Williams, Bally, Stern, or Data East pinball machines. MPF interfaces with machines via modern pinball controller hardware, including:

  • FAST Pinball controllers
  • CobraPin
  • Stern SPIKE / SPIKE 2
  • Multimorphic P-ROC or P3-ROC
  • Open Pinball Project (OPP) open source hardware
  • LISY Platform
  • Penny K Arcade PKONE
  • Arduino Pinball Controller
  • Plus many more systems & devices!

MPF is written in Python. It can be run on Windows, Mac, Linux, and Raspberry Pi host machines using the same code and configurations.

Visit the MPF project homepage at Additional related projects exist as part of the MPF ecosystem, including the "MPF Monitor" which is a graphical application that lets you simulate pinball hardware, and "MPF-MC" which is a media controller which provides graphics and sounds for pinball machines.



MPF is open source and has no official support. Some MPF users follow the MPF-users Google group:!forum/mpf-users. Individual hardware providers may provide additional support for users of their hardware.


MPF is a passion project created and maintained by volunteers. If you're a Python coder, documentation writer, or pinball maker, feel free to make a change and submit a pull request. For more information about contributing see the Contributing Code and Contributing Documentation pages.


MPF and related projects are released under the MIT License. Refer to the LICENSE file for details. Docs are released under Creative Commons CC BY 4.0.

Project details

Release history Release notifications | RSS feed

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

mpf-0.56.0.tar.gz (2.1 MB view hashes)

Uploaded source

Built Distribution

mpf-0.56.0-py3-none-any.whl (1.5 MB view hashes)

Uploaded py3

Supported by

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