# musicnotes
*Play music notes in your Python scripts with ease.*
# Installation
Install with pip:
```
pip install musicnotes
```
You can also install manually from the GitHub repository linked [here](https://github.com/must108/musicnotes).
# Issues
Anyone wishing to contribute to this project can focus on the following issues.
### Instruments
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.
### General
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](https://docs.github.com/en/issues/tracking-your-work-with-issues/about-issues).
# Documentation
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](https://docs.github.com/en/pull-requests/collaborating-with-pull-requests/proposing-changes-to-your-work-with-pull-requests/about-pull-requests).
This module contains one function, "note". This function contains several arguments in order to clearly define the sound of the note.
```python
note(note, pitch, sharp, flat, instrument)
```
## Arguments:
`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.
## soundPlayer
This portion of the project is heavily inspired by Taylor S. Marks' project, [playsound](https://github.com/TaylorSMarks/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.
# Copyright
This software is Copyright (c) 2024 Mustaeen Ahmed
See LICENSE for more information.
Raw data
{
"_id": null,
"home_page": "https://github.com/must108/musicnotes",
"name": "musicnotes",
"maintainer": null,
"docs_url": null,
"requires_python": null,
"maintainer_email": null,
"keywords": "sound, music, mp3, wave, wav, media, song, play, audio, notes, music notes, melody",
"author": "Mustaeen Ahmed",
"author_email": "contact@mustaeen.dev",
"download_url": "https://files.pythonhosted.org/packages/6e/9b/b1ae8ab5283bee40bb972f69a3fdd1da00d1b481137c56bca9bf2415441d/musicnotes-1.1.tar.gz",
"platform": null,
"description": "# musicnotes\r\n\r\n*Play music notes in your Python scripts with ease.*\r\n\r\n# Installation\r\n\r\nInstall with pip:\r\n\r\n```\r\npip install musicnotes\r\n```\r\n\r\nYou can also install manually from the GitHub repository linked [here](https://github.com/must108/musicnotes).\r\n\r\n# Issues\r\n\r\nAnyone wishing to contribute to this project can focus on the following issues.\r\n\r\n### Instruments\r\nWe 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.\r\n\r\n### Asynchronous Audio\r\nThe 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. \r\n\r\n### Sound Quality\r\nAnyone 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.\r\n\r\n### General\r\nIf 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](https://docs.github.com/en/issues/tracking-your-work-with-issues/about-issues).\r\n\r\n# Documentation\r\n\r\nCurrently, 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](https://docs.github.com/en/pull-requests/collaborating-with-pull-requests/proposing-changes-to-your-work-with-pull-requests/about-pull-requests).\r\n\r\nThis module contains one function, \"note\". This function contains several arguments in order to clearly define the sound of the note. \r\n\r\n```python\r\nnote(note, pitch, sharp, flat, instrument)\r\n```\r\n\r\n## Arguments:\r\n\r\n`note`: Takes in a letter, from A-G, and plays the corresponding note.\r\n\r\n`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.\r\n\r\n`sharp`: Set to `False` by default. Set to `True` if you want to sharp the note.\r\n\r\n`flat`: Set to `False` by default. Set to `True` if you want to flat the note.\r\n\r\n`instrument`: Set to `piano` by default. Currently only supports `piano`, with plans to add more instruments in the future.\r\n\r\n\r\n## soundPlayer\r\n\r\nThis portion of the project is heavily inspired by Taylor S. Marks' project, [playsound](https://github.com/TaylorSMarks/playsound). \r\n\r\nThe 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.\r\n\r\nYou can also contribute by updating `soundPlayer`, possibly making it better for our use case. \r\n\r\n# Copyright\r\n\r\nThis software is Copyright (c) 2024 Mustaeen Ahmed \r\n\r\nSee LICENSE for more information.\r\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "Play music notes in your Python scripts with ease.",
"version": "1.1",
"project_urls": {
"Homepage": "https://github.com/must108/musicnotes"
},
"split_keywords": [
"sound",
" music",
" mp3",
" wave",
" wav",
" media",
" song",
" play",
" audio",
" notes",
" music notes",
" melody"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "07cbe4c0b35e4bcb9054d3c0f4cff34435463d43fde92eb0f7bd465259d6a64e",
"md5": "a36fa100aa3d091b2916b83603d7de8b",
"sha256": "dad2f6ac957f7ce5f9c900e39535443dbc277fe906039be2f3ce557f05e2e7c3"
},
"downloads": -1,
"filename": "musicnotes-1.1-py3-none-any.whl",
"has_sig": false,
"md5_digest": "a36fa100aa3d091b2916b83603d7de8b",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": null,
"size": 2377739,
"upload_time": "2024-05-03T02:46:38",
"upload_time_iso_8601": "2024-05-03T02:46:38.973731Z",
"url": "https://files.pythonhosted.org/packages/07/cb/e4c0b35e4bcb9054d3c0f4cff34435463d43fde92eb0f7bd465259d6a64e/musicnotes-1.1-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "6e9bb1ae8ab5283bee40bb972f69a3fdd1da00d1b481137c56bca9bf2415441d",
"md5": "642f59971da7d4e5ceb0c954cec51408",
"sha256": "3375ecb16b08a91b5fefc856ca041adc8abf3b2c04457f2ee2e6c4f80788d0cc"
},
"downloads": -1,
"filename": "musicnotes-1.1.tar.gz",
"has_sig": false,
"md5_digest": "642f59971da7d4e5ceb0c954cec51408",
"packagetype": "sdist",
"python_version": "source",
"requires_python": null,
"size": 2372111,
"upload_time": "2024-05-03T02:46:42",
"upload_time_iso_8601": "2024-05-03T02:46:42.073011Z",
"url": "https://files.pythonhosted.org/packages/6e/9b/b1ae8ab5283bee40bb972f69a3fdd1da00d1b481137c56bca9bf2415441d/musicnotes-1.1.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-05-03 02:46:42",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "must108",
"github_project": "musicnotes",
"travis_ci": false,
"coveralls": false,
"github_actions": false,
"lcname": "musicnotes"
}
JSON
