# Important notes for running ChordPro on MacOS

Due to MacOS security constraints it is currently not possible to use the standard file open and save dialogs. As a consequence, you will not be able to open arbitrary (ChordPro) files, and save changes into arbitrary files.

The advised way of using ChordPro is by double-clicking a ChordPro document in the Finder. Alternatively you can use drag and drop, or the Finder `Open with ...` command.

ChordPro is currently limited to one document at a time.

When ChordPro is started with a document, you can make changes and save your changes into the document.

When ChordPro is started without document, it presents a dummy document containing just a title. You can edit and preview but you will not be able to save your changes.

Hint: You can use Select All (command-A) and copy and paste to transfer the contents to somewhere else.

Due to MacOS security constraints it is currently not possible to select a custon config file, library or template using a file chooser. Instead, you must type the name of an existing file or folder in the Preferences dialog.

Printing from the Finder is like opening.

ChordPro on MacOS currently does not support embedding of LilyPond. Embedding of ABC is integrated.

## Warning!

Song files in MS-Windows format (with CR/LF line terminators) may misbehave.

## Hints

The ChordPro 'app' has two binaries: the ChordPro GUI program (default) and the command line version. Provided the dmg is mounted in its default location, you can run the command line version from a Terminal window with:

`/Volumes/ChordPro\ Installer/ChordPro.app/Contents/MacOS/chordpro`

## Support

Consult www.chordpro.org for information and documentation.

Please join the user forum for support and the latest updates.

Are you a MacOS developer? Please help us to overcome the MacOS limitations and improve the user experience!