Skip to content

Quickstart guide to MPF

This is for people who know what they're doing. If you're lost, check out our full installation guides.

  1. MPF requires Python 3.7 - 3.9. Newer than 3.9 won't work. (Update: MPF 0.57 supports Python 3.10 & 3.11. See our 0.57 page for details.)

  2. pip install mpf

  3. pip install mpf-monitor

  4. Create a folder for your machine config files as outlined in the tutorial.

We do not recommend installing the Media Controller right away since it's more of a pain to get installed, and you don't need it yet.


Something missing or wrong? You can fix it!

This website is edited by people like you! Is something wrong or missing? Is something out of date, or can you explain it better?

Please help us! You can fix it yourself and be an official "open source" contributor!

It's easy! See our Beginner's guide to editing the docs.

Page navigation via the keyboard: < >

You can navigate this site via the keyboard. There are two modes:

General navigation, when search is not focused:

  • F , S , / : open search dialog
  • P , , : go to previous page
  • N , . : go to next page

While using the search function:

  • Down , Up : select next / previous result
  • Esc , Tab : close search
  • Enter : go to highlighted page in the results