Installation on MacOS

Modern versions of MacOS come with a pre-installed version of Perl that is capable of running the command line version of ChordPro. It is currently not possible (well, not easy) to run the GUI version. To run the GUI version please use the binary install. Note that the binary install includes both the GUI and the command line version of ChordPro.

To install the command line version of ChordPro, open a command terminal window and type

sudo xcode-select --install

You need to do this only once. This may give a final error that the install failed, this can be ignored.

Using system perl

Type:

sudo cpan chordpro

Make sure you are running the system version of the cpan tool. If in doubt, type this instead:

sudo /usr/bin/cpan chordpro

ChordPro should now be built and installed, by default in /usr/local/bin.

Try it by typing chordpro --version. The result should be similar to

This is ChordPro version 0.977

(The version number may be different.)

Using HomeBrew

First, install homebrew if it is not yet installed. Directions can be found here.

Then install perl:

brew install perl

Note that this will install perl in a subdirectory of /usr/local/Cellar, e.g. /usr/local/Cellar/perl/5.32.0/bin. It is advised to add this to the front of your PATH.

If you want to use the ChordPro GUI, install wxWidgets and wxPerl.

brew install wxmac
/usr/local/Cellar/perl/5.32.0/bin/cpan Wx

The last command may take a while, but should complete without errors.

Finally, install ChordPro:

/usr/local/Cellar/perl/5.32.0/bin/cpan chordpro

This will give you both the chordpro and wxchordpro commands.

Personal configuration

The personal configuration is processed every time you run ChordPro, unless you specify the --nodefaultconfigs or --nouserconfig command line option.

If you have a folder .config in your home folder, you can create a subfolder chordpro and place your personal configuration file there:

/Users/USER/.config/chordpro/chordpro.json

where USER is your MacOS user name.

If there is no .config folder, and you do not want to create it, you can create a subfolder .chordpro in your home and place your personal config there:

/Users/USER/.chordpro/chordpro.json

System configuration

A global configuration file can be placed in /etc:

/etc/chordpro.json

This config file is processed every time any user on the system runs ChordPro, unless the user specifies the --nodefaultconfigs or --nosystemconfig command line option.

This may be a good place to set system dependent settings like the printer paper size and font paths.