Chord Nerdery 101

OnSong can totally display chord diagrams for all those gnarly chords buried in your text-based chord charts. By default, OnSong yeets itself into the Chord Diagram Library & grabs the basic variation. But hey, sometimes you're like "nah, I need that specific chord flavor for this bop." So yeah, you gotta define a chord using ChordPro syntax like this:

{define: E5 base-fret 7 frets 0 1 3 3 x x fingers - 1 2 3 - - key E}

Here's what all that alphabet soup means, bestie:

• Define is basically you screaming "HOLD UP, NEW CHORD INCOMING."
• E5 is literally the name of the chord you're making up. Any chord that matches this name will use your precious custom diagram.
• base-fret says "yo, the following number is where this whole thing starts on the neck." Everything else is measured from there, srsly.
• frets is your space-separated list of which frets are gettin' pressed. 0 = open string (no pressure, just vibes), 1 & 3 = first & third fret relative to your base fret, & "x" = literally don't touch that string, don't even look at it.
• fingers is a space-separated list of which fingers you should use on each string. The "-" symbol means "nah, strings aren't gettin' fingered." The 1, 2 & 3? Those are your actual fingers doin' the work.
• key tells OnSong what key the chord lives in. Spoiler alert: we haven't figured this one out yet. Oopsie.

If your chord definition doesn't exist in the Chord Diagram Library, OnSong's like "fine, I'll add it myself" & sets it as the default variation for that song. OnSong applies the chord to guitar when six strings show up, 5-string bass when five strings show up, & whatever random instrument when 4 or some other weird number of strings appear. No pressure, it's all pretty intuitive... not.