Skip to main content
Build status Documentation status Coverage Downloads Downloads Open in Colab

chordparser is a Python 3 package that provides a musical framework to analyse chords. Chord notation can be parsed into Chords, which can then be analysed against other chords or the key of the song. This allows for harmonic analysis in chord sheets and helps musicians understand why and how chord progressions work.

Quick demo:

>>> import chordparser
>>> cp = chordparser.Parser()

>>> new_chord = cp.create_chord("C7add4/E")
>>> new_chord.notes
(E note, C note, F note, G note, B♭ note)

>>> new_chord.transpose_simple(6)
F♯7add4/A♯ chord
>>> new_chord.notes
(A♯ note, F♯ note, B note, C♯ note, E note)

>>> e_scale = cp.create_scale("E", "major")
>>> cp.to_roman(new_chord, e_scale)
II65 roman chord

>>> e_fifth = cp.create_diatonic(e_scale, 5)
>>> e_fifth
B chord
>>> cp.analyse_secondary(new_chord, e_fifth, e_scale)
"V65/V"

Features

  • Create and manipulate notes, keys, scales and chords easily

  • Parse complex chord notations

  • Transpose musical classes easily and accurately

  • Automatically generate notes for scales and chords from notation

  • Generate roman numeral notation from chords

  • Analyse chord-scale relationships

Installation

To install chordparser, run this command in your terminal:

$ pip install chordparser

Usage

Check out the Colab notebook, which runs through a working example to showcase chordparser’s functions and help you get started on using it.

The full documentation can be found here.

Contribute

Support

If you are having issues, please let me know at: titusongyl@gmail.com

Authors

Development Lead

License

The project is licensed under the MIT license.

Metadata

Release files for chordparser 0.4.2

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for chordparser 0.4.2
File Size Uploaded
chordparser-0.4.2.tar.gz 30.5 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for chordparser 0.4.2
File Interpreter ABI Platform
chordparser-0.4.2-py3-none-any.whl Python 3 none any Details

Total release size: 60.3 kB

Release files / chordparser-0.4.2.tar.gz

Download URL chordparser-0.4.2.tar.gz
Size 30.5 kB
Tags Source
SHA-256 checksum
How to use checksums
b6dfd22e20f2ff017ec4d5b64a969ff4d23af4e88b7d6d1f1ae4cdf1e03d1d58
BLAKE2b-256 checksum
How to use checksums
926a5111f8225556b81bd1887177313b5d3f14b63b1cd55bf093ecadb5685bc3
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/4.0.2 CPython/3.9.16

Release files / chordparser-0.4.2-py3-none-any.whl

Download URL chordparser-0.4.2-py3-none-any.whl
Size 29.8 kB
Tags Python 3
SHA-256 checksum
How to use checksums
27abff827a1acdfe9cda817cbb064e3c6f03b5c66479e487c668a18d896b4908
BLAKE2b-256 checksum
How to use checksums
c6f026d98d88c91d5fb5f1a5752a001c7305195e98a243bff144899a2ec8e122
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/4.0.2 CPython/3.9.16

Release history Release notifications | RSS feed

This release

0.4.2 This release

2 release files

0.4.1

2 release files

0.4.0

2 release files

0.3.11

2 release files

0.3.10

2 release files

0.3.9

2 release files

0.3.8

2 release files

0.3.7

2 release files

0.3.4

2 release files

0.2.2

2 release files

0.2.1

2 release files

0.2.0

2 release files

0.1.1

2 release files

0.1.0

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page