mirror of
https://github.com/kennethreitz/pytheory.git
synced 2026-06-05 23:00:20 +00:00
kennethreitz
4ab8be49a5
New: Music Theory Fundamentals guide covering: - Sound and pitch (frequency ranges, logarithmic perception) - Why twelve notes (harmonic series, Pythagorean comma) - Intervals as atoms of music (size, quality, perfect vs major/minor) - Keys and key signatures (sharp/flat key tables, FCGDAEB mnemonic) - Functional harmony (tonic/subdominant/dominant, T-S-D-T) - The dominant seventh (leading tone, tritone resolution) - Rhythm and meter (4/4, 3/4, 6/8, odd meters) - Physics of consonance (waveform alignment, cultural context) Enriched existing pages: - Tones: overtone series table, enharmonic equivalents and spelling rules - Scales: 12-bar blues, parallel major/minor, borrowed chords, more progression examples with song references - Chords: inversions (root/1st/2nd/3rd), extended chords (9ths/11ths/13ths) Also: add Gauges analytics tracking to all pages Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
48 lines
1.0 KiB
ReStructuredText
48 lines
1.0 KiB
ReStructuredText
PyTheory: Music Theory for Humans
|
|
=================================
|
|
|
|
**PyTheory** is a Python library that makes exploring music theory approachable.
|
|
Work with tones, scales, chords, and fretboards using a clean, Pythonic API.
|
|
|
|
.. code-block:: python
|
|
|
|
from pytheory import TonedScale, Fretboard, CHARTS
|
|
|
|
# Build a C major scale
|
|
c_major = TonedScale(tonic="C4")["major"]
|
|
print(c_major.note_names)
|
|
# ['C', 'D', 'E', 'F', 'G', 'A', 'B', 'C']
|
|
|
|
# Build a triad from the scale
|
|
chord = c_major.triad(0) # C major triad
|
|
for tone in chord:
|
|
print(f"{tone}: {tone.frequency:.1f} Hz")
|
|
|
|
# Get guitar fingerings
|
|
fb = Fretboard.guitar()
|
|
print(CHARTS["western"]["C"].fingering(fretboard=fb))
|
|
|
|
.. toctree::
|
|
:maxdepth: 2
|
|
:caption: User Guide
|
|
|
|
guide/quickstart
|
|
guide/theory
|
|
guide/tones
|
|
guide/scales
|
|
guide/chords
|
|
guide/fretboard
|
|
guide/systems
|
|
guide/playback
|
|
|
|
.. toctree::
|
|
:maxdepth: 2
|
|
:caption: API Reference
|
|
|
|
api/tones
|
|
api/scales
|
|
api/chords
|
|
api/charts
|
|
api/play
|
|
api/systems
|