Reference

This chapter contains information about phrase file and program states, hotkeys used in PhraseExpress, file locations and command-line parameters.

Phrase file states

Icons in the first tree level of the main program window indicate the phrase source and current status:

SymbolExplanation

Default state - Everything is fine.

The phrase file is reloading.

The client uses a temporary copy of a phrase file source, that is currently unavailable (offline).

User access restrictions are applied.

Autotext and hotkeys are disabled for this element. Right-click the phrase(folder) and select "Enable autotext/hotkeys" in the context menu to change state.

Another user is editing this element. Press F5 to update the status.

The phrase file is password-protected. or write-protected or you do not have edit permissions.

Program states

PhraseExpress has different states that are indicated by its tray icon:

IconExplanation

PhraseExpress is ready to use. A green colored exclamation mark indicates, that the client is loading a phrase file from a PhraseExpress Server.

PhraseExpress is currently executing a phrase or a macro automation.

PhraseExpress is deactivated for the current application:

  • The current application has been launched with different user credentials than PhraseExpress (see Wikipedia). For security reasons, PhraseExpress cannot paste into programs launched with admin rights while itself is running with normal user rights (or vice-versa). Make sure to have PhraseExpress and the target app running with the same credentials (more info).
  • PhraseExpress has been excluded to work in the current target app.

PhraseExpress is currently busy with loading/processing a phrase file.

Hotkeys, Autotext and the Autocomplete feature are temporarily disabled (see chapter "Temporarily disable PhraseExpress").

Program hotkeys

PhraseExpress uses following hotkeys in the main program window:

HotkeyPurpose
CTRL+ N Creates a new phrase at the current cursor's location in the phrase tree.
CTRL+ O Creates a new sub-folder at the current cursor's location in the phrase tree.
CTRL+SHIFT+ O Creates a new folder at the current cursor's location in the same level of the phrase tree.
CTRL+ H Opens the Find&Replace dialog.
CTRL+ S Saves the current status of all phrase files and keeps the main program window open.
CTRL+ A Selects all items in the current folder level in the phrase tree.
CTRL+ D Duplicates the items selected in the phrase tree.
CTRL+ W Closes the current tab.
CTRL+ 2/ 3 Toggles between two vs three columns view.
CTRL+ C, - X, - V Clipboard operations: Copy, Cut, Paste
Delete-keyDeletes the currently selected item
ESC Minimizes the main program window.
F1 -keyOpens this documentation
F3 Sets input focus into the QuickSearch box
F5-keyReloads the currently selected phrase file. This is also useful to check the current file status (online/offline, write protections, etc.).
SHIFT+F5Reloads all phrase files/databases currently loaded in PhraseExpress.
ALT+ F4 Minimizes/exits PhraseExpress
Arrow Left/Right Expands/Collapses the currently selected phrase folder level. If press multiple times, the selection advances to the parent folder.
CTRL+ SHIFT+ Arrow Left/Right Collapses/Expands all phrase folders in the phrase tree.
Arrow Up/Down Moves the selection cursor to the previous/next item in the phrase tree.
CTRL+ SHIFT+ Arrow Up/Down Jump to the first/last item in the phrase tree.
SHIFT+ Arrow Up/Down Extends the current selection to the previous/next element.
Page Up/Down Jumps to the first/last currently visible item of the current phrase folder level.
SHIFT+ Page Up/Down Extends the current selection to all currently visible previous/next elements of the current phrase folder level.
CTRL+ Page Up/Down Shifts the current tree view within the viewport to the top/bottom currently visible item.
Home/ End Jumps to the first/last item of the current phrase folder level.
CTRL+ Home/End Jumps to the very first/last item of your entire phrase library.

PhraseExpress hotkeys are temporarily disabled when the cursor is placed in the hotkey input field to allow you to enter/use above hotkeys for your phrases/folders.

When editing the phrase contents, a selection of other hotkeys are available to quickly insert macro function.

File locations

In portable mode, all PhraseExpress related files are stored in the program directory on the portable storage device. No file is written onto the host PC.

In a regular computer installation, PhraseExpress stores files in following locations:

FilePurposeLocation

phrases.pxp

The phrase file keeps all your text snippets including the phrase folder structure, folder access permission information, Autotext and hotkey definitions.

If you want to move your phrases to another computer, copy this file to the new computer.

Backup this file frequently to an external storage media to prevent data loss of your personal phrases!

User documents folder: C:\Users\[Your user name]\Documents\PhraseExpress\

In PhraseExpress v12 and earlier, the phrase file was stored in the common user folder instead: C:\Users\Public\Documents\PhraseExpress\

The file path may be different if you have loaded another phrase file.

If running PhraseExpress from a USB drive, the phrase file must be located in any directory on that USB drive.

clipboard.pxp, lastused.pxp, autolearn.pxp

Stores the dynamically generated contents of the special phrase folders used for the clipboard cache, last used phrases and Autocomplete feature.

User data folder: C:\Users\UserName\Documents\PhraseExpress\

pexdesktop.xml

Contains desktop menu sizes and coordinate information.

If using a SQL server, desktop menu information is saved in the SQL database for each user instead.

customdic_en_USCustom spelling corrections added to the internal spelling checker.

words.pal

This file contains the Autocomplete dictionary and must not be edited.

It does not contain human-readable information but only word lists and information about links between words.

If using the Autocomplete feature, backup this file frequently to an external storage media to prevent loss of your text predictions!

config.xml

Contains program settings. It can be edited by experienced IT administrators.

User Application data folder: C:\Users\UserName\AppData\Roaming\PhraseExpress\

  • The installation file copies a default configuration file into the Common User Application data folder: C:\ProgramData\PhraseExpress\
    If PhraseExpress is launched for the first time from a new user account, it will copy this common configuration file into the User Application data folder.

network.pxp

If you are using the PhraseExpress Server and if the network connection is interrupted, PhraseExpress uses this dynamically generated temporary copy of the latest version of the network phrase file as a cache while you are not connected to the Server.

Command line parameters

The installation file and the program itself support a variety of command-line parameters.

Program file

Advanced users can launch the PhraseExpress program file with command-line parameter to activate additional functions:

Command line parameterExplanation

-DEBUG

Creates a debug file into a folder on the Windows desktop. This file is useful for our tech support for trouble-shooting purposes.

Do not use this command-line parameter as a default as PhraseExpress will slow down over time as the debug file can become very large and PhraseExpress may behave erratic while trying to handle the large file.

-CONFIGFILE=file path

Launches PhraseExpress with a custom configuration file.

Example: PhraseExpress.exe -configfile=c:/data/myconfig.xml

When closing PhraseExpress, the program will save the configuration to the default position (User Application data folder, e.g. \Users\John Doe\AppData\Roaming\ PhraseExpress\config.xml).

-READONLY

The phrase file will be treated as if the read-only file attribute would be set. Consequently, you cannot create or alter phrases.

-NOSETTINGS

Menu commands to change settings are hidden from the user interface.

-NOEXIT

The menu item "Exit PhraseExpress" is hidden from the tray icon popup.

-PORTABLE

Forces PhraseExpress to launch in the USB mode even if the program is not launched from a USB memory stick. Please find more information in the chapter "PhraseExpress on USB flash drives".

-EXPORTFILE= "AUTOTEXT| FILEPATH|TIMESTAMP"

Exports the phrase folder, specified by its AUTOTEXT into the phrase file, specified by FILEPATH. Optional parameter TIMESTAMP appends a time stamp to the file name. Parameters are separate by pipe chars (vertical dash).

Example: PhraseExpress.exe -exportfile= "##MyFolderAutotext|d:\MyDirectory\MyFileName.pxp| timestamp"

This command-line parameter is useful to automate backups of specific phrase folders.

-LICENSE="YourLicenseKey"

Allows to automate the license key registration on stand-alone installations. Do not use if using a PhraseExpress/SQL server!

Make sure to use individual license keys for each installation. We can replace multiple license keys (25+) with a single license key (valid for the equivalent number of installations) on request.

Do not use this command-line parameter if using a PhraseExpress or SQL server. In this case, license keys are centrally registered with the (SQL) Client Manager.

The license registration requires access to our authorization server (privacy policy).

Installation file

Following command-line parameter can be used with the standard PhraseExpress installation file (not the MSI installer and not the program file):

Command-line parameterDescription
/SILENT, /VERYSILENT, /SUPPRESSMSGBOXESInstructs Setup to be silent or very silent. When Setup is silent the wizard and the background window are not displayed but the installation progress window is. When a setup is very silent this installation progress window is not displayed. Everything else is normal so for example error messages during installation are displayed.
/LICENSE=XXXX

Passes the license key to the Stand-Alone installation and automatically registers the license online. Use individual licenses key for each installation. We replace multiple license keys (25+) with a single license key (valid for the equivalent number of installations) on request.

Do NOT use following command-line parameter if using a PhraseExpress or SQL server as license keys are centrally configured in the PhraseExpress Client Manager.

The license registration requires access to our authorization server (privacy policy).

/ForceOL32

/ForceOL64

Enforces specific bitness of the Microsoft Outlook Add-In (32 or 64-bit).

Use this command-line parameter if the Outlook Add-In does not work (in rare cases, Outlook does not seem to state the installation 32/64 version into the Windows registry)

Regular expressions

RegEx Examples:
Desired InputRegular Expression
Text of specific length (2-5 chars):[\s\w\d]{2,5}
Number of speficic min and max value (1-99):^([1-9]|[1-9][0-9])$
Hexadecimal values:[0-9A-F]
Hexadecimal values of specific length (6 chars):[0-9A-F]{6}

Perl RegEx documentation and additional examples

Input validation

PhraseExpress can perform a syntax check on user input to prevent errors:

Input validation

If syntax check is enabled, an input is required.

Syntax check options:
OptionDescription/Example
No validationNo check is made. Even no input is allowed.
Input requiredAn input of any kind must be made. No input is not accepted.
E-Mailmatt@trace.com
URLhttps://www.phraseexpress.com
File pathc:/folder/file.txt
Folder path/folder/anotherfolder/
lettersa-z, A-Z
Numbers0-9, dot and comma
Texta-z, A-Z and punctuation marks
Custom (RegEx)Regular expression (more info)

System folders

The content of system phrase folders is managed exclusively by PhraseExpress. You must not add/edit contents in such folders.

System phrase folders are "volatile" and content may be overwritten by newer content, or – depending on the configuration – deleted when PhraseExpress is closed.

You can copy useful content from system phrase folders to your own phrase library if required.

To configure system phrase folders, highlight the desired system folder in the phrase tree view of the main program window and change its settings on the right side of the main program window.

Table of Contents


    Table of Contents