Chord Library - Revision history

Marekpalka at 06:12, 5 June 2026

2026-06-05T06:12:46Z

Marekpalka: Created page with "== 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...."

2026-06-05T06:11:37Z

Created page with "== 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...."

New page

== 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. <code>chord_Am7.png</code>).
• '''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.

← Older revision		Revision as of 08:12, 5 June 2026
Line 5:		Line 5:
	== Opening the Library ==		== Opening the Library ==

	• Library → Tools → '''Chord Library''' (chord-diagram icon). This shows the full database in browse mode.		* 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.		* 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 ==		== Filters ==
Line 13:		Line 13:

	;Mode (segmented control)		;Mode (segmented control)
	• '''All chords''' — built-in database.		* '''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.		* '''My chords (n)''' — only your custom chords; the count next to it shows how many you've added for the current instrument.

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

	;Chord specification		;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.		* '''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.		* '''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).		* '''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.		In '''All chords''' mode up to 100 voicings are shown at once; tighten the filters if you need to see more.
Line 28:		Line 28:
	== Browsing & Playing ==		== Browsing & Playing ==

	• Guitar and ukulele voicings render as fretboard diagrams with finger numbers (when enabled in Song View preferences).		* Guitar and ukulele voicings render as fretboard diagrams with finger numbers (when enabled in Song View preferences).
	• Piano voicings render as keyboard diagrams.		* 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.		* 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).		* In '''Chord Alternatives''' mode, the currently preferred voicing is outlined with the accent color (blue for piano).

	== Chord Actions (long-press / right-click) ==		== Chord Actions (long-press / right-click) ==
Line 37:		Line 37:
	The context menu on a chord exposes:		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''' — 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.		* '''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.		* '''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.		* '''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. <code>chord_Am7.png</code>).		* '''Export PNG''' — renders the diagram (with name) and offers a Share/Export dialog. File is named after the chord (e.g. <code>chord_Am7.png</code>).
	• '''Delete''' — only for custom chords. Confirms before removing.		* '''Delete''' — only for custom chords. Confirms before removing.

	== Adding a Custom Chord ==		== 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.		* 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.		* For guitar/ukulele, '''GuitarChordEditorView''' opens; for piano, '''PianoChordEditorView''' opens.

	In the guitar/ukulele editor you can:		In the guitar/ukulele editor you can:

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

	Save options:		Save options:

	• '''Save''' — stores the chord and returns to the library.		* '''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.		* '''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.		* '''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.		After saving from the library's main view, the filter automatically switches to '''My chords''' so you can see what you've just added.
Line 68:		Line 68:
	Preferred voicings are stored at two levels:		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.		* '''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''' — 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.		Per-song preferences take precedence over global preferences when JustChords decides which diagram to show next to a chord in a song.