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
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
Try it by typing
chordpro --version. The result should be similar to
This is ChordPro version 0.977
(The version number may be different.)
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/perl/5.32.0/bin. It is
advised to add this to the front of your
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:
This will give you both the
The personal configuration is processed every time you run ChordPro,
unless you specify the
command line option.
If you have a folder
.config in your home folder, you can create
chordpro and place your personal configuration file
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:
A global configuration file can be placed in
This config file is processed every time any user on the system runs
ChordPro, unless the user specifies the
--nosystemconfig command line option.
This may be a good place to set system dependent settings like the printer paper size and font paths.