Table of Contents

Document conventions

What PhraseExpress can do for you

System requirements

Upgrade from previous versions

Software Installation

First steps with PhraseExpress

How do I ...

…store a new text phrase?

…paste a phrase into a document?

…use Hotkeys?

…use Autotext?

…edit text phrases?

…find a certain text phrase?

…set phrases as private?

…import/export text phrases?

…use PhraseExpress in a network?

Macro functions

Introduction to macro functions

How do I…

…add the current date to a phrase?

…call a phrase within another phrase?

…add a counter variable into a phrase?

…add manual text input to a phrase?

…add a Windows environment variable into a phrase?

…add a random number into a phrase?

…create an email from a phrase?

…launch an application from a phrase?

…open a file from a phrase?

…open a webpage from a phrase?

…add a special key into a phrase?

…add a special character into a phrase?

…repeat a certain action multiple times?

…change the focus to a certain application?

…paste/copy from/to the Windows clipboard?

Miscellaneous

Program states

Hotkeys used in PhraseExpress

Program settings

Registering the Pro Edition

General hints

Time savings calculation

Changing the phrase file location

Data backup

Keeping PhraseExpress up-to-date

Uninstallation

Background information

Technical Support

Troubleshooter

Problems with Autotext or hotkeys?


Document Conventions

  • Bold, italic type in this documentation indicate either a procedure or menu items
  • Filenames are printed in italic letters
  • Text input is represented in courier script
  • All PhraseExpress settings are made from the task-bar icon. To open the program menu "right-click" the Icon icon and select Settings from the pop-up menu

This symbol indicates a useful hint

This symbol indicates very important notes and should be carefully read

 

Please find the first important information:

Certain program menu items to change settings or adding/modifying may be removed from the PhraseExpress menu to avoid operating errors or accidental phrase deletion. Please contact your system administrator in case of questions

What PhraseExpress can do for you

PhraseExpress saves you from typing common phrases over and over again. The program organizes your frequently text phrases and allows pasting them into any application in a snap.

General benefits

  • Productivity benefits as you need to type less.
  • Less typing reduces the chance of making typos.
  • Friendlier and more thorough communication without additional work.
  • Built in spelling correction additionally helps to avoid mistakes.
  • Consistent communication troughout an organization by using common text templates.
  • Helps to prevent the RSI syndrome.

Special PhraseExpress benefits

  • Many shortcuts and hotkeys are difficult to remember. PhraseExpress rather allows to assign multiple phrases to a single hotkey or Autotext. In such case, you can select the desired phrase from a popup menu right next to your cursor.
  • The Network Edition includes a fully-featured Client-Server system to manage a central phrase file. Users can have personal and shared phrases (more info).
  • MS Word AutoCorrect and Autotext entries can be imported into PhraseExpress and then used in any application (more info).

System requirements

  • MS Windows 98 (or later)
  • Web browser to read the documentation
  • Optionally Internet access to retrieve software updates
  • Approximately 4 MB hard disk space for the program files

Upgrade from previous versions

Important note

Backup your current phrase file before upgrading. any previous version cannot read/import the new phrase file format.

Upgrade from version 3

Just install the new version over the existing v3 installation. PhraseExpress v4 will automatically use and convert the previous phrase file to the new format.

Upgrade from version 2

Version 2 phrase files have the extension .dta and are usually located in the PhraseExpress program folder (c:/program files/phraseexpress/myphrases.dta)

You can use old phrase files in the new version. Please refer to chapter "Import/Export phrases". We recommend to uninstall v2 first.

Software installation

PhraseExpress is being installed like any other usual Windows software - Just launch the installation program and follow the on-screen instructions.

Program Installation video tutorial

Conflict with MS Office

The PhraseExpress Autotext feature will interfere with the MS Office AutoCorrect functionality as both programs are triggered by your text input. You would recognize, that abbreviations are expendanded twice.

We strongly suggest to import the MS Word AutoCorrect entries into PhraseExpress and to disable the function in Word (see Microsoft help).

Installation variations

If you have administrator rights when installing PhraseExpress, you can define precisely how PhraseExpress can be used by multiple users of this computer:

  • Installation solely for the current user. Any other user on this computer cannot see PhraseExpress
  • Installation for all users on this computer. This variation comes in two flavours:
    • Each user has individual settings and uses an individual phrase file.
    • All users use the same phrase file and always adapts the settings as defined by the administrator.

If you rather wish to use a central phrase file by multiple computers in a network, you would need to install the separate PhraseExpress Server of the Network Edition. Make sure to activate the network option during the installation procedure and allow PhraseExpress accessing the network when a firewall dialog pops up.

Command line parameters useful for remote installations are explained here

Important privacy information

PhraseExpress is designed to react on your keyboard input. This may sound obvious but unfortunately, Antispyware utilities may misinterprete PhraseExpress as being a Keylogger or spyware.

Such security software often do not distinguish between harmless and potentially dangerous programs as they are triggered by any application which processes keyboard input.

You can safely use PhraseExpress. PhraseExpress never sends any personal information over the internet.

When and why does PhraseExpress access the internet?

  • PhraseExpress accesses the local network only if the networking functionality is enabled in the PhraseExpress settings. In such case, PhraseExpress searches the PhraseExpress Server in intervals on the local network. This may trigger your firewall, but it is really only local (firewalls sometimes are not able to distinguish between local and remote network access).
  • PhraseExpress accesses the internet only if the option to automatically check for software updates is enabled. In such case, only the version number of the current installation and parts of the license key (if any is available) is transmitted.

You can both options in the PhraseExpress settings. However, we strongly recommend to keep letting PhraseExpress check for updates as we continuosly improve the program an add new features.

First steps with PhraseExpress

After launching PhraseExpress the program icon appears in the lower right of the Windows system tray:

Startleistensymbol

From now on, PhraseExpress will save you from typing same phrases again and over again...

First Steps video tutorial

How to store a new text phrase

If you are typing something and you feel that you would need such phrase later again, you can store the text in PhraseExpress:

  1. Highlight the desired text or bitmap
  2. Click the PhraseExpress system tray icon Icon and select Create new phrase (or the hotkey WIN-v)
  3. A dialog window optionally shows up which allows you to enter additional information for the phrase you have just stored:
    Phrasendetails
    • The Description represents the phrase in the PhraseExpress pop-up menu. By default, PhraseExpress uses the first 64 characters of your phrase.
    • The optional hotkey allows you to paste the phrase by just pressing the keyboard combination you define here. Further information can be found in chapter "Using hotkeys".
    • Whenever you type what you define as the Autotext it will be replaced with the Phrase you have created (Also see chapter "Using Autotext").
    • If the text is formatted, you can select whether you would like to include such formatting or whether you only want to store the plain text information (which significantly reduces the data size). Please note that html formatting is not stored as the output would vary anyway depending on the stylesheet of the target application.

Do not worry if you are not sure what to type in the above dialog. The information can be edited later at any time. You can also disable this dialog by ticking Do not show again if you generally want to edit above information later in the PhraseExpress.

The phrase text is stored after confirming with OK.

How to paste a phrase into an application?

  1. Place the cursor in the target application where you would like to paste the text phrase
  2. Click the PhraseExpress system tray icon Icon and select the desired phrase from the pop-up menu
  3. Once you release the mouse button, the phrase will be pasted

You can also trigger a text phrase by following methods:

  • Press the hotkey which you may have assigned for the desired text phrase or phrase folder (refer to chapter "Using hotkeys")
  • Type the letter sequence which matches the Autotext you have defined for the desired phrase (see chapter "Using Autotext")

Phrase selection popup

If you enter an Autotext or hotkey which is defined for a phrase folder or used by multiple phrases, a popup window appears next to the mouse cursor, allowing you to select the desired phrase with following methods::

  • Select the desired phrase with the mouse cursor.
  • Or use the up/down arrow keys navigate through the phrases.
  • When striking the arrow-right key, PhraseExpress jumps to the first subfolder (if any) of the popup menu. You can minimize the subfolder using the arrow-left key.
  • If entering any letter key, PhraseExpress jumps to the phrase beginning with the letter and cycles through them if you strike the letter multiple times.

The selected phrase is being pasted into the target application with the ENTER key.

You can cancel the paste procedure or phrase selection by hitting the ESC key.

Make sure that the hotkey and/or Autotext feature is activated for the folder containing the desired phrase.

You can display the Autotext definitions together with the phrase description in [] brackets, if you enable the option Show Autotext in popup in the PhraseExpress Settings

If the option Show phrase preview in popup is enabled, a short preview of the phrase contents is shown if you hover over a phrase description and wait for a short time. The preview is only shown, if the phrase content differs from the phrase description.

How do I use hotkeys?

A hotkey (or shortcut key, keyboard shortcut, key combo, etc.) is a set of keys associated to a certain phrase or folder.

Example: Hold down the ALT and/or SHIFT and/or CTRL key and then press and release a single other regular key, and finally release the CTRL/ALT/SHIFT key(s). This distinction is important, as trying to press all the keys simultaneously will frequently either miss some of the keys, or cause unwanted auto-repeat.

  • Pressing a hotkey defined for a phrase, invokes PhraseExpress to paste the phrase text contents at the current cursor's position
  • If you enter a hotkey defined for a folder, a popup-menu opens near the cursor where you can choose the desired phrase using the mouse or the up/down arrow keys of your keyboard (more information)

You can define the same hotkey for multiple phrases and/or folders. When striking this hotkey, PhraseExpress would open a phrase selection popup next to your cursor and offer all items with the assigned hotkey (more information).

You can temporarily disable the hotkey (and Autotext) feature by clicking the PhraseExpress program icon in the system tray while pressing the CTRL-key. The exclamation mark icon turns to grey to indicate that the hotkey/Autotext feature is disabled. Click on the PhraseExpress icon with the CTRL-key again to re-activate hotkeys/Autotext (not supported in Windows 98).

Hotkeys defined in PhraseExpress can conflict with hotkeys used by other programs. Avoid frequently used hotkeys and try using combinations with the SHIFT/CTRL/ALT-key and a letter. A few hotkeys are firmly occupied by Windows (see list) and cannot be assigned in PhraseExpress. To isolate conflicts, close all other programs running on your computer and try the hotkey in Notepad. Then launch your other software programs while keep trying the hotkey. When the conflict arise you know which program interferes

The hotkey feature must be enabled for the folder containing the phrase

Hotkeys are temporarily disabled while the PhraseExpress settings window is open

You can display the hotkey definitions together with the phrase description in () brackets, if you enable the option Show hotkeys in popup in the PhraseExpress Settings

How do I use Autotext ?

Autotext is a feature similar to MS Office's 'AutoCorrect' feature. It automatically replaces trigger phrases (the Autotext) with text phrases defined for the trigger phrase while you type:

Autotext example

Sample applications :

  • Abbreviations such as 'FBI' will be automatically expanded to 'Federal Bureau of Investigation'
  • Typing mistakes are corrected while you are typing: 'tpyo' -> 'typo'
  • You can trigger even a complete letter sentences by just entering a few letters - Typing the short phrase 'offerA34' can paste a complete sales letter into any desired target application

We strongly recommend to disable the Microsoft Office AutoCorrect function or delete Autocorrection phrases in MS Office which you also use in PhraseExpress to avoid interference between both functions

If the Autotext feature does not work as expected, please try our troubleshooter

Configure Autotext

PhraseExpress continuosly listen what you type and scans whether your keyboard input matches any Autotext you have defined. Whenever your input matches any Autotext, the program replaces the Autotext with the corresponding text phrase.

You can define whether Autotext shall be recognized only as full/separate words, within a word or at the beginning or end of a word:

Autotext option Explaination Notes

An autotext such as 'eth' is only being recognized when entered as a separate word. It is ignored in 'Ethan', within 'methane' and in the end of the word 'Beth'.

This is the default setting and recommended for most purposes.
The autotext example 'eth' is recognized everywhere, e.g. in 'Ethan', within 'methane' and in the end of the word 'Beth'. This option is suitable e.g. to correct mixed letters at any position of a word. Use with care as such Autotext may be recognized inadvertently.
The autotext example 'eth' is only recognized in the beginning of a word such as 'Ethan' but ignored within 'methane' or 'Beth'. This option is suitable e.g. to correct mixed letters at the beginning of a word.
The autotext example 'eth' is only recognized in the end of a word such as 'Beth' but ignored within 'methane' or in the beginning of 'Ethan'.
This option is suitable e.g. to correct mixed letters at the end of a word.

The phrase is being inserted exactly after you type any delimiter character, such as a space, comma, period, semicolon or the Enter key. The delimiter character will not be removed following the pasted phrase, except if the Autotext itself contains a delimiter.

Examples:

Autotext Phrase contents Keyboard input Pasted text
st sample phrase st. sample phrase.
st sample phrase st; sample phrase;
st sample phrase; st. sample phrase;.
st; sample phrase st; sample phrase
st; sample phrase; st; sample phrase;
st; sample phrase; st. st.

Automatic CAPS detection

If the first letter of a phrase content is not a caps letter, PhraseExpress automatically set the first letter of your phrase in caps automatically, if you type the first letter of the Autotext in caps letter.

Autotext Phrase contents Keyboard input Pasted text
max maximum max maximum
max maximum Max Maximum
max Maximum max Maximum
max Maximum Max Maximum

How do I edit text phrases?

Click the PhraseExpress system tray icon Icon and select the menu item Settings::

Properties

If the menu item is missing, please contact your system administrator, who may have disabled the option to avoid operating errors

 

The Edit phrases tab of the PhraseExpress settings window opens:

Click to magnify

If the Edit phrases tab is missing, the phrase file is either read-only, currently being edited by another user if using the Network Edition or the administrator has not granted edit rights. In this case, you may consult your system administrator.

The left-hand tree view allows you to overview and manage your phrases and organize them in folders. You can create or delete phrases and folders and re-arrange their order. If a hotkey is assigned for an item it is displayed in brackets after the object's description.

To edit a phrase or folder object, select it by clicking with the left mouse button on the desired object.

You can select multiple objects at once when you press and hold CTRL and/or SHIFT while selecting the desired objects

You can move objects by clicking the up/down buttons or with drag&drop.

When clicking on a single object with the right mouse-button a pop-up menu with options to duplicate move or delete the selected object. Individual folders can also be imported/exported.

  • Description: The description represents the actual text phrase in the phrase pop-up window. By default, the first 64 characters of the text phrases are used.
  • Phrase contents:: The phrase text can contain up to approx. 64.000 characters. If you you leave it empty, PhraseExpress takes the description as the phrase contents. Macro functions can be typed manually or entered with assistance when clicking the Add Macro button. Long text phrases can be wrapped inside the input field by right-clicking into the input field and enabling the option word-wrap.
  • Hotkey for this Phrase: You can instantly paste a text phrase or open a folder by pressing the hotkey you define here (e.g. CTRL-SHIFT-A). Please learn more in chapter 'Using hotkeys'
  • Whenever you type a sequence matching the specified Autotext, your input will be replaced with the text phrase. Please find more information in chapter 'Using Autotext'

How do I find a certain text phrase?

PhraseExpress offers two options to find a certain phrase, Autotext or hotkey:

QuickSearch

Open PhraseExpress, change to the Edit phrases tab and click the magnifying glass button below the tree view and define for what you are looking for. A query input field will open below the phrase tree after selecting at least one search option.

PhraseExpress will jump to the first match after you start typing the query string. If multiple hits are found then you can jump by hitting ENTER or pressing the Next button to the next finding.

You can jump back to any previous finding by entering CTRL-ENTER or pressing the Next-button together with the CTRL-key

By disabling all search options, you can hide the QuickSearch input field to save space

You can also select whether you would like to see the search result within the phrase tree structure or as flat list. When hovering over a phrase in the list, the full path within the phrase tree is shown

Find & Replace

If you would rather like to find a phrase within a certain folder (including sub-folders) or if you want to replace a string with another, right-click the desired phrase folder from the phrase tree view and select Find & Replace from the context popup menu.

How do I set phrases as private?

If you are using the PhraseExpress Network Edition you might want to have phrases which are exclusively visible to you. To mark phrases as personal, open PhraseExpress and right-click the desired phrase folder from the phrase tree view and select the option Private from the context popup menu.

Once the Private option appears as ticked in this menu, only you can see the folder, the phrases and any subfolder. You are being identified by PhraseExpress by your computer login name. This means that if you log onto a different PC in the network, you can see your private phrases there as well.

Your private phrases are still stored on the central Server PC but there are only transmitted to your PC.

Note, that the original owner/creator of the folder can always see the folder and its contents.

How can I import/export text phrases?

The powerful import/export-feature allows you to export any phrase file folder as as a independingly usable phrase file. You can also merge multiple phrase files by importing them into PhraseExpress.

Importing a phrase file

Click the PhraseExpress system tray icon icon and select Settings from the pop-up menu. Right-click on the folder where you want to import the phrases and select Import from the pop-up menu

Phrasen importieren

In the following dialog please select the file format of the file to be imported and point to the location.

You can alternatively right-click the desired phrase file directly and select Import from the context menu. PhraseExpress will import the phrase file into the root path and offers to organize your phrases.

You can import phrases from previous PhraseExpress v2 if you set file format to the 'All files'. Macros and special characters are not converted though and must be manually adjusted to the new macro syntax .

Importing Microsoft Word AutoCorrect/Autotext entries

You can also import your existing MS Office AutoCorrect and Autotext entries into PhraseExpress. Any doublettes with other misspelling entries in the current phrase file will be removed from the imported items and PhraseExpress offers to disable the AutoCorrect function in MS Word. This is strongly recommended to avoid double triggering. If you use the Network Edition, the imported folder will be set private as personal AutoCorrect are most likely used personally and not be shared with all other users.

AutoText entries of the new Microsoft Office 2007 may not fully work yet.

Exporting phrases

Right-click the desired folders which includes the phrases you would like to export, select Export from the pop-up menu and then define the phrase file target directory.

The exported XML phrase can be independently used in PhraseExpress.

Phrases can not be exported to the old v2 or v3 format.

Phrases are always exported with data encryption to maintain data security.

How do I use PhraseExpress in a network?

If you wish to use a central phrase file by multiple computers in a network, you would need to install the separate PhraseExpress Server of the Network Edition which provides following features:

  • Prevents version conflicts which may occur if multiple users are trying to change phrases simutaneously
  • Centrally manage read/write access rights to the central phrase file for each user
  • Control whether indivdiuals user may locally change PhraseExpress settings
  • Central update check of the version numbers of all software installations
  • Central registration and validation of the license keys

Important

If using the Network Edition, make sure to have the network function enabled in the PhraseExpress settings of the local installation.

Please find further information in the manual of the Network Edition.

Macro functions

PhraseExpress offers powerful macro functions to add dynamic text to your phrases (e.g. adding the current date, time or counting variables, etc), to launch applications, documents or to open programs:

Macro name Purpose
{#date} / {#time} / {#datetime ..} adds the current date or time in a phrase
{#insert ..} pastes a text phrase from another phrase
{#var ..} adds a increasing/decreasing variable
{#input ..} opens a text input window to allow manually adding additional text to a phrase
{#env ..} pastes a Windows environment variable
{#asc ..} pastes a special character
{#rnd ..} pastes a random value
{#email ..} creates a email message with filled recipient address, subject and message body
{#run ..} launches an application
{#open ..} opens a file
{#url ..} opens a web page
{#focus ..} changes the focus to a running application
{#sleep ..} inserts a delay before continuing to paste a phrase
{#simkey ..} Simulates entering a special key
{#loop ..} Repeat function
{#clipboard ..} Copy/Pastes the current clipboard

Click on a macro function name above to learn more about it in the corresponding manual chapter.

Macro functions can be added to a phrase text as usual text in the input field Phrase contents or by clicking the Add Macro button. When using the phrase later, PhraseExpress will replace the macros with the desired dynamic content.

Example of a phrase containing macro functions:

Today is {#date}. The time now is {#time}.

You can also nest macros into each other to fulfill powerful and flexible tasks.

Example of a nested macro function:

{#rnd {#input Max value?}}

This macro opens a text input box and outputs a random number between zero and the value you have entered.

If a macro function is not executed please carefully check for typos

Adding the current date to a Phrase

PhraseExpress includes macro commands to add dynamic contents to your text phrases.

General information about macro functions can be found in chapter "Using macros"

Create a a phrase and add the macro function {#date}, {#time} or {#datetime} at the desired position:

Today is {#date}. The current time is {#time}.

Whenever you use this text phrase the macro commands in {..} will be replaced with the current date and/or time:

Today is 03/12/2007. The current time is 10:34.

The output format of the date and time equals the regional settings as defined in MS Windows.

Formatting of the date and time

The powerful macro function {#datetime -f format -s shift} allows to select individual parts of a date or time and to change the order.

Replace format with the desired date/time units as listed below:

Examples Output
{#datetime -f mm/dd/yyyy hh:mm} 03/16/2007 10:47
{#datetime -f dd.mm.yy} 16.03.2007
{#datetime -f dddd dd.mm.yy} Thursday 16.03.07
{#datetime -f hh:mm am/pm} 10:47 am

 

Overview about the date/time parameters:
Unit Meaning
d Displays the day without a leading zero (1-31)
dd Displays the day including a leading zero (01-31)
ddd Displays the abbreviated weekday (Sun-Sat)
dddd Displays the weekday (Sunday-Saturday)
dddddd Displays the date in standard format
m Displays the month without a leading zero (1-12). If the following parameter is h or hh, then the minute is being displayed instead the month
mm Displays the month including a leading zero (1-12). If the following parameter is h or hh, then the minute is being displayed instead the month
mmm Displays the abbreviated month (Jan-Dec)
mmmm Displays the month (January-December)
yy Displays the year with two digits (00-99)
yyyy Displays the year with four digits (0000-9999)
h Displays the hour including a leading zero (0-23)
hh Displays the hour including a leading zero (00-23)
n Displays the minute without a leading zero (0-59)
nn Displays the minute including a leading zero (00-59)
s Displays the second without a leading zero (0-59)
ss Displays the second including a leading zero (00-59)
tt Displays the time in the format as defined in the global variable LongDateFormat
am/pm Displays the 12-hour time prefix am or pm

Time shift

You can also shift the current date and time output by using the optional parameter -s shift

Replace shift with the positive/negative amount of shift and directly after the amount add which date/time unit should be shifted:

Date/time shift examples Output
{#datetime} 03/16/2007 10:47
{#datetime -s 1d} 03/17/2007 10:47
{#datetime -s -2h} 03/16/2007 08:47
{#datetime -f mm/yyyy -s 5y} 03/2012

Number of days/weeks passed of the current year

{#datetime -d} outputs the number of the days passed of the current year.

{#datetime -w} outputs the number of weeks passed of the current year.

Calling a phrase out of another phrase

A very powerful function is the ability to nest phrases by calling phrases out of another phrase.

This is useful e.g. when creating a email signature which is used by multiple other phrases.

To do that, place the macro function {#insert Autotext} where you would like to have the other phrase which is defined by its Autotext.

Let's assume, you have created this text phrase:

Hello,

thank you for your offer. We will reply to you as soon as possible.

{#insert footer_jon}

At the end of above phrase you can see that it calls another phrase with the Autotext footer_jon and following contents:

Kind regards,
Jon Donson

The rendered text phrase from above would look like this when being pasted:

Hello,

thank you for your offer. We will reply to you as soon as possible.

Kind regards,
Jon Donson

You can also use an autotext for a phrase folder. In such case, the corresponding phrase folder would popup a the present cursor's location and you can select the desired phrase.

When using the optional parameter -random, PhraseExpress would paste a random phrase from within the corresponding folder. Example: {#insert Autotext -random}

You can also drag&drop phrases from the phrase tree directly into the phrase contents field of the phrase you are currently editing. PhraseExpress will create the macro command at the position where you drop the phrase for you. If the inserted phrase does not yet have the required Autotext, then PhraseExpress creates one for you based on the description leading with '##'.

Benefits of using nested phrases

  • They work like a template system. Footer text changes automatically take effect on all phrase which are referencing to it and you do not need to enter all phrases individually. This is nice, if e.g. only the phone number in a footer needs to be updated or if you would like to add a temporary special offer advertisement to your footer
  • You save storage space as you only need to add the reference to the nested phrase instead of typing its content into each individual phrase

We strongly recommend to start using nested phrases as they are really useful and you surely do not want to miss them once you get used to it.

Adding a counter variable in a phrase

PhraseExpress allows you to create an unlimited amount of counter variables with custom start value and incrementor/decrementor.

Creating a variable

Variables are handled just like usual phrases. Open the Settings and right-click the location in the tree view where you would like to create the variable and select New variable from the pop-up menu:

Neue Variable

Alternatively, create a new standard phrase and enter a number as the description. PhraseExpress will then ask you whether the phrase shall be converted into a variable.

On the right window pane you need to define a description, the start value, optionally an incrementor/decrementor and - most important- the variable name (which is also interpreted as the Autotext).

If you do not enter a variable name, PhraseExpress will take the description as the variable name

If you set the incrementor to zero, the variable keeps the static value

You can now paste the variable as a value into any application.

The practical use is however to use a variable inside another phrase using the macro function {#var ..} where it could be used as an order number:

Hello,

your order has the order number {#var ordernr}. Thank you for your purchase.

Kind regards,
Ben Dover

Each time you use this phrase, the current variable value would be inserted and increased/decreased as specified for this variable.

Adding a manual text input into a phrase

The macro function {#input -head windowtitle} allows you to enter additional text which will be inserted in the phrase at the position where this macro is positioned.

Example:

Dear {#input -head Recipient's name?}!

Thank you for your email. We will reply as soon as possible.

Best regards,
Marc A. Roni

Whenever you call this phrase, PhraseExpress opens below dialog window with the window title as specified in the macro function ("Recipient's name?" in this example) and allows you to enter additional text before the phrase is actually pasted:

Eingabefeld

After clicking OK (or hitting CTRL-ENTER), the entered text will replace the macro function in the phrase and the output would look like:

Dear Frank Harris!

Thank you for your email. We will reply as soon as possible.

Best regards,
Marc A. Roni

Additional parameters for {#input}

  • The parameter -single opens a single line input field.The advandtage is that you can finish you input with ENTER (rather than using the compbination CTRL-ENTER). Example: {#input -head MyInput -single}
  • The parameter -def allows to define a preset input text (which of course can be changed by the user). Example: {#input -head MyInput -def AnyDefaultText}

If you need the text input at multiple positions within a phrase, just use the identical window title text for all macro functions and you only need to enter the input once and the input will be used for all instances.

Adding a Windows environment variable to a phrase

The macro function {#env %variable%}pastes the specified Windows environment variable.

Example:

The operating system is {#env %os%} and the user name is {#env %username%}

outputs:

The operating system is Windows_NT and the user name is Jon Donson

Adding a random value into a phrase

The macro function {#rnd maximum} pastes a random value between 0 and the specified maximum value.

Example:

This is a random value: {#rnd 100}

The output would be:

This is a random value: 23

Creating an email

The macro function {#email -to recipient -cc cc-recipients -bcc bcc-recipients -subject subject text -body body text} creates a new Email with your standard email client and fills the fields as specified.

Example:

{#email -to holly@would.net -subject News for you -body {#insert examplephrase}}

The macro will launch your default email client, fill the form of the new email and pastes the phrase with the Autotext examplephrase as the email body:

Dear Holly ,

please check your post mailbox at home.

Sincerely ,
Earl E. Bird

This is how the composed email would look like:

Email

When strange characters appear in the mail body, you seem to be using an email program with UTF-8 character encoding (e.g. Outlook 2007). In such case, please enable UTF-8 support in the PhraseExpress expert settings

Launching a program from a phrase

The macro function {#run"c:\path\application.exe" "-myparameter" "c:\myworkingdirectory"} launches the specified program.

Example:

{#run notepad.exe}

If the desired application not registered in Windows, you need to enter the full path to the program

Open a file from a phrase

The macro function {#open file} opens the specified file with the application which is associated to the file.

Example:

{#open d:\data\example.txt}

Open a web page from a phrase

The macro function {#url web page} opens the specified web page in your default internet browser.

Example:

{#url http://www.phraseexpress.com}

Adding special keys into a phrase

Special keys on your keyboard are being added as macro functions to your phrase:

Special key examples Output
{#ENTER} Simulates pressing the ENTER-key
{#SHIFT -chars abc} Outputs the characters 'abc' together while pressing and holding the SHIFT-key
{#SHIFT -chars {#ALT -chars abc}} Outputs the characters 'abc' together while pressing and holding the SHIFT- and ALT-key
{#DOWN -count 5} Simulates pressing the arrow down-key five times

Overview about the reserved keywords for all supported special keys:

CTRL, ALT, SHIFT, SPACE, BKSP, TAB, BREAK, DEL, LEFT, RIGHT, UP, DOWN, ENTER, ESC, STANDBY, NUMPAD0, NUMPAD1, NUMPAD2, NUMPAD3, NUMPAD4, NUMPAD5, NUMPAD6, NUMPAD7, NUMPAD8, NUMPAD9, MULTIPLY, ADD, SEPARATOR, SUBTRACT, DECIMAL, DIVIDE, F1, F2, F3, F4, F5, F6, F7, F8, F9, F10, F11, F12, F13, F14, F15, F16, INS, HOME, END, PGDN, PGUP, PRTSC, SCROLLLOCK, NUMLOCK, CAPSLOCK, LWIN, RWIN, NONE

Notes for certain special keys:

Special key Note
{#NONE} This is a place holder for special purposes. Example: {#NONE -chars{#ENTER}{#DOWN} -count 5} simulates pressing the ENTER- and arrow down-key five times
{#STANDBY} This macro simulates pressing the Sleep mode key

{#ADD}, {#MULTIPLY}, {#SEPARATOR}, {#SUBTRACT}, {#DIVIDE}9

 

These keywords represents the keys on the extended number block on the right pane of your keyboard

Adding a special character into a phrase

The macro function {#ASC character code} pastes the special character with the three-digit character code as you would use the ALT-key while entering the three-digit character code on the extended number block.

Example: The copyright-symbol © can be pasted by using the macro {#ASC 169}.

The MS Windows utility Charmap offers you an overview about the special characters including their code number.

Switching the focus to another application

The macro function {#FOCUS window title} changes the focus to the specified running Windows application based on its windows title (e.g. "calculator"). If the specified application is not running, the current focus remains to the active application.

Example:

{#FOCUS Calculator}

The above macro changes the focus to the calculator program (if it is running).

You can also use a wildcard * for the windows title

Adding a delay

{#SLEEP nnnn}

This function let PhraseExpress wait for specified amount of nnnn milliseconds. This is useful, if another application involved requires a certain time to be launched or a website to be loaded.

Loop function

{#LOOP -count x} repeats anything x-times what follows after 'LOOP'. Example:

{#LOOP Example{#ENTER} -count 3}

Das hier verwendete Beispiel gibt das Wort 'Beispiel' dreimal untereinander aus:

Example

Example

Example

Clipboard

{#CLIPBOARD -copy}

This macro copies the currently highlighted text into the Windows clipboard.

{#CLIPBOARD -paste}

This macro pastes the current Windows clipboard contents at the current cursor location within a phrase.

Program states

PhraseExpress has different states which are indicated by its task tray icon color:

Color Explanation

white - white

PhraseExpress is currently busy with loading/processing the phrase file. If using the Network Edition, the program searches for the PhraseExpress Server on the network.

grey - grey

PhraseExpress ist ready to use but hotkeys and the Autotext feature is temporarily disabled. You can toggle this state by clicking the icon while pressing the CTRL key.

red - red

PhraseExpress ist ready to use and uses the local phrase file.

green - green

PhraseExpress ist ready to use and is connected to the PhraseExpress Server of the Network Edition.

Hotkeys used in PhraseExpress

PhraseExpress temporarily uses a few hotkeys when the program window is open:

Hotkey Purpose
ALT-P Creates a new phrase at the current cursor's location in the tree view
ALT-O Creates a new folder at the current cursor's location in the tree view
CTRL-F Opens the QuickSearch popup
CTRL-H Opens the Find&Replace dialog
CTRL-D Duplicates the currently selected item in the tree view
Delete-Key Deletes the currently selected item
F1-key Opens this documentation
ALT-F4 Minimizes/exits PhraseExpress
Arrow keys Used for the navigation in the phrase tree

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.

Program settings

The PhraseExpress program settings can be accessed via the PhraseExpress system tray icon icon and selecting Settings from the pop-up menu:

If the menu item is missing, please contact your system administrator, who may have disabled the option to avoid operating errors

The several options in the settings dialog are actually self-describing and we would like to avoid redundant descriptions such as "The Option Activate Autotext activates Autotext". Most settings provide additional information if you hover over a program settings item.

Please just experiment with the settings. If you have any particular question, do not hesitate to contact us

Expert options

As the name may imply, the expert options are for those who would like to configure PhraseExpress in a sophisticated way. Normal users really do not do bother with them.

  • Leading- and Trialing delimiter are the delimiters which allow PhraseExpress recognizes the beginning and end of an Autotext. #0 would mean any character, #13 means the ENTER-key. If you use #0 for both delimiters, then input would be recognized at any position within a word. Use this setting with care as it overrides any Autotext folder setting.
  • If you prefer to have a fixed prefix for any Autotext then you can define it as an Global Autotext prefix. Example: When entering '#' here, you would need to type #kr to trigger the Autotext 'kr'. this setting is global for all phrases and folders.
  • If you have defined the same Autotext to multiple phrases then PhraseExpress opens a popup menu directly next to the mouse cursor. Automatically close popup menu after chars allows to define the amount of characters after the popup menu would automatically disappear again.
  • PhraseExpress internally uses two different methods to paste phrases into the target application:
    • Smaller text phrases are inserted by simulating individual key-strokes ("key-by-key").
    • Larger phraess are inserted by putting the contents into the Windows clipboard and pasting the clipboard contents into the target application. The pasting works fast but there is a little startup delay. The threshold when using this method can be changed with the setting Use clipboard paste method when phrase text exceeds x chars.
  • The paste speed of the key-by-key paste method can be reduced. You can additionally enable a random variation to simulate manual text input, e.g. for presentation purposes.
  • Show extended context menu allows accessing very powerful extra features in the phrase folder context menu. Please use such commands with extreme care as they permanently alter phrases. We suggest to duplicate the desired folder first and make a test run to evaluate the changes. Changes only apply to the correspondend folder. Subfolders are not affected.
  • If Check hotkeys for availability is deactivated, PhraseExpress accepts any hotkey, even if it is actually already occupied by another application or the system. You can even assign a single letter as a hotkey (which is really only suitable for very specific applications and not generally recommended).
  • If using an email client with UTF-8 character encoding, you may need to enable the corresponding option in PhraseExpress if you use the #mail macro in your phrases.

Registering the Pro Edition

If you are using PhraseExpress in a commercial/educational environment, you would need to purchase either a Pro Edition or Network license.

Video tutorial - How to enter the license key

You can easily turn your existing installation into a Pro Edition:

  1. Click the PhraseExpress system tray icon icon and select Register now for commercial use
  2. Purchase a PhraseExpress Pro (or Network) license from the webpage which has been opened by PhraseExpress.
  3. When the order has been processed, you will receive a delivery email including your personal license key.
  4. Copy this license key to the Windows clipboard and select Register now for commercial use in PhraseExpress again.
  5. The license key should appear in the input field and will be registered when you click the button Register.

After successful registration, the program title bar contains "PhraseExpress Pro" and you can now use PhraseExpress for commercial purposes.

If you use the PhraseExpress Network Edition, no license key input is required on the workstation installation. The PhraseExpress Server handles all license keys centrally.

General hints

Of course, we also use PhraseExpress since its first version in 2002 and collected a few hints to help you to get the maximum out of PhraseExpress:

  • Organize phrases in folders. Structure your phrases in folders with subjects reflecting the purpose or your tasks. E.g. create individual folders for English, German or French phrases, phrases used for different products. Another folder for your frequently used abbreviations, chat phrases, signatures, internet links, bank accounts, coding fragments, letter templates, etc.
  • Use nested phrases. PhraseExpress allows you to embed a phrase in another phrase. Create a phrase containing your signature only once and refer to it from all other email/letter templates where you use this signature (More info...)
  • Use hotkeys for folders rather than phrases. The amount of available hotkeys is pretty limited. It is also easier to memorize a few folder hotkeys which allow accessing multiple phrases easily, literally at your fingertip
  • Use Autotext extensively. They are just too useful to be ignored. Use them to extend abbreviations, to correct misspellings, to extend internet addresses, etc. If you type 'hp.' PhraseExpress can open a web browser and open 'http://www.mygreathomepage.com'. What a time saver!

Time savings calculation

Based on your individual typing skills and the amount of letters pasted by PhraseExpress, the daily time savings is calculated accurately.

You will quickly realize that PhraseExpress pays off after a few hours of using it. The program even tells you the money you have saved by using it.

To access the statistics, click the PhraseExpress program symbol icon -> Settings -> tab Statistics

In this section you can also enter your average typing speed (in keystrokes per minute) or let PhraseExpress do a quick typing skills test to determine an accurate value. This just takes less than a minute.

Overview about common typing rates

User Average typing speed
Beginner 20..60
Average user 60..240
Top class about 800

 

PhraseExpress assumes you need an average 5 seconds to select a phrase.

PhraseExpress informs you about your individual time savings every time you launch the program. This can be disabled in the Pro Edition only

Important note

Gathering information about computer user's performance may violate employee's privacy protection laws in your country. Make sure that it is legal to use such function or disable it

Changing the phrase file location

To check or change the phrase file location, click the PhraseExpress system tray icon icon -> Settings -> select the root of the phrase tree and click the Details buttons on the righ pane.

The initial phrase file location after installation depends on the user rights during the PhraseExpress installation:

  • If the option Install for all users on this PC has been enabled during the installation procedure, the phrase file is initially being stored in the Shared Documents folder (\Documents and Settings\All Users \Documents\PhraseExpress\phrases.pxp). All subsequent normal users access this common phrase file by default.
  • If a user installed with limited user rights, the phrase file is individually stored for each user in the corresponding user's personal data folder My Documents (\Documents and Settings\%Username%\Documents\PhraseExpress\phrases.pxp).
  • If you use the Network Edition, then you might find the IP address of the PhraseExpress Server as the phrase file location (e.g. 192.168.123.144:1026)

You can redefine the phrase file's location at any time, individually for each user if you have not enabled the option Common settings for all users during the installation. In this case, only the administrator can change the phrase file location.

If the option Always automatically use the network phrase file if Server is available is enabled, then PhraseExpress always switches automatically to the network phrase file as provided from the server service.

If you are using the Pro Edition and if the server connection gets lost, PhraseExpress automatically reverts to the local phrase file if any has been specified.

The phrase file must be local. The separate Network Edition allows accessing a phrase file over a network connection

If the selected phrase file has read-only access rights, PhraseExpress removes all menu options to create or edit phrases (as they could not be stored anyway)

If you want to share common phrases with multiple users on the same computer, make sure that all users have access rights to the desired phrase file location

The phrase contents, autotexts and descriptions are encrypted in the phrase file. The encryption is optimized for speed performance (rather than security). If you need additional encryption security, we recommend to store the PhraseExpress in an encrypted disk volume created by the 3rd party utility TrueCrypt.

Data backup

PhraseExpress automatically creates a backup of the phrase file each time you save changes to the phrase file. The backup file is located in the same folder as the main phrase file and has the file extension .bak. Changes to the phrase file are saved to the phrase file whenever you close the program or when you click the OK button in the setting window.

The Backup-file is a copy of the original phrase file before the changes are made.

If you would like to discard accidental changes to your phrase file of if the original phrase file cannot be read anymore, please do the following:

  1. Close PhraseExpress
  2. Delete the current phrase file with the file extension .pxp or move it to another folder
  3. Remove the file extension .bak of the backup file. It should then have the .pxp extension
  4. Launch PhraseExpress again and the backup file will now be used as the new main phrase file. A new backup file will automatically created when you save any changes to your phrase file

Important Note

Frequently backup your phrase file to a different storage media to eliminate the slightest risk to loose your data in case of hard disk failure. Hard disks can break - And they do when you do not expect it!

Keeping PhraseExpress up-to-date

We continuously improve PhraseExpress and you can keep the program up-to-date with the built-in internet update check.

To check manually for updates, connect your computer to the internet and click the PhraseExpress system tray icon icon ->Settings -> tab Options ->Online Updates ->Check now

If the menu item is missing, please contact your system administrator, who may have disabled the option to avoid operating errors

The online update is temporarily deactivated while PhraseExpress is connected to the PhraseExpress Server of the Network Edition. In this case, you can use the Client Manager to check for updates.

Uninstallation

Uninstallation video tutorial

PhraseExpress can be uninstalled via Start -> Programs -> PhraseExpress ->Uninstall PhraseExpress

The phrase file is not deleted when uninstalling PhraseExpress to avoid data loss. You can safely delete this file manually if you do not need your personal phrase file anymore.

Technical Support

If you have any technical problem, please visit:

http://support.phraseexpress.com

Background information

In this chapter, administrators can find technical background information. This information is not useful for normal users and can be ignored safely.

Installation logic

Following installation scenarios are recognized by PhraseExpress::

Szenario Auswirkungen

An administrator installs PhraseExpress solely for himself

(The option "Install for all users" has been unticked during installation)

  • The default phrase file location is \Documents and Settings\%Username%\Documents\PhraseExpress\phrases.pxp.
  • All settings are stored in a config.ini file located in the user's application data folder \Documents and Settings\%Username%\Application Data\PhraseExpress\config.ini.
  • A normal user (without admin rights) can also install the software later on the same PC with independing settings.

An administrator installs PhraseExpress for all users on this computer

  • The default phrase file path is \Documents and Settings\All Users\Documents\PhraseExpress\phrases.pxp
  • Program symbols are created in the program folders of all users on this computer.
  • All administrator settings are stored in a config.ini located in the common application data folder \Documents and Settings\All Users\Application Data\PhraseExpress\config.ini (and copied to the user's application data folder \Documents and Settings\%Username%\Application Data\PhraseExpress\config.ini).
  • Settings for normal users are copied from the common config.ini into the user's config.ini when PhraseExpress is launched for the first time.
  • Normal users can then make individiual settings which are stored in the user's config.ini.

An administrator installs PhraseExpress for all users on this computer and with common settings

(The option "Common settings for all users" has been activated during installation)

  • The default phrase file path is \Documents and Settings\All Users\Documents\PhraseExpress\phrases.pxp
  • The common phrase file is always shared among all users on the same PC (If you would like to share a phrase file with multiple computers, you would need to install the PhraseExpress Server of the Network Edition).
  • Program symbols are created in the program folders of all users on this computer
  • Program settings can be made by the administrator only. PhraseExpress always reads the settings as defined by the administrator in the common config.ini.
  • Normal users cannot change any settings (the menu entry is removed).

A user without admin rights installs PhraseExpress

  • The default phrase file path is \Documents and Settings\%Username%\Documents\PhraseExpress\phrases.pxp
  • All user settings are stored in the individual user's config.ini

PhraseExpress can only be installed by a normal user if PhraseExpress has not been installed by an administrator for all users before

A user without admin rights accesses the PhraseExpress Server of the Network Edition

  • If config rights have not been granted for the PhraseExpress client, it uses the common config.ini if it exists
  • If the user has config rights granted in the Client Manager, then PhraseExpress uses settings from the user's config.ini.

 

Command line parameters for the PhraseExpress installation file (vs. the program file)

Command line parameter Explanation

/SILENT

/VERYSILENT

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.

If a restart is necessary and the '/NORESTART' command isn't used (see below) and Setup is silent, it will display a Reboot now? message box. If it's very silent it will reboot without asking.

/SUPPRESSMSGBOXES

Instructs Setup to suppress message boxes. Only has an effect when combined with '/SILENT' and '/VERYSILENT'.

/SERVER=auto

/SERVER=IP address:Port

When you intend to use PhraseExpress with the PhraseExpress Server, you can specify the server's IP address and port via command line. This command line option does also generally enable the networking feature in PhraseExpress like /NETWORK does. When using /SERVER=auto, PhraseExpress will automatically search for the server.

/NETWORK

Enables the networking functionality of the PhraseExpress client installation.

/NOSTATS

Disables the PhraseExpress statistics function

/IGNORECAPSLOCK

Enables the PhraseExpress to ignore accidentally hitting the CAPSLOCK key

/NOHOTKEYCHECK

Installs PhraseExpress with the hidden setting which disables the hotkey plausability check. This allows to define phrase hotkeys even with a single letter key (which is not recommended and only suitable for special requirements).

/NOLAUNCH

Instructs Setup not to launch PhraseExpress after installation.

/LOG

/LOG="filename"

Causes Setup to create a log file in the user's TEMP directory detailing file installation and actions taken during the installation process. This can be a helpful debugging aid. For example, if you suspect a file isn't being replaced when you believe it should be (or vice versa), the log file will tell you if the file was really skipped, and why.

The log file is created with a unique name based on the current date. (It will not overwrite or append to existing files.). The information contained in the log file is technical in nature and therefore not intended to be understandable by end users. Nor is it designed to be machine-parseable; the format of the file is subject to change without notice.

/NOCANCEL

Prevents the user from cancelling during the installation process, by disabling the Cancel button and ignoring clicks on the close button. Useful along with '/SILENT'.

/NORESTART

Instructs Setup not to reboot even if it's necessary.

/RESTARTEXITCODE=exit code

Specifies the custom exit code that Setup is to return when a restart is needed. Useful along with '/NORESTART'

The Setup program may return one of the following exit codes:

0 Setup was successfully run to completion.

1 Setup failed to initialize.

2 The user clicked Cancel in the wizard before the actual installation started, or chose "No" on the opening "This will install..." message box.

3 A fatal error occurred while preparing to move to the next installation phase (for example, from displaying the pre-installation wizard pages to the actual installation process). This should never happen except under the most unusual of circumstances, such as running out of memory or Windows resources.

4 A fatal error occurred during the actual installation process.
Note: Errors that cause an Abort-Retry-Ignore box to be displayed are not fatal errors. If the user chooses Abort at such a message box, exit code 5 will be returned.

5 The user clicked Cancel during the actual installation process, or chose Abort at an Abort-Retry-Ignore box.

6 The Setup process was forcefully terminated by the debugger (Run | Terminate was used in the IDE).

Before returning an exit code of 1, 3, or 4, an error message explaining the problem will normally be displayed.

/LOADINF="filename"

Instructs Setup to load the settings from the specified file after having checked the command line. This file can be prepared using the '/SAVEINF=' command as explained below. Don't forget to use quotes if the filename contains spaces.

/SAVEINF="filename"

Instructs Setup to save installation settings to the specified file.
Don't forget to use quotes if the filename contains spaces.

/DIR="x:\dirname"

Overrides the default directory name displayed on the Select Destination Location wizard page. A fully qualified pathname must be specified.

/GROUP="folder name"

Overrides the default folder name displayed on the Select Start Menu Folder wizard page.

/TASKS="comma separated list of task names"

Specifies a list of tasks that should be initially selected or deselected. To deselect a task, prefix its name with a "!" character.
Only the specified tasks (and their children) will be selected; the rest will be deselected.

Example: Deselect all tasks, then select the "desktopicon" and "fileassoc" tasks:

/TASKS="desktopicon".

Command line parameters for the PhraseExpress program file

Command line parameter Explanation

-DEBUG

Creates a debug file in the program directory. This file is useful for our techsupport for trouble-shooting purposes.

PhraseExpress Network Edition

Please find the Network Edition manual here.

Troubleshooter

Problems with Autotext or hotkeys?

Trouble-shooting video tutorial

Does a certain Autotext/hotkey not work at all?

  • Is PhraseExpress running at all? Check whether the program icon icon is visible in the lower right of the Windows system tray.
  • If the system tray icon is grey-colored, PhraseExpress is either currently busy or you may have temporarily disabled the Autotext/hotkey feature. Click the program icon while holding the CTRL-key to toggle between the disabled/enabled state.
  • Check whether the Autotext option is enabled for the folder which contains the Autotext phrase.
  • Close the PhraseExpress main program window as Autotext and hotkeys are disabled while it is open.
  • Is the Autotext existing at all in the currently used phrase file? Open PhraseExpress, click the magnifying glass button and select only the Autotext and Match whole word option from the popup menu. Enter the Autotext into the Find input field. Does the intended phrase show up? If not, there is no phrase defined yet for the desired Autotext. Check the Autotext for accidental typos or leading/trailing spaces.
  • Is the phrase content for the defined Autotext empty? Does it contain an errornous macro function?
  • Are you running any other keyboard/typing related utillity? Close any other program to make sure that there is no interference with other applications and try with Windows Notepad as the target application.
  • Make sure, that PhraseExpress does not interfer with any other AutoCorrection function of another program, e.g. AutoCorrect in MS Office. Disable any other such function.

Are Autotext phrases unwantedly triggered?

  • Open PhraseExpress, find the desired phrase with the Quicksearch function, select the folder which contains the phrase and click the Details button to reveal the Autotext options for that folder. Make sure that the Autotext options are properly configured.