Chord Library

The Chord Library is a browseable catalog of chord diagrams for Guitar, Ukulele and Piano. It includes a built-in database of standard voicings plus a per-user collection of custom chords, and lets you choose which voicing is preferred for any chord — globally or just for a single song.

Opening the Library

Library → Tools → Chord Library (chord-diagram icon). This shows the full database in browse mode.
Tap a chord in a song's lyrics/chords view. The Library opens in Chord Alternatives mode, scoped to that one chord, so you can pick which fingering to use for that song.

Filters

The top of the Library has three picker rows:

Mode (segmented control)

All chords — built-in database.
My chords (n) — only your custom chords; the count next to it shows how many you've added for the current instrument.

Instrument

Switch between Guitar, Ukulele and Piano from the toolbar. The current Song View instrument is used by default.

Chord specification

Root — the chord's root note (C, C#/Db, D, …). Choose "–" in My chords to list all your custom chords regardless of root.
Suffix — chord quality (major, minor, 7, m7, sus4, …). Choose "–" to show all suffixes for the selected root.
Bass — optional bass note for slash chords (e.g. C/G).

In All chords mode up to 100 voicings are shown at once; tighten the filters if you need to see more.

Browsing & Playing

Guitar and ukulele voicings render as fretboard diagrams with finger numbers (when enabled in Song View preferences).
Piano voicings render as keyboard diagrams.
Tap any diagram to hear it played through the audio engine, using your preferred chord-play speed and the current instrument sound.
In Chord Alternatives mode, the currently preferred voicing is outlined with the accent color (blue for piano).

Chord Actions (long-press / right-click)

The context menu on a chord exposes:

Set as preferred — only in Chord Alternatives mode. Makes this voicing the global default whenever that chord appears.
Set as preferred for this song — only in Chord Alternatives mode. Overrides the global preference for the current song only.
Edit — only for custom chords. Opens the chord editor.
Duplicate — creates a copy you can edit without altering the original. Built-in chords can be duplicated to seed a new custom chord.
Export PNG — renders the diagram (with name) and offers a Share/Export dialog. File is named after the chord (e.g. chord_Am7.png).
Delete — only for custom chords. Confirms before removing.

Adding a Custom Chord

Tap the + (plus) button in the toolbar to open the chord editor pre-filled with the current Root / Suffix / Bass filters.
For guitar/ukulele, GuitarChordEditorView opens; for piano, PianoChordEditorView opens.

In the guitar/ukulele editor you can:

Change the chord name (root, suffix, bass) via the Chord Properties screen.
Pick a base fret (1–17).
Set each string's fret, finger and barre.
Preview the diagram live at the top; tap it to hear the chord.

Save options:

Save — stores the chord and returns to the library.
Next — saves the chord, shows a toast confirmation, and clears the form so you can keep adding more chords back-to-back without leaving the editor.
Cancel — discards changes.

After saving from the library's main view, the filter automatically switches to My chords so you can see what you've just added.

Preferred Chord Positions

Preferred voicings are stored at two levels:

Global — applied wherever the chord appears across the app. Set via "Set as preferred" in Chord Alternatives mode.
Per-song — overrides the global choice for one song only, useful when a particular song needs a different fingering or shape. Set via "Set as preferred for this song".

Per-song preferences take precedence over global preferences when JustChords decides which diagram to show next to a chord in a song.