Generate chord chart
generate_chord_chartRead-onlyIdempotent
Use this when the user wants a guitar chord chart printable, a ukulele chord chart, a piano chord chart, or chord diagrams for a song. Convert a pasted song or an uploaded photo of a chord sheet into the chords list (chord names like G, Em, F#m7, C/E); use chord_sheet only to pass raw pasted text. Draws one diagram per different chord as a print-ready PDF (US Letter or A4, 6, 12 or 24 per page) for guitar in standard tuning, ukulele (G C E A) or piano, with optional transpose, capo (or "auto"), and left-handed diagrams. Guitar and ukulele shapes are checked by their notes. Does not do alternate tunings, bass, tabs or notation.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| capo | No | Guitar or ukulele capo fret 0-9, or "auto" to pick the capo with the easiest open shapes. Default 0. A "Capo 2" line in chord_sheet is read too. | |
| paper | No | letter (US Letter, default) or a4. | |
| title | No | Heading printed on the sheet, e.g. the song name "Wonderwall" or "Beginner chords". Default "Chord chart". | |
| chords | No | Chord names, one per item, e.g. ["G", "Em", "C", "D7", "F#m7b5", "C/E"]. Convert a pasted song or a photo of a chord sheet into this list of the chords it uses. Repeats are drawn once. Up to 64 different chords. | |
| to_key | No | Transpose to this key instead of giving semitones, e.g. G or Bbm. The original key is from_key, a Key: line in the sheet, or the first chord. | |
| from_key | No | The song's current key when to_key is used, e.g. E. Optional. | |
| per_page | No | Diagrams per page: 6, 12 (default) or 24. | |
| capo_mode | No | How chord names relate to the capo: "shapes" (default with a capo number) means the names are the shapes you finger, as chord sheets that say "Capo 2" write them; each diagram says which chord sounds. "sounding" means the names are the chords that should sound, and the tool finds the shapes to play with the capo (used for capo "auto"). | |
| instrument | No | guitar (standard tuning E A D G B E, default), ukulele (G C E A) or piano (keyboard diagrams). Several, e.g. "guitar and ukulele", give one PDF with each instrument on its own pages. | |
| chord_sheet | No | Fallback: a pasted chord sheet (chords over lyrics, or inline [Am] chords). Every chord in it is drawn once, in order of first use. Example: "G Em\nHello my friend\nC D\nHow are you". | |
| left_handed | No | true for mirrored left-handed diagrams (low string on the right). Default false. | |
| shapes_per_chord | No | How many positions to draw per chord, 1 (default) to 4, lowest on the neck first. | |
| show_finger_numbers | No | Print finger numbers in the dots (default true). | |
| transpose_semitones | No | Shift every chord up (positive) or down (negative) by this many semitones before drawing, e.g. 2 or -3. Default 0. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| capo | Yes | ||
| notes | Yes | ||
| pages | Yes | ||
| paper | Yes | ||
| title | Yes | ||
| tuning | Yes | ||
| skipped | Yes | ||
| diagrams | Yes | ||
| per_page | Yes | ||
| downloads | Yes | ||
| instrument | Yes | ||
| chord_count | Yes | ||
| left_handed | Yes | ||
| diagram_count | Yes | ||
| diagrams_shown | No | ||
| transpose_semitones | Yes |