Skip to content

amypellegrini/piano-chord-charts

Repository files navigation

Piano chord charts

Piano/keyboard chord charts SVG library and generator tool.

Context

Creating piano/keyboard chart diagrams for educational purposes can be time consuming, particularly when accounting for all musical keys in combination with different voicing patterns. When done manually it can be repetitive and prone to errors.

The goal of this tool is to automate the process of generating piano/keyboard charts in SVG format and provide a sensible interpretation of common chord symbols and voicing patterns.

CLI

Once installed, running the piano-chord-charts command will emit an empty keybaord chart. If additional options are passed the keyboard diagram will be created accordingly.

CLI Options

Flag Description Example
--outDir The file will be emitted to the specified location. --outDir myfolder
--format Keyboard diagram format. Values can be exact or compact (default will be compact). --format exact
--highlightKeys Highlights given keys by name, from left to right. --highlightKeys "C E G"
--size Keyboard size (amount of white keys). --size 5
--startFrom Renders keyboard chart starting from a given white key. --startFrom G

Running tests

npm test