Preset configurations

ChordPro comes with a number of standard configurations.

It is important to know that ChordPro always loads the default configuration and then adds the other configurations.

  • In the GUI, there is a dropdown list for the presets in the Preferences dialog.
  • On the command line, use --config, e.g., --config=modern1.

Some of the presets define a full style, e.g., chordii and modern1. Other presets modify the current style, e.g., nashville and ukulele. So you can combine presets to form new styles. For example, --config=modern1,nashville

Click on the page thumbnails to see the full size version.

Default

As the name implies, this is the default configuration.

Chordii

This preset configuration makes the output look as closely as possible to the output of the Chordii program.

Modern1

A nice, modern style.

Modern2

An alternative modern style.

Modern3

A style with chord diagrams in a right column on the first page instead of at the end of the song.

Dark

A dark ’theme'.

This style only sets colours, so it can be used in combination with other styles.

Nashville

A special style for songs that use Nashville numbering notation.

This style only sets the font for the chords, so it can be used in combination with other styles.

Roman

A special style for songs that use Roman numbering notation.

This style only sets the font for the chords, so it can be used in combination with other styles.

Keyboard

This preset sets the instrument to keyboard. It doesn’t define chords since keyboard chords can be determined from their names.

This style only sets the instrument, so it can be used in combination with other styles.

Ukulele

This preset adds ukulele tuning and chords.

This style only sets the instrument and defines the ukulele chords, so it can be used in combination with other styles.

User library

Presets are looked up in the folders where ChordPro is installed. It is possible to add a custom folder presets by using environment variable CHORDPRO_LIB.

CHORDPRO_LIB should have the name of the custom folder, and a subfolder config where the custom configs can be placed. For example, assume CONFIG_LIB is ~/lib/ChordPro and this folder contains config/mspro.json, then this config can be used as

--config mspro

Note that currently the name of the config file must be all lowercase characters. It may be referred in any case, e.g

--config Mspro
--config MSPro