symusic

library0.6.0pypypi✓ verified 83d ago

A high performance MIDI file parser with comprehensible interface. Current version 0.6.0, actively maintained on GitHub.

data ai-ml

pip install symusic

github ↗package ↗

INSTALL

IMPORT

SIG · SYMUSIC

symusic

datapythonv0.6.0

harness data pending

Install & Compatibility

Where this runs

No compatibility data collected yet for this library.

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

Score

✓ from symusic import Score

✗ import symusic.Score

Score is a top-level class.

Track

✓ from symusic import Track

Load a MIDI file and inspect its tracks, ticks per beat, and time signatures.

from symusic import Score score = Score('path/to/file.mid') print(score.tracks, score.ticks_per_beat, score.time_signatures) for track in score.tracks: print(track.name, len(track.notes))

Debug

Known issues

breakingsymusic 0.5.0 changed the internal API and may break code using earlier versions. The Score class now uses a different initialization signature.

fix

Update to 0.6.0 and adjust Score creation: Score('path') instead of deprecated Score.from_file().

affects: <0.5.0

gotchaThe from_* methods (e.g., from_file, from_str) are deprecated as of 0.6.0. Direct constructor calls are preferred.

fix

Use Score('path') or Score.from_str(data) but note the deprecation; future versions may remove them.

affects: >=0.6.0

Errors

Common errors & fixes

ModuleNotFoundError: No module named 'symusic'

symusic not installed or imported incorrectly.

fix

Run 'pip install symusic' and use 'from symusic import Score'.

AttributeError: 'Score' object has no attribute 'from_file'

Using deprecated API removed in 0.6.0.

fix

Replace 'Score.from_file(path)' with 'Score(path)'.

Upgrade

Version history

0.6.0latest on PyPI · released Apr 8, 2026

Audit

Dependencies

numpyoptionalRequired for array representations.

Agent activity

15 hits · last 30 days

node

Amazon

OpenAI (training)

Resources

githubhttps://github.com/Yikai-Liao/symusic ↗

packagehttps://pypi.org/project/symusic/ ↗