chartparse

A library for parsing Guitar Hero .chart files.


Keywords
guitar-hero, rock-band
License
MIT
Install
pip install chartparse==0.3.1

Documentation


chartparse

codecov CI

Install it from PyPI

pip install chartparse

Usage

from chartparse.chart import Chart
from chartparse.instrument import Instrument, Difficulty

c = Chart.from_filepath("/path/to/file.chart")

# the first 7 BPM changes (including the initial one)
c.sync_track.bpm_events[:7]

# the first 8 time signature changes (including the initial one)
c.sync_track.time_signature_events[:8]

expert_guitar = c[Instrument.GUITAR][Difficulty.EXPERT]

# the first 10 notes of the expert guitar chart
expert_guitar.note_events[:10]

# the first 3 star power phrases of the expert guitar chart
expert_guitar.star_power_events[:3]

See the documentation for more detailed guidance.

Note: this software is tested only with .chart files that are written by Moonscraper. Files written by other editors or are handwritten may produce undefined behavior.

Development

Read the CONTRIBUTING.md file.