Advanced

Settings

Open File → Settings, the gear button in the toolbar, or press Ctrl+,. Changes take effect straight away.

The Settings pages
PageWhat's there
FretboardLeft-handed guitar; 12, 15 or 19 frets; the pick pointer over the strings; what the finger buttons show; marking all the chord's notes; sharps or flats for black-key roots.
SoundThe instrument, volume, strum speed and how long notes ring; strumming each chord as it's chosen; playing a string when you place a finger; the MIDI output. See Sounds.
Chord listHow many chords and fingerings your list has, where the file is, and Export, Import, Reload and Restore. See The chord list file.
AboutVersion, installation, the settings file, and Reset to defaults.
LicenseTrial status, buying, activating and deactivating. See Free and full versions.
The Settings window on its Fretboard page. Under The guitar: an unticked Left-handed guitar box, Frets shown set to 15 frets, and a ticked box to use a guitar pick as the pointer. Under Labels: On the finger buttons, show, set to Finger numbers; unticked boxes to show all the chord's notes on the neck and to name black-key roots with sharps.
Settings, Fretboard page.

Keyboard shortcuts

Shortcuts in the ChordPlayer window
KeysWhat they do
Space / Shift+SpaceStrum down / up
PPick one string at a time
TPlay all the strings together
1 – 6Play one string (1 = high E, 6 = low E)
EscStop all sound
Ctrl+FType a chord name
Ctrl+↑ / Ctrl+↓Half step up / down
Ctrl+→ / Ctrl+←Next / previous fingering
Ctrl+SSave changes to the fingering
Ctrl+Shift+SSave as a new fingering
Ctrl+ZUndo changes to the fingering
Ctrl+,Settings
F1This manual

The chord columns and the fingerings row also work with the arrow keys and Tab.

The chord list file

ChordPlayer starts with version 1's chord list built in: 462 chords and 2,107 fingerings, each one checked against the chord's notes (a few that were wrong in the original file were corrected or left out). The first time ChordPlayer runs, it writes the list to chords.json, in the same folder as its settings. From then on, that file is your chord list, and every fingering you save, change or delete is saved there.

Chord list commands (File menu, or Settings → Chord list)
CommandWhat it does
Export the chord listSaves a copy anywhere, to back up or share
Import a chord listReplaces your list with one exported earlier or shared with you (full version). Your current list is kept as a backup first.
Open the chord list folderShows chords.json in File Explorer
Reload the chord listReads the file again, after you've edited it by hand
Restore the original chord listPuts ChordPlayer's built-in list back. Your list is kept as chords.backup-date.json.

Editing it by hand

The file is plain text in JSON format, readable in Notepad. Edit it while ChordPlayer is closed, or use Reload the chord list afterwards. Each chord has a name and its fingerings, best first:

{ "name": "Am7", "fingerings": [
  { "frets": "x 0 2 0 1 0", "style": "Open" },
  { "frets": "5 7 5 5 5 5", "style": "Barre" }
] },
{ "name": "Em/G", "fingerings": [
  { "frets": "3 x 2 0 0 0" }
] }

If the file can't be read, ChordPlayer says so, uses its built-in list, and keeps your file as chords.json.bad so nothing is lost. Fix it, rename it back to chords.json, and reload.

Command line

When ChordPlayer is already running, these commands go to the running copy.

Command-line options for ChordPlayer.exe
OptionWhat it does
--chord <name>Show a chord, for example --chord "Em/G"
--playWith --chord: strum it, even if strumming each chord as it's chosen is turned off
--no-activateWith --chord: show it without taking the keyboard from the program you're using (how the Tray Transpose Tool sends chords)
--settingsOpen Settings
--quitExit ChordPlayer
--activate <key>Activate a license key on this computer
--installInstall or update it on this computer (shows the install window)
--uninstallRemove it; add --quiet to skip the questions
--helpList these options

Installing on many computers

For a school, church or music department:

Where settings are kept

Settings are kept in %AppData%\ChordPlayer\settings.json for each Windows user, and the chord list in chords.json next to it. Problems are logged in error.log in the same folder; include it if you contact us. Settings → About → Open folder opens it.

Portable use

To keep the program and its settings together, for example on a USB stick, create an empty file named ChordPlayer.settings.json next to ChordPlayer.exe. Settings are then saved there instead, and the chord list as ChordPlayer.chords.json. The trial and the license are tied to the computer and the Windows user, so a portable copy still needs activating on each computer it's used on.