This documentation refers to PhraseExpress v6 beta. The documentation for current v5 is available here.

Installation

Step-by-step video tutorial

PhraseExpress is installed like most regular programs on a Mac:

  1. Download the installation file.
  2. Double-click the installation file.
  3. Click and drag the PhraseExpress symbol from left to right onto the Applications folder:

  4. Launch PhraseExpress. It will show a start wizard if launched for the first time.

Do not skip the following important macOS configuration steps!

Important macOS settings

PhraseExpress must be configured in macOS settings to be granted access to following system permissions:

  • Accessibility – Required to detect keyboard input such as hotkeys and autotext abbreviations.
  • Screen Recording – This setting name is somehow misleading as it also includes access to the cursor position which is required by PhraseExpress to position the phrase menus and detect program window names for the phrase program restriction feature.
  • Full disk access – Required to save generated documents or save phrase files.

PhraseExpress never transmits your files or mouse/keyboard input over the internet (see our privacy policy).

The configuration procedure differs between different macOS version as Apple moves settings around and rename menu items:

MacOS 13/14

  1. Open the macOS "System Settings" and select "Privacy & Security » Accessibility":

  2. In the list of applications, lookup "PhraseExpress" and make sure that the option is enabled:

  3. Select "Screen Recording" on the right, add PhraseExpress to the list and make sure that it is checked.
  4. Select "Full Disc Access" on the right, add PhraseExpress to the list and make sure that it is checked.

MacOS 11/12

  1. Open the macOS System Preferences:

  2. Click "Security & Privacy":

  3. Switch to tab "Privacy", select "Accessibility" in the left pane and click the lock icon below to unlock the settings page:

  4. Add PhraseExpress to the list and make sure that it is checked.
  5. Select "Screen Recording" on the left. Add PhraseExpress to the list and make sure that it is checked.
  6. Select "Full Disc Access" on the left. Add PhraseExpress to the list and make sure that it is checked.

Troubleshooting macOS system permissions

The macOS system permissions may not work, although the settings seem to be correct. This can occur, for example, after a macOS and/or PhraseExpress update, since macOS may consider an update as a unknown new software.

Video tutorial (recommended)

Solution:

  1. Quit PhraseExpress. Important! You really need to quit PhraseExpress first.
  2. Important: Repeat the above macOS security settings by adding PhraseExpress again (as described above) with the + button, regardless if the entry already exists! This seems counter-intuitive, but really is required as it may fix issues with the macOS preferences database.
  3. Restart the Mac.

If this doesn't help, delete PhraseExpress from your computer, remove all PhraseExpress entries in macOS Security Preferences, reinstall PhraseExpress and do the security settings again. Installing PhraseExpress in a different directory may also help.

Experts only: The macOS security and privacy database sometimes seems to be(come) unstable. To initialize the system permission database (for all apps!), use the command "sudo tccutil reset Accessibility" in the macOS Terminal App.

Configure macOS autotext

MacOS includes text replacement and spelling correction features that may collide with PhraseExpress. You might want to configure macOS if you want to use the same autotext shortcuts in PhraseExpress to prevent conflicts:

MacOS 13 Ventura

cross-platformTo configure text replacement in macOS 13:
  1. Open the macOS System Preferences » Keyboard » Text Replacements…:

  2. Review your text replacement entries and delete those, you wish to assign in PhraseExpress, or make sure not to use the same autotext abbreviations in PhraseExpress:

MacOS has a built-in spelling correction which you should prefer. However, if you also use Windows PC and wish to build a Windows/Mac cross-platform spelling correction library, you should consider disabling spelling correction on the Mac to avoid interference between both correction mechanisms.

  1. In section Keyboard, press the "Edit" button:

  2. Consider disabling the macOS system spelling correction:

If you wish to use the arrow keys on your keyboard to navigate through PhraseExpress forms and phrase menus, consider enabling the "full keyboard access" macOS feature:

  1. Go to macOS "System Preferences » Accessibility":

  2. Enable "Full Keyboard Access":

MacOS 11 Big Sur (out-of-date)

To configure text replacement in macOS 11/12:
  1. Open the macOS System Preferences:

  2. Open section Keyboard:

  3. Switch to section "Text" and either uncheck "Correct spelling automatically" or delete the autotexts that you intend to use in PhraseExpress:

  4. If you wish to use keyboard arrow keys and TAB to conveniently navigate in forms with the keyboard, switch to section "Shortcuts" und set option "Use keyboard navigation...":

Upgrade an existing installation

Do not skip this essentially important note!

Previous PhraseExpress version 5 introduced a new phrase storage format and changes the way how to sync between computers.

The old PXI phrase file format has retired. If you upgrade a stand-alone installation, PhraseExpress converts a copy of your existing *.pxi phrase file into the new database format and uses this new database. This should be a seamless procedure in regular setups. Keep the copy of your pxi phrase file!

To upgrade a stand-alone installation to a newer version:
  1. Backup your current phrases by exporting the phrase file.
  2. Download the latest PhraseExpress version.
  3. Install the new version over the current installation.
  4. If you have purchased a maintenance renewal, you need to replace the expired license key with the new license key.

If the new version does not automatically find the phrase file of the previous installation, load the phrase file manually.

Please check the program version history for features and specifications changes. Especially larger version jumps may require macro programming adjustments. New versions may require an updated phrase file format to support new features. In such case, older version will not be able to load the phrase file.

Table of Contents


Table of Contents