dsh-musictheory

When large language models assist in music creation and theoretical analysis, they often make high-frequency errors in pitch calculation, accidental marking, and enharmonic spelling—such as incorrectly stating the frequency of C4, misspelling a G# major chord as G# C D# instead of the correct G# B# D#, or omitting E# in the F# major scale. The dsh-musictheory plugin is designed to solve these deterministic errors by providing a zero-runtime-dependency mathematical toolbox that uses precise 12-TET arithmetic to ensure consistent and correct results every time.

The plugin's core capabilities lie in its comprehensive music theory parsing and generation features: users can parse note names in various formats to obtain MIDI numbers, octaves, exact frequencies, and all conventional enharmonic spellings; convert any frequency to the nearest note information; build chords for up to 26 quality types (including major, minor, diminished, augmented, etc.) with correct letter spellings and pitches; and generate 17 scale types (such as major, harmonic minor, Dorian, blues, etc.), ensuring each note is spelled according to music theory conventions. All tools support an optional A4 reference frequency to accommodate historical or alternative tuning needs.

dsh-musictheory is particularly suited for music software developers, music theory researchers, educational tool builders, and any project requiring reliable, precise music theory calculations integrated into applications. With structured error handling and extensive unit tests, it ensures input validation and computational stability, providing a solid mathematical foundation for music-related large language model applications.