Skip to main content

Play music notes in your Python scripts with ease.

Project description


Play music notes in your Python scripts with ease.


Install with pip:

pip install musicnotes

You can also install manually from the GitHub repository linked here.


Anyone wishing to contribute to this project can focus on the following issues.


We need to add more instruments, and more keys to the piano as well. This would be a good first PR for anyone willing to contribute to this project.

Asynchronous Audio

The current solution I've developed for playing the notes has trouble playing them more smoothly, and anyone who tests this software will notice how the notes sound when trying to play a song.

Sound Quality

Anyone with access to higher quality sounds for notes can contribute to this project by adding these sounds. Please be sure that these sounds do not violate anyone else's copyright.


If you find a bug while using this software, feel free to create an issue on this repository. More on how to create an issue here.


Currently, this project only supports a limited number of piano keys. This project is open-source, so anyone who wants to add more instruments, more keys, or higher quality audio can make a pull request and do so. You can learn more about pull requests here.

This module contains one function, "note". This function contains several arguments in order to clearly define the sound of the note.

note(note, pitch, sharp, flat, instrument)


note: Takes in a letter, from A-G, and plays the corresponding note.

pitch: Currently, three 'pitches' are supported. low, mid, and high. This is due to the fact that the only instrument supported is a 36-key piano. Set to mid by default.

sharp: Set to False by default. Set to True if you want to sharp the note.

flat: Set to False by default. Set to True if you want to flat the note.

instrument: Set to piano by default. Currently only supports piano, with plans to add more instruments in the future.


This portion of the project is heavily inspired by Taylor S. Marks' project, playsound.

The main thing any contributors need to focus on is the block argument in soundPlayer. This is set to true by default. However, setting this to False will allow sounds to run asynchronously. This will be something that needs to be updated later on, as currently, the notes play very separately, and make it difficult to play smooth-flowing music.

You can also contribute by updating soundPlayer, possibly making it better for our use case.


This software is Copyright (c) 2024 Mustaeen Ahmed

See LICENSE for more information.

Project details

Download files

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

Source Distribution

musicnotes-1.1.tar.gz (2.4 MB view hashes)

Uploaded Source

Built Distribution

musicnotes-1.1-py3-none-any.whl (2.4 MB view hashes)

Uploaded Python 3

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