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:
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 "" in the context menu to change state.
Another user is editing this element. Press F5 to update the status.
PhraseExpress has different states that are indicated by its tray icon:
PhraseExpress is running and ready to use.
PhraseExpress is executing a phrase or a macro automation.
PhraseExpress is busy loading or saving the phrase file/database.
The target application is not suitable to accept text input. Hover or right-click the tray icon for more info. In most cases, the current application has been launched with different user credentials than PhraseExpress. IN this case, right-click the tray icon and select the option to restart PhraseExpress with admin rights.
PhraseExpress is excluded from the current target app.
|PhraseExpress is currently using a non-editable locally cached phrase file/database for offline use.|
Hotkeys, Autotext and the Autocomplete feature are temporarily disabled.
Something is wrong. Hover or right-click the tray icon for more info. Most likely, the phrase file is missing or damaged.
PhraseExpress uses following hotkeys in the main program window:
|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-key||Deletes the currently selected item|
|ESC||Minimizes the main program window.|
|F1 -key||Opens this documentation|
|F3||Sets input focus into the QuickSearch box|
|F5-key||Reloads the currently selected phrase file. This is also useful to check the current file status (online/offline, write protections, etc.).|
|SHIFT+F5||Reloads 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.
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:
This database file keeps all your text snippets including triggers, folder structure and folder access permission information.
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 application data folder: %APPDATA%\PhraseExpress\
In PhraseExpress v13-15 and earlier, the phrase file was stored in the user documents folder: %USERPROFILE%\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.pexdb, lastused.pexdb, autolearn.pexdb
Stores the dynamically generated contents of the special phrase folders used for the clipboard cache, last used phrases and Autocomplete feature.
User application data folder: %APPDATA%\PhraseExpress\
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_US||Custom spelling corrections added to the internal spelling checker.|
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!
Contains program settings. It can be edited by experienced IT administrators.
User Application data folder: %APPDATA%\PhraseExpress\
The "peer-to-peer" phrase file sharing feature users following files:
|filename.pexdbhub||Copy of the database that is downloaded by new users joining the shared phrase file.|
|filename_7823DD-4234(..).pexdbupd||Database patch files that contain individual changes to be processed by all users.|
|filename_users.db||List of users that have joined sharing the phrase file.|
"filename" is a placeholder for the actual sync folder name.
Command line parameters
The installation file and the program itself support a variety of command-line parameters.
Advanced users can launch the PhraseExpress program file with command-line parameter to activate additional functions:
|Command line parameter||Explanation|
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.
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).
The phrase file will be treated as if the read-only file attribute would be set. Consequently, you cannot create or alter phrases.
Menu commands to change settings are hidden from the user interface.
The menu item "Exit PhraseExpress" is hidden from the tray icon popup.
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.
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.
|-CERTCHECK||Verifies the integrity of the PhraseExpress program files on program launch to check if the files have been tampered with.|
Following command-line parameter can be used with the standard PhraseExpress installation file (not the MSI installer and not the program file):
|/SILENT, /VERYSILENT, /SUPPRESSMSGBOXES||Instructs 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.|
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.
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)
PhraseExpress uses the installation file tool "Inno Setup" which support additional command-line parameters. We kindly ask for your understanding, that we do not provide technical support for these command-line parameters).
PhraseExpress can perform a syntax check on user input to prevent errors:
If syntax check is enabled, an input is required.
Syntax check options:
|No validation||No check is made. Even no input is allowed.|
|Input required||An input of any kind must be made. No input is not accepted.|
|Numbers||0-9, dot and comma|
|Text||a-z, A-Z and punctuation marks|
|Custom (RegEx)||Regular expression (more info)|
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.