| Name | pozalabs-miditoolkit JSON |
| Version |
1.1.3
JSON |
| download |
| home_page | None |
| Summary | A python package for working with MIDI data files. (POZAlabs forked) |
| upload_time | 2024-05-16 09:47:59 |
| maintainer | None |
| docs_url | None |
| author | pozalabs |
| requires_python | <4.0,>=3.9 |
| license | MIT |
| keywords |
midi
mir
music
|
| VCS |
|
| bugtrack_url |
|
| requirements |
No requirements were recorded.
|
| Travis-CI |
No Travis.
|
| coveralls test coverage |
No coveralls.
|
# Miditoolkit
A Python package for working with MIDI files.
[](https://pypi.python.org/pypi/miditoolkit/)
[](https://www.python.org/downloads/release/)
[](https://github.com/YatingMusic/miditoolkit/actions/workflows/pytest.yml)
[](https://github.com/YatingMusic/miditoolkit/blob/main/LICENSE)
[](https://pepy.tech/project/miditoolkit)
[](https://github.com/psf/black)
Miditoolkit works by loading/writing MIDIs with [mido](https://github.com/mido/mido) in a user-friendly way. It is inspired from [pretty_midi](https://github.com/craffel/pretty-midi), with similar usage and core features, but handles the MIDI events in native **[ticks](https://www.recordingblogs.com/wiki/midi-tick)** time unit instead of seconds. It also comes with a few optimizations and speed-ups, and can parse MIDI tracks into **piano-rolls** for computation or visualization purposes.
If you are working with seconds time units (for e.g. music transcription), you'll be likely better with pretty_midi. Otherwise, if you are working solely on MIDI and symbolic music, miditoolkit should provide slightly faster performances.
## Main Features
* MIDI
* Global
* ticks per beat
* tempo changes
* key signatures
* time signatures
* lyrics
* markers
* Instruments
* control changes
* pitch bend
* Editing
* chunk/cropping
* IO
* BytesIO
* Piano-rolls
* Tools
* notes to piano-rolls
* piano-rolls to notes
* chromagram
* Visualization
* External Library
* [structure analysis](https://github.com/wayne391/sf_segmenter)
## TODO
* better documentation;
* finish the code cleaning of the pianoroll methods (vis);
* a way to switch the time in seconds across the whole MidiFile object;
* cropping Control Changes and bars;
* symbolic features
* new structural analysis
## Installation
You can install miditoolkit via [PYPI](https://pypi.org/project/miditoolkit/):
```bash
pip install miditoolkit
```
... or directly from git if you want to get the latest features or fixes (only recommended if you need it):
```bash
pip install git+https://github.com/YatingMusic/miditoolkit
```
## Example Usage
```python
from miditoolkit import MidiFile
from miditoolkit.midi.utils import example_midi_file
path_midi = example_midi_file()
midi_obj = MidiFile(path_midi)
print(midi_obj)
```
Output:
```
ticks per beat: 480
max tick: 72002
tempo changes: 68
time sig: 2
key sig: 0
markers: 71
lyrics: False
instruments: 2
```
A. [Parse and create MIDI files](examples/parse_and_create_MIDI_files.ipynb)
B. [Piano-roll Manipulation](examples/pinoroll_manipulation.ipynb)
## Philosophy
* [mido](https://github.com/mido/mido) processes MIDI files in the lower level such as messages and ports, and is the backend pretty_midi and miditoolkit;
* [pretty_midi](https://github.com/craffel/pretty-midi) parses MIDI files and pianorolls in seconds time unit, plus has audio related features;
* [pypianoroll](https://github.com/salu133445/pypianoroll) parses MIDI files into pianorolls in ticks time unit.
**Miditoolkit** is designed for handling MIDI in **[ticks](https://www.recordingblogs.com/wiki/midi-tick)**, the native time unit of the MIDI protocol. We keep the midi parser as simple as possible, and offer several important functions to complete the versatility. For example, piano-rolls, tick-to-second, chromagram, etc.
Raw data
{
"_id": null,
"home_page": null,
"name": "pozalabs-miditoolkit",
"maintainer": null,
"docs_url": null,
"requires_python": "<4.0,>=3.9",
"maintainer_email": null,
"keywords": "midi, mir, music",
"author": "pozalabs",
"author_email": "contact@pozalabs.com",
"download_url": "https://files.pythonhosted.org/packages/a9/1d/4bc83373937847a85fca294b318bb71b9688008effe741981f4f3b29b287/pozalabs-miditoolkit-1.1.3.tar.gz",
"platform": null,
"description": "# Miditoolkit\n\nA Python package for working with MIDI files.\n\n[](https://pypi.python.org/pypi/miditoolkit/)\n[](https://www.python.org/downloads/release/)\n[](https://github.com/YatingMusic/miditoolkit/actions/workflows/pytest.yml)\n[](https://github.com/YatingMusic/miditoolkit/blob/main/LICENSE)\n[](https://pepy.tech/project/miditoolkit)\n[](https://github.com/psf/black)\n\nMiditoolkit works by loading/writing MIDIs with [mido](https://github.com/mido/mido) in a user-friendly way. It is inspired from [pretty_midi](https://github.com/craffel/pretty-midi), with similar usage and core features, but handles the MIDI events in native **[ticks](https://www.recordingblogs.com/wiki/midi-tick)** time unit instead of seconds. It also comes with a few optimizations and speed-ups, and can parse MIDI tracks into **piano-rolls** for computation or visualization purposes.\nIf you are working with seconds time units (for e.g. music transcription), you'll be likely better with pretty_midi. Otherwise, if you are working solely on MIDI and symbolic music, miditoolkit should provide slightly faster performances.\n\n## Main Features\n\n* MIDI\n * Global\n * ticks per beat\n * tempo changes\n * key signatures\n * time signatures\n * lyrics\n * markers\n * Instruments\n * control changes\n * pitch bend\n * Editing\n * chunk/cropping\n * IO\n * BytesIO\n* Piano-rolls\n * Tools\n * notes to piano-rolls\n * piano-rolls to notes\n * chromagram\n * Visualization\n* External Library\n * [structure analysis](https://github.com/wayne391/sf_segmenter)\n\n## TODO\n\n* better documentation;\n* finish the code cleaning of the pianoroll methods (vis);\n* a way to switch the time in seconds across the whole MidiFile object;\n* cropping Control Changes and bars;\n* symbolic features\n* new structural analysis\n\n## Installation\n\nYou can install miditoolkit via [PYPI](https://pypi.org/project/miditoolkit/):\n\n```bash\npip install miditoolkit\n```\n\n... or directly from git if you want to get the latest features or fixes (only recommended if you need it):\n\n```bash\npip install git+https://github.com/YatingMusic/miditoolkit\n```\n\n## Example Usage\n\n```python\nfrom miditoolkit import MidiFile\nfrom miditoolkit.midi.utils import example_midi_file\n\npath_midi = example_midi_file()\nmidi_obj = MidiFile(path_midi)\n\nprint(midi_obj)\n```\n\nOutput:\n\n```\nticks per beat: 480\nmax tick: 72002\ntempo changes: 68\ntime sig: 2\nkey sig: 0\nmarkers: 71\nlyrics: False\ninstruments: 2\n```\n\nA. [Parse and create MIDI files](examples/parse_and_create_MIDI_files.ipynb)\nB. [Piano-roll Manipulation](examples/pinoroll_manipulation.ipynb)\n\n## Philosophy\n\n* [mido](https://github.com/mido/mido) processes MIDI files in the lower level such as messages and ports, and is the backend pretty_midi and miditoolkit;\n* [pretty_midi](https://github.com/craffel/pretty-midi) parses MIDI files and pianorolls in seconds time unit, plus has audio related features;\n* [pypianoroll](https://github.com/salu133445/pypianoroll) parses MIDI files into pianorolls in ticks time unit.\n\n**Miditoolkit** is designed for handling MIDI in **[ticks](https://www.recordingblogs.com/wiki/midi-tick)**, the native time unit of the MIDI protocol. We keep the midi parser as simple as possible, and offer several important functions to complete the versatility. For example, piano-rolls, tick-to-second, chromagram, etc.\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "A python package for working with MIDI data files. (POZAlabs forked)",
"version": "1.1.3",
"project_urls": null,
"split_keywords": [
"midi",
" mir",
" music"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "330c3d3018a6e7215ba8d4bdb7d13e12b023c23aa31868f4e3abf3229192b33a",
"md5": "e7528d64ca4deb7f229ee488d88facb7",
"sha256": "31be61e8b76ccf4e2d484b386349a71f904981bd24b035ca29cc69d93409d64a"
},
"downloads": -1,
"filename": "pozalabs_miditoolkit-1.1.3-py3-none-any.whl",
"has_sig": false,
"md5_digest": "e7528d64ca4deb7f229ee488d88facb7",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": "<4.0,>=3.9",
"size": 20726,
"upload_time": "2024-05-16T09:48:01",
"upload_time_iso_8601": "2024-05-16T09:48:01.972852Z",
"url": "https://files.pythonhosted.org/packages/33/0c/3d3018a6e7215ba8d4bdb7d13e12b023c23aa31868f4e3abf3229192b33a/pozalabs_miditoolkit-1.1.3-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "a91d4bc83373937847a85fca294b318bb71b9688008effe741981f4f3b29b287",
"md5": "790e0887b2c8bdf811049adc2d96390b",
"sha256": "980e7736a0415a3d6229fe34c7f8965659b6682c92fa98b1e6b78ca9dc10abb7"
},
"downloads": -1,
"filename": "pozalabs-miditoolkit-1.1.3.tar.gz",
"has_sig": false,
"md5_digest": "790e0887b2c8bdf811049adc2d96390b",
"packagetype": "sdist",
"python_version": "source",
"requires_python": "<4.0,>=3.9",
"size": 20131,
"upload_time": "2024-05-16T09:47:59",
"upload_time_iso_8601": "2024-05-16T09:47:59.567464Z",
"url": "https://files.pythonhosted.org/packages/a9/1d/4bc83373937847a85fca294b318bb71b9688008effe741981f4f3b29b287/pozalabs-miditoolkit-1.1.3.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-05-16 09:47:59",
"github": false,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"lcname": "pozalabs-miditoolkit"
}
