Keyboard Chord Generator (Python)

About the Project

This Python-based application generates professional-looking piano chord diagrams as PDF files. It uses the ReportLab library to handle PDF rendering and leverages the custom font families KeyboardChordDiagram and OpusChordsSansStd to display visually accurate and musically meaningful chord graphics.

How It Works

• Users input a title, choose how many chords to include, and then list each chord name (e.g., Cmaj7, Dm, G7).
• The program processes a chord.json file and maps it to the correct visual layout of keys, using the KeyboardChordDiagram font to render the appropriate piano keyboard diagram.
• Additional text or chord labels are added using OpusChordsSansStd to maintain musical notation standards.
• The final result is exported as a well-formatted PDF file, suitable for printing, teaching, or performing.

Purpose 

Ideal for music educators, piano students, composers, and anyone needing custom chord visualizations quickly—without manual drawing or notation software.

Sample doc: 

Limitations and Upcoming Improvements

This initial version currently works only with root-position chords. Short-term development goals include:

• Support for Markdown-formatted text to add descriptions or comments

• Online editing of the chord library (chords.json) for dynamic updates

• Integration of scales and voicings to allow more natural chord connections