Skip to content

Download

Platforms

PythonMusic runs on Windows, Mac, and Linux.

Download and Install

To install PythonMusic, simply download PEM (Python Environment for Music) editor. (Latest v1.1 - August 19, 2026)

PEM Editor

PEM is bundled with all PythonMusic libraries, and other essential Python libraries. It should be enough for most uses.

NOTE: For more advanced users, see install PythonMusic via pip.

Windows

  1. Download PEM for Windows.
  2. Unzip the downloaded file.
  3. Double-click PEM.exe to run.
  4. (Optional) Right-click PEM.exe, and select "Create Shortcut". Move this shortcut to your Desktop for easy access.

Mac

  1. Download PEM for macOS.
  2. Double-click the downloaded file to extract PEM.
  3. Move PEM to your Applications folder.
  4. Double-click PEM to run.
  5. (Optional) While PEM is running, control-click the PEM icon on the taskbar. Select “Options” and “Keep in Dock” for easy access.

Mac Security Issue

Some versions of macOS flag the PEM application as damaged (or malware). This is a common issue caused by Apple's strict security protocols, and does not mean the application is unsafe. If so:

  1. Select “Cancel” (not "Move to Trash"!).
  2. Open System Settings.
  3. In “Privacy & Security”, scroll down to see a Security alert for PEM.
  4. Select “Allow”, and open PEM again.

Alternatively - after you move PEM to the Applications folder:

  1. Open a Terminal window.
  2. Type this command: 
sudo xattr -dr com.apple.quarantine /Applications/PEM.app/

Linux (and Intel Mac)

The PEM executable is not available for Linux and Intel-based Macs.

To install PythonMusic see install via pip.

Previous Versions

Need an older release? All previous versions of PEM and PythonMusic are available on the PythonMusic releases page on GitHub.

Download the Examples

PythonMusic comes with online examples. You can also download them.

Install via pip (Advanced)

For more advanced users, install PythonMusic via pip. This lets you use PythonMusic alongside the full Python ecosystem of libraries:

  1. Make sure you have Python3 installed (version 3.12 preferred).
  2. Open Terminal, and type: 
pip install PythonMusic

If this fails, see Troubleshooting Pip.

Other Python Versions

PythonMusic works on Python 3.12 and later, but Python 3.12 is the smoothest install. A few of PythonMusic's dependencies don't yet offer ready-made versions for Python 3.13 and 3.14, so on those versions pip has to build them on your computer — which needs the extra tools described under Troubleshooting Pip. If you'd rather not set those up, install Python 3.12.

PEM with pip

Once PythonMusic is installed with pip, you can access PEM via the command line: 

python -m pem
or simply: 

pem

You can also open a file with PEM:

python -m pem <filename.py>

or

pem <filename.py>

Test your Installation

To verify that your environment is set up correctly, run the following "Hello, World!" program:

playNote.py
1
2
3
4
5
6
7
# playNote.py
# Demonstrates how to play a single note.

from music import *        # import music library

note = Note(C4, HN)        # create a middle C half note
Play.midi(note)            # and play it!

You can run this in one of two ways:

  • Using PEM: Copy and paste the code above directly into the PEM editor, and click "Run".

  • Using the command line: Save the code in a file named playNote.py, and run it from your terminal (notice the "-i", which stands for interactive mode):

python -i playNote.py

NOTE: The first time you import music and run a program, PythonMusic will ask to download a high-quality soundfont (FluidR3 G2-2.sf2) for you. This is necessary to play high-quality MIDI sounds, and only needs to happen once.

If you hear this note playing, everything is perfect!