Table of Contents - PhraseExpress v5

Never read manuals?

Document conventions

What PhraseExpress can do for you

What is new in version 5

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 data?

…use the Text Prediction feature?

…use the Clipboard Cache?

…access the last used 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?

…embed external text/bitmap into a phrase?

…add a Windows environment variable into a phrase?

…add an ActiveDirectory LDAP variable into a phrase?

…add a random number into a phrase?

…create a predefined email?

…launch an application?

…open a file folder?

…open a file?

…open a webpage?

…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 tips & tricks

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?


Never read manuals?

No problem, PhraseExpress can be explored without additional instructions up to a certain degree but you will certainly miss a few killer features.

We strongly recommend you to read the tips & tricks section at least!

Document Conventions

You are currently reading this documentation in your browser program which allows you to jump between sections, set bookmarks or to print this manual.

  • Bold, italic type in this documentation indicates either a procedure or menu item.
  • Filenames are printed in italic letters.
  • Text input is represented in courier script.
  • Hotkeys are shown like this example: CTRL-A
  • 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.

Tips & Tricks are marked with this icon. These hints simplify the use of PhraseExpress with procedures which you may not find by just using the software.

This symbol indicates very important notes.

 

Here is the first information:

Program menu items to change settings or to modify data may be removed from the PhraseExpress menu to avoid operating errors or prevent accidental phrase deletion. Please contact your system administrator in case of questions.

What PhraseExpress can do for you

Video introduction

PhraseExpress increases your productivity:

  • PhraseExpress stores frequently used phrases for quick access to save you from repetitive typing.
  • Less typing reduces the chance of making typos.
  • The included system-wide spelling correction database additionally helps to avoid making mistakes.
  • Friendlier and more thorough communication without additional work.
  • Consistent and friendly communication throughout an organization by using common text templates.
  • Helps to prevent the RSI syndrome.

Special PhraseExpress benefits

PhraseExpress does all that you can expect from a text snippets organizer program but additionally offers quite a few unique extras:

  • There is no need to manually enter phrases and abbreviations anymore thanks to the new Text Prediction feature.
  • The Clipboard Cache provide quick access to the Windows clipboard history.
  • MS Word AutoCorrect/Autotext entries can be imported into PhraseExpress and then used in any application (more info).
  • PhraseExpress allows you to re-use the same Autotext for multiple phrases. In such cases, a popup menu right next to your cursor allows you to choose the desired text snippet.
  • There is support for formatted text bitmaps.
  • Phrases and macro functions can be linked and nested.
  • 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).
  • The user interface can be reduced to simplify use and minimize staff training.
  • The CapsLock key can be locked to avoid aCCIDENTAL use.

This is new in version 5

  • The new text prediction feature recognizes repetitive text input and offers to auto-complete such phrases.
  • The Clipboard Cache provides quick access to the Windows clipboard history.
  • PhraseExpress copies the last used phrases into a separate system phrase folder to allow quick access to frequently used text snippets.
  • The network cache of the PhraseExpress Network Edition caches the network phrase file while you are disconnected from the network.
  • Support for Terminal Server
  • New macro functions allow embedding external text and bitmap files.
  • Streamlined ease of use

System requirements

  • MS Windows 2000 or later (Terminal Server requires the Network Edition)
  • Optional: Web browser to read the documentation
  • Optional: Internet access to retrieve software updates
  • Approximately 4 MB hard disk space for the program plus space for the phrase file

Upgrade from previous versions

PhraseExpress can use the phrase file of any previous PhraseExpress version and automatically convert it to the new format.

Important note

Backup your current phrase file before upgrading.

The new version will convert the phrase file to a new format in order to support new features. Previous versions are not able to read the new phrase file format.

Upgrade from version 2

Version 2 phrase files are usually located at c:/program files/phraseexpress/myphrases.dta

You can import old phrase files in the new version. We recommend that you uninstall v2 first.

Upgrade from version 3 or 4

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

Software installation

Double-click the installation program and follow the on-screen instructions to install PhraseExpress.

Program Installation video tutorial

The PhraseExpress Autotext feature will interfere with the MS Office AutoCorrect functionality as both programs are triggered by your text input. You will recognize, that abbreviations are expanded twice. We strongly recommend that you import the MS Word AutoCorrect entries into PhraseExpress and disable the function in Word (see Microsoft help).

Installation variations

You can precisely define how PhraseExpress is used by multiple users on 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 flavors:
    • Each user has individual settings, or
    • All users always share the same settings as defined by the administrator.

Any user uses his own phrase file. If you prefer to share a common phrase file for multiple users in a network, you will need to install the separate PhraseExpress Server of the Network Edition.

Command line parameters for remote installations are explained here.

Important privacy information

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

Such 'security' software often cannot 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. Period.

  • PhraseExpress is digitally signed by an officially trusted certificate authority. This allows you to verify the program's origin.
  • Our company has existed since 1997 and German piracy laws are among the strictest world-wide.
  • On request, we can gladly fax or post customers a written confirmation that PhraseExpress does not send out any personal information.

When and why does PhraseExpress access the internet?

  • PhraseExpress accesses the network 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 the network access is local only (certain firewalls cannot 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 transmitted.

You can disable both options in the PhraseExpress settings. However, we strongly recommend that you keep allowing PhraseExpress check for updates as we continuously improve the program and 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 the same phrases over and over again.

Actually, you do not need to do anything special after installing and launching PhraseExpress. The Text Prediction feature will automatically begin to offer repetitive phrases for insertion after a while.

But you can also store text snippets manually:

Storing a new text phrase

Video instruction

If you are typing a sentence or term and feel that you might need that phrase also on other occasion, you can easily store the text in PhraseExpress for future access:

  1. Highlight the desired text and/or bitmap in any application.
  2. Click the PhraseExpress system tray icon Icon and select Create new phrase.
  3. A dialog window allows you to enter additional information for the phrase:
    Phrasendetails
    • The Description represents the phrase in the PhraseExpress pop-up menu. By default, PhraseExpress suggests 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 the 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"). E.g. defining the Autotext 'kr' would be suitable for the phrase 'Kind regards'.
    • PhraseExpress detects if the text is formatted and you can then tick the option to save the text formatting (which takes significantly more disk space and should be used sparingly). Please note that html formatting is not stored because the output would vary depending on the html style definitions of the target application.
    • If the stored phrase consists of a URL internet link only and if you tick the option 'Save as weblink', PhraseExpress will later open the website in your browser rather than pasting the URL as text.

The item is stored after being confirmed with OK or it can be discarded with Cancel.

When using the task tray icon menu command Create new phrase, the phrase is always stored in the top level of your phrase file structure. You can also store a new phrase directly into a specific folder if you have set up a folder structure: Just assign a hotkey to the folder. If you later open this folder by entering the hotkey and hit the Arrow-Up key one time, you get instant access to the Create a new phrase command and the new phrase will be stored directly in this particular folder.

Pasting 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 the 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 assigned to multiple phrases, a popup window appears next to the mouse cursor, allowing you to select the desired phrase with the following methods:

  • Select the desired phrase using the mouse.
  • Or use the up/down arrow keys to navigate through the items.
  • When striking the arrow-right key, PhraseExpress jumps straight to the first subfolder (if any). You can minimize the subfolder by 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 then pasted into the target application with the confirmation hotkey TAB.

You can close the popup menu at any time by hitting the ESC key.

If you hit the Arrow-up/-down key at least once, you can trigger the phrase also by simply hitting ENTER (instead of the confirmation key)

You can display the Autotext definitions together with the phrase description in [] brackets, if you enable the option Show Autotext in popup in the program 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.

You can instantly edit any phrase by clicking the item with the right mouse button in the popup menu

How to use hotkeys

A hotkey (or shortcut key, keyboard shortcut, key combo, etc.) is a set of keys associated with 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, causes 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 will 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.

Hotkeys defined in PhraseExpress can conflict with hotkeys used by other programs. Avoid frequently used hotkeys and try using combinations with the CTRL- , ALT-, SHIFT- key and a letter. A few hotkeys are firmly reserved 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 trying the hotkey. When the conflict arises you know which program is interfering.

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 under Settings -> Display

How to 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'
  • Entering short keywords can launch applications, like typing 'calc' can launch the Windows calculator.

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

You can import your existing Microsoft Office AutoCorrect and Autotext entries into PhraseExpress.

If you do wish to prevent the execution of a particular Autotext, click with the mouse just before you expect the Autotext execution.

If you wish to delete an unwanted Autotext text replacment, click the PhraseExpress task tray icon in the lower right while holding the SHIFT-key right after such unwanted replacement. You can then alter or delete the phrase in the editor window.

Configure Autotext

PhraseExpress continuously listens to 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, if you type the first letter of the Autotext in caps letter.

If you type at least the first two letters of an Autotext in caps, then the complete phrase will be pasted in caps letters.

Examples for the Autotext 'max':
Keyboard input Phrase contents Pasted text
max maximum maximum
Max maximum Maximum
max Maximum Maximum
Max Maximum Maximum
MAx or MAX Maximum MAXIMUM

How to edit text phrases

Click the PhraseExpress icon Icon in the lower right of the system tray and select the menu item Settings and switch to the tab Edit phrases. Alternatively, click the PhraseExpress tray icon while holding the SHIFT-key to open the editor with the most recently inserted phrase. You can also open any phrase for editing in the phrase selection popup menu by right-clicking the item in the popup menu.

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 the Edit phrases tab is missing, then the phrase file is either read-only, or is currently being edited by another user (if using the Network Edition), or the administrator has not granted edit rights.

To edit a phrase or folder, 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.

Right-click a single object to make a pop-up menu appear with the options: duplicate, move or delete (the selected object).

  • 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 the chapter 'Using Autotext'.

How to find a certain text phrase

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

QuickSearch

Video instruction

Open PhraseExpress. In the Edit phrases tab, click the magnifying glass button below the tree view, then choose search options from the option popup. 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 entry.

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

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

CTRL-clicking the magnifying glass button opens the Find & Replace window.

Right-clicking the magnifying glass button toggles the display of the search input field.

If you need to edit the last used phrase, click the PhraseExpress task tray icon in the lower right while holding the SHIFT-key.

Find & Replace

If you would 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 to set phrases as private

Video instruction

If you are using the PhraseExpress Network Edition you might want to have phrases which are exclusively visible to you. To mark a phrase folder as private, 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 login user name. This means that if you log onto a different PC in the network, you can see your private phrases there as well.

Additionally, you can define access rights for certain folders based on the user name, workgroups, domain names and user groups: Highlight the phrase folder, click on the Details button and click the button Define Access rights to make such settings.

Your private phrases are still stored on the central Server PC but they are only visible to you.

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

How to import/export text data

The powerful import/export-feature allows you to export any phrase file folder as as a independently usable phrase file. You can also merge multiple phrase files into a single phrase file or add text data from other applications by importing them into PhraseExpress.

Importing a phrase file

Video instruction

Click the PhraseExpress system tray icon icon and select Settings from the pop-up menu. In the tree view right-click the folder where you want to import the phrases, select Import from the pop-up menu and select the desired file.

You can alternatively right-click the desired phrase file in the Windows Explorer and select Import from the Explorer context menu. PhraseExpress will import the phrase file into the root path and offers to filter out duplicate entries and to organize your phrases.

You can also import text phrases from GhostTyperXML by selecting the appropriate .GTX file type

Text data from other application can also be dynamically embedded using a variety of macro functions, such as {#env}, {#adldap} or {#textfile}.

Importing Microsoft Word AutoCorrect/Autotext entries

You can also import your existing MS Office AutoCorrect and Autotext entries into PhraseExpress. Doubles of misspelled 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.

Importing text data

The separate import utility allows you to create a phrase file from any sort of volume text data which can then be imported as described above. It can be downloaded free of charge from our website.

Exporting phrases

Video instruction

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.

Any access rights are removed from exported phrase files.

How to use the Text Prediction feature

The text prediction feature is fully automatic and requires no manual configuration. If the feature is enabled at Settings -> Features -> Text Prediction, PhraseExpress automatically recognizes repeatedly entered sentences and offers to auto-complete such phrases.

Please try to type repetitive sentences identically in order to allow PhraseExpress to identify them as a repetitive input.

You can select from multiple choices in the popup menu using the mouse or arrow up-/down key and let them paste for you. The menu automatically disappears if you ignore it and continue to type a few letters.

Unwanted text suggestion items can be deleted by right-clicking them in the popup-menu.

The Text Prediction feature is integrated into PhraseExpress but uses a dictionary separate from the phrases which you have manually defined. You can transfer any phrase suggested by the Text Prediction feature into your standard phrases library via the special phrase folder named Last Used Items in the phrase tree (Learn more).

The text prediction feature can be temporarily disabled by clicking the PhraseExpress tray icon together with the CTRL-key.

If you do not get any text suggestion check trouble-shooting section.

How it works

Smart algorithms determine the phrase suggestions depending on following parameters:

  • How often has the phrase been entered?
  • How often have you accepted/ignored particular suggestions?
  • Text prediction related settings as described below
  • A magic formula which cost us countless nights of programming

PhraseExpress only suggests single and complete sentences, separated by punctuation marks followed by either ENTER, SPACE or TAB.

Text Prediction Settings

We are aware that a text prediction is generally a compromise between productivity increase and distraction caused by inappropriate/useless suggestions.

PhraseExpress can't beat this natural law but allows you to adjust the accuracy, amount and frequency of text suggestions.

You can reach these settings via Settings -> Text Prediction or directly by clicking the PhraseExpress task tray icon while holding the CTRL-ALT-keys.

Precision

The precision affects how well a phrase must fit into the gathered text information stored by the text prediction feature:

  • If you choose a low precision value, many suggestions will come rapidly after just typing a few characters of a sentence. You might find such a parameter causing you rather distracting text suggestions. This setting is only recommended if you use a small set of very repetitive text phrases with little variation or if you want to explore the text prediction feature.
  • A higher precision value is recommended as it makes PhraseExpress wait until you have typed a few words in order to limit the amount of alternatives. The downside is that the longer PhraseExpress has to hesitate to make a suggestion, the less typing you save.

We recommend enabling the determine automatically option: PhraseExpress will automatically increase the precision step-by-step if you ignore too many suggestions and lower the parameter if no suggestions are made anymore.

If you are satisfied with the result after using PhraseExpress a while, you can disable the automatic precision determination to make the setting permanent.

Maximimum number of suggestions

This parameter defines the maximum number of suggestions in the popup menu.

  • Ten or more suggestions offer a large varity of phrases but may occupy too much desktop real estate. However, sorting out and selecting a phrase from many suggestions can be uncomfortable and time consuming.
  • If you set the parameter to a very low value like 1, PhraseExpress will wait before making a suggestion if only one sentence possible can be its suggestion. This means that this parameter also indirectly affects when a suggestion is made.

Selecting anything between 3..7 may be a good choice for typical office applications.

Learn function

The Text Prediction feature is fully automatic and the phrase suggestions become more and more accurate by just using PhraseExpress.

You can however drastically shorten the learning curve by letting PhraseExpress look into the past: The Learn function can read your sent Outlook emails or text documents to get accustomed to your writing style.

Open the Settings -> Text Prediction -> Details -> Learn function and follow the directions.

You only need to scan your Outlook emails one time (as your written emails probably won't change in the meantime).

If you have a very large Outlook file, you may need to exclude old emails to be imported in order to limit the data amount.

Minimum input savings

The parameter Minimum input savings means the difference between what you already have entered and the total length of a text suggestion. Consequently, this parameter defines how many keystrokes you would save if you accept a text suggestion.

Example:

You have typed "thank yo" and the suggestion would be "thank you for your time.". If accepting the suggestion at this time would save you entering the remaining "u for your time." which are 16 keystrokes.

We recommend to set this value to at least 15..20. There is little benefit of saving 3..5 characters as the time to evaluate the text suggestions would exceed the time required to finish the last 3..5 characters of the sentence.

Just keep in mind that the higher the Minimum input savings parameter, the longer the sentences that are suggested.

This parameter works against the precision parameter: If you set a high precision value, then PhraseExpress waits with suggestions until you entered a few words, thus if you also define a high Minimum input savings parameter then the sentence must be really long in order to be suggested.

Word expiration

The text suggestion feature is based on an encrypted dictionary file word.pal which continuously stores any word (including misspellings) you enter while PhraseExpress is running. To prevent data overload, PhraseExpress automatically removes unused words after the customizable expiration term.

If you set a short expiration term of just a few days, the dictionary becomes smaller and unused words disappear quickly. The downside is that PhraseExpress will not offer rarely used text snippets which may otherwise have been useful.

You can freeze a certain state of the text prediction dictionary by changing the dictionary file (/MyDocuments/PhraseExpress/words.pal) access rights to read-only.

The command-line parameter allows you to launch PhraseExpress with a certain dictionary at start-up (See here). This provides quick access to dictionaries for different tasks or languages. Exit PhraseExpress first before loading a new dictionary.

How to use the clipboard cache

Windows normally overwrites any Clipboard contents if you copy anything new into the Clipboard. The PhraseExpress clipboard cache feature now caches previous clipboard contents and provide quick access via a special phrase folder.

This feature also allows you to save multiple phrases in a batch if you simply copy mutiple strings into the clipboard and organize the snippets in PhraseExpress later.

The clipboard cache can be disabled by simply deleting the special folder from the phrases tree under Settings -> Edit phrases. You can re-enable the function in Settings -> Features.

We recommend to assign the hotkey CTRL-ALT-v to this special folder: CTRL-v is the system hotkey to paste the current clipboard content and CTRL-ALT-v would consequently popup the history.

How to access the last used phrases

PhraseExpress can copy the last inserted phrases into a special system folder Last Used within your existing phrases structure.

This feature is useful if you need to cycle access to a limited set of phrases for repetitive insertion, e.g. when filling a batch of similar forms. We recommend to set a hotkey or Autotext for this system phrase folder.

This folder also serves as a data 'bridge' between the text suggestion feature and your phrase library. Any accepted text suggestion is copied to the Last Used folder.

You can disable this system folder by simply deleting it from in the phrase tree in phrases. The system folder can be re-enabled in the program settings.

How to use PhraseExpress in a network

If you would like to share a central phrase file with multiple users, you need to install the separate PhraseExpress Server of the Network Edition. Multiple users can share phrases and use personal phrases at the same time.

Important

If using the Network Edition, make sure to have the network function enabled at Settings -> Register Settings -> Features.

If the client is connected to the PhraseExpress Server, the exclamation mark in the task tray icon turns green and the program title bar bears the word 'Network' (also see chapter Status).

Network phrase file caching

While the network connection is interrupted (e.g. if you are travelling with your laptop), PhraseExpress uses a cached version of the latest status of the network phrase file and the task tray icon is blank (also see chapter Status).

These temporarily cached phrases cannot be modifed to avoid version conflicts if the computer is re-connected to the PhraseExpress Server.

PhraseExpress automatically switches back to the current network phrase file upon network re-connection.

Automatic Server Search

Video instruction

You can enable the automatic server search via Settings -> Register Edit phrases -> Select the first item in the tree structure with the symbol icon -> click the button Network -> Select Automatic.

By default, PhraseExpress continuously searches the PhraseExpress Server in the network (using a UDP broadcast poll via a customizable port 1036).

If the PhraseExpress Server recognizes a poll it welcomes the client by providing the current Server PC's IP address via a customizable UDP port and the client installation will download the phrases from the server.

Once the client installation receives the IP address, it will first try to connect to this IP address on every client restart. Only if the server can't be found anymore, then the client will start sending broadcast polls again.

You can disable broadcast polls by manually defining the Server IP address, using a local phrase file or if you disable the network function in the client.

Manual Server IP address

If the Server PC's IP address is permanent, you can enter it manually to allow faster connection and to disable the client's broadcast polls. This also allows you to access the PhraseExpress Server via the internet (where polling via UDP would fail).

The client will not find the Server again if the IP address changed in the meantime unless you enter the new IP address or switch to automatic server search (see above).

Please find more information about using PhraseExpress in a network in the Network Edition manual.

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
{#adldap ..} pastes an ActiveDirectory LDAP 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
{#openfolder ..} opens a file folder in the Windows Explorer
{#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
{#insertclipboard} Pastes the current clipboard contents. This macro is suitable if you need to nest this feature in other macro functions
{#setclipboard ..} fills the Windows clipboard with the defined contents
{#textfile ..} inserts the contents of an external plain text file
{#imgfile ..} inserts an external bitmap file
{#pasteoptions ..} Overrides the automatically defined paste method

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

Macro functions can be added to 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 the chapter "Using macros"

Create 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 will be the regional settings as defined in MS Windows.

Formatting of the date and time

The powerful macro function {#datetime -f format -s shift} allows you 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 (01-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 without 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

Video instruction

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

This is usefulwhen creating an 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 above rendered text phrase 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 a case, the corresponding phrase folder would pop up at the present cursor's location and you can select the desired phrase.

When using the optional parameter -random, PhraseExpress will 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. If the inserted phrase does not yet have the required Autotext, then PhraseExpress creates one for you based on the description beginning with '##'.

Benefits of using nested phrases

  • Nested phrases work like a template system. Footer text changes automatically take effect on all phrases which are referencing to it and you do not need to enter the 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 that you try using nested phrases, they are extremely useful and you really appreciate this feature.

Adding a counter variable in a phrase

PhraseExpress allows you to create an unlimited number of counter variables with custom start values and an 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 should 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 way to use a variable is 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 will be inserted and increased/decreased as specified for this variable.

Adding a manual text input into a phrase

Video instruction

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 the following 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 advantage 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 you 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 will 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%} inserts the specified Windows environment variable into the phrase.

Example:

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

Above phrase is rendered at the time of exection as follows:

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

Adding a ActiveDirectory LDAP variable to a phrase

The macro function {#adldap variable name} inserts the specified LDAP variable into the phrase.

This macro is useful e.g. for email signatures which are dynamically filled by the ActiveDirectory variables.

Example:

Kind regards,

{#adldap Name}

Phone {#adldap Phone}

Above phrase is rendered at the time of exection as follows:

Kind regards,
Jon Doe
Phone (203) 345-674

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 paste the phrase with the Autotext examplephrase as the email body:

Dear Holly ,

please check your post mailbox at home.

Sincerely ,
Earl E. Bird

The composed email would look like this:

Email

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

The email is sent via a mailto: system command which is limited in size by the operating system. Reduce the amount of text if an error message occurs.

Launching a program from a phrase

Video instruction

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

Example:

{#run notepad.exe}

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

Open a file folder

Video instruction

The above macro function {#openfolder "c:\path"} opens the specified file folder in the Windows Explorer.

Example:

{#openfolder "C:\Windows"}

This example opens the folder c:/Windows.

If you add the parameter -select, Windows Explorer opens the above folder and highlights the specified folder.

{#openfolder "C:\Windows" -select}

Open a file from a phrase

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

Example:

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

Open a web page from a phrase

Video instruction

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 can be 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

List of 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 represent 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 of 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 on 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 lets PhraseExpress wait for a specified amount of nnnn milliseconds. This is useful, if another application involved requires a certain amount of time to be launched or a website to be loaded.

Loop function

{#LOOP -count x} repeats anything x-times, that is, the number which follows after 'LOOP'.

Example:

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

The example used here uses the word 'example' three times:

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.

Other clipboard related macro functions

The macro function {#INSERTCLIPBOARD} pastes the clipboard contents chars-wise (key-by-key) instead of triggering the system clipboard paste (like if you would strike CTRL-C). This specific macro is useful when you wish to use the current clipboard contents as a default value for a manual text input:

{#INPUT -head Input? -def {#INSERTCLIPBOARD}}

The macro function {#SETCLIPBOARD contents} fills the clipboard with the given contents.

Example:

{#SETCLIPBOARD {#INPUT Text?}}

In this example, the clipboard is filled with the text you enter in the input dialog (keep in mind that macros are processed beginning from the innermost macro).

Embed external text file

{#TEXTFILE file}

This macro function inserts the contents of a plain text file into the phrase at the time when the phrase is pasted. The data is not stored within the phrase but only the link to the external file.

This macro is ignored if the file does not exist.

Embed external bitmap file

{#IMGFILE filename}

This macro function inserts an external .BMP, .JPG, .TIFF or .PNG bitmap into the phrase. The bitmap is not stored within the phrase but only the link to it.

This macro is ignored if the file does not exist.

Define the paste method for a specific phrase

{#PASTEOPTIONS -pastespeed delay in milliseconds -method kbk or cb}

This macro function overrides the automatic selection of the paste method for a particular phrase. You can also define the paste speed here (in milliseconds delay per keypress). Either use kbk for the key-by-key paste method or cb if you want the phrase to be pasted using the Windows clipboard.

This macro must be positioned at the beginning of 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

Several options in the settings dialog describe themselves so we are avoiding 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 need to bother with them.

  • Leading- and Trialing delimiter are the delimiters which allow PhraseExpress to recognize the beginning and end of an Autotext. #0 means 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 a 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. Important: The AutoCorrect functionality would not work anymore when using a Global Autotext prefix.
  • 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 you to define the number of characters before 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 phrases 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 slight 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 gives you access to very powerful extra features in the phrase folder context menu. Please use such commands with extreme care as they permanently alter phrases. We suggest you duplicate the desired folder first and make a test run to evaluate the changes. Changes only apply to the corresponding 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 an 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 have used PhraseExpress since its first version in 2002 and collected a few hints to help you to get the maximum benefits 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. Create 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 number of available hotkeys is rather limited. It is also easier to memorize a few folder hotkeys which allow accessing multiple phrases easily, literally at your fingertips.
  • 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!
  • Bitmaps in your phrases take a lot of disk space and you may decide to link bitmaps into a phrase using macro functions to embed external data.

"Undocumented" hacks

PhraseExpress includes some hidden pearls and useful tricks for power users:

  • Edit phrases quickly by right-clicking them in the popup.
  • Edit the latest pasted phrase with a SHIFT-Click on the PhraseExpress task tray icon. Alternatively, you can also configure a hotkey for this action in the Settings.
  • You can quickly open the PhraseExpress Settings by clicking the task tray icon while holding the ALT-key. If you hold CTRL-ALT then the settings for the text prediction feature will open.
  • Temporarily disable hotkeys, Autotexts and the text prediction feature by clicking the task tray icon while holding the CTRL-key.
  • Add separator lines between phrases in the phrase tree by creating a new phrase and simply enter a few minus characters "---" as the phrase description. PhraseExpress will then automatically convert such phrase into a horizontal separating line.
  • If you create a new phrase from a highlighted URL and tick the corresponding option Save as web link then PhraseExpress will open the URL in a web browser when triggering this phrase rather than just pasting the URL text.
  • If you create a new phrase and input a number as the phrase description, PhraseExpress will let you to convert such a phrase into a counter variable which can be used in other phrases.
  • When doing a QuickSearch you can toggle the display mode of the search result between the flat vs. tree view by right-clicking on the word "find" right before the search input field.
  • CTRL-Clicking the Search button opens the Search & Replace dialog.

Time savings calculation

Based on your individual typing skills and the amount of letters pasted by PhraseExpress, the daily time savings can be 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 of your individual time savings every time you launch the program. This can be disabled in the Pro Edition only

Important note

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

File location of your personal data

PhraseExpress saves your personal data in following locations:

File Location Purpose

phrases.pxp

User data folder by default, e.g. \MyDocuments\PhraseExpress\

The encrypted phrase file is very important as it keeps all your text snippets including folder structure, Autotext and hotkey definitions. You should backup this important file frequently to external storage devices.

clipboard.pxp, lastused.pxp

User data folder, e.g. \MyDocuments\PhraseExpress\

These temporary phrase file files keep the dynamically generated contents of the special phrase folders used for the clipboard cache and the last used phrases. There is no need to touch or backup these files.

words.pal

User data folder, e.g. \MyDocuments\PhraseExpress\

This encrypted file contains the dictionary and word links including statistic information for the text prediction feature.

network.pxp

User Application data folder, e.g. \Users\John Doe\AppData\Roaming\PhraseExpress\

If you are using the PhraseExpress Network Edition 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.

config5.ini

User Application data folder, e.g. \Users\John Doe\AppData\Roaming\PhraseExpress\

All program settings are stored in this file.

Phrase file location

Video instruction

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 right pane.

Click the File open button to point to another phrase file. Or click the New file button to create a new and empty phrase file and define the phrase file location when being prompted.

The phrase file must be local. The separate Network Edition allows accessing a phrase file over a network connection and share phrases with multiple users on multiple computers.

If the 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.

Phrase file location when using the Network Edition

If you use the Network Edition, then you will find the IP address of the PhraseExpress Server as the phrase file location (e.g. 192.168.123.144:1026)

If the client temporarily loses the network connection, PhraseExpress uses a local copy of the latest network phrase file version. The cached network file is set to read-only to avoid version conflicts with the network phrase file. PhraseExpress automatically reverts to the network phrase file if the client reconnects to the network.

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 or 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 be automatically created when you save any changes to your phrase file

Important Note

Frequently backup your phrase file to a external storage media to eliminate the slightest risk of losing your data in case of hard disk failure.

Keeping PhraseExpress up-to-date

Video instruction

We continuously improve PhraseExpress and we strongly recommend keeping 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

The online update is 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.

The update mechanism transmit part of the license key (if any), the current version number and the network adapter Mac address. No personal information is transmitted at any time.

Uninstallation

Video instruction

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.

If the Uninstaller complains that PhraseExpress is still running while there is no PhraseExpress tray icon, then strike CTRL-ALT-DELETE to open the task manager, switch to the tab Processes, highlight the process phraseexpress.exe and kill the process.

For general technical reasons, PhraseExpress cannot delete any data which is located in User folders as Windows prevents access to them.

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 has no use for normal users and can be ignored safely.

Installation logic

The following installation scenarios are recognized by PhraseExpress::

Situation Result

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 config5.ini file located in the user's application data folder \Documents and Settings\%Username%\Application Data\PhraseExpress\config5.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 config5.ini located in the common application data folder \Documents and Settings\All Users\Application Data\PhraseExpress\config5.ini (and copied to the user's application data folder \Documents and Settings\%Username%\Application Data\PhraseExpress\config5.ini).
  • Settings for normal users are copied from the common config5.ini into the user's config5.ini when PhraseExpress is launched for the first time.
  • Normal users can then make individual settings which are stored in the user's config5.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 config5.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 config5.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 config5.ini if it exists.
  • If the user has config rights granted in the Client Manager, then PhraseExpress uses settings from the user's config5.ini.

 

Command line parameters for the program file

Command line parameter Explanation

-DEBUG

Creates a debug file on the Windows desktop. This file is useful for our techsupport for trouble-shooting purposes.

-DICTIONARY=file path

PhraseExpress can be launched with a custom text prediction dictionary file. You can set this .pal file read-only to use it as a pre-defined set of text suggestions.

-TOOLBAR

Launch PhraseExpress together with a toolbar which displays the text prediction dictionary in realtime as it learns new words. It also offers quick-access to frequently used text prediction parameters. The toolbar is ony suitable for testing and evaluation.

Troubleshooter

Problems with Autotext or hotkeys?

Are unsuitable Autotext phrases triggered?

Video instruction

If you do not like a certain Autotext text replacement, click the PhraseExpress task tray icon while holding the SHIFT-key right after the unwanted text replacement occured. This will open the last executed phrase for editing. You can then alter the item or delete it with the red trash-can button.

Does a certain Autotext/hotkey/text suggestion not work at all?

Trouble-shooting video tutorial

  • Is PhraseExpress actually running? Check whether the program icon icon is visible in the lower right of the Windows system tray. If not click the Windows Start button in the lower left of your task tray ->Programs ->PhrasesExpress ->PhraseExpress.
  • If the system tray icon is grey-colored, PhraseExpress is either currently busy or you may have temporarily disabled the Autotext/hotkey/text suggestion 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.
  • Does the Autotext exist 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 entry for accidental typos or leading/trailing spaces.
  • Is the phrase content for the defined Autotext empty? Does it contain an erroneous 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 test it 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.

Do you get no text suggestions?

  • Is PhraseExpress running? Check whether the program icon icon is visible in the lower right of the Windows system tray. If not click the Windows Start button in the lower left of your task tray -> Programs -> PhraseExpress.
  • If the system tray icon is grey-colored, you may have temporarily disabled the Autotext/hotkey/text suggestion feature. Click the program icon while holding the CTRL-key to toggle between the disabled/enabled state.
  • Check whether the text prediction feature is enabled at Settings -> tab Features ->Text prediction.
  • Text suggestions are made for complete sentences only. These must end with a punctuation mark.
  • Sentences must be entered identically at least three times before they are suggested.
  • If many alternative suggestions exist in the suggestion database, PhraseExpress may wait for further input to narrow down the possible suggestions before displaying them. You may increase the maximum number of suggestions in the text suggestion feature settings to increase the allowed number of alternatives.
  • Sentences must have a certain minimum length in order to be suggested. The minimum length is defined by the two parameters Precision and Minimum input savings. If you want suggestions for short sentences then lower both parameters. Be warned that this will trigger many suggestions which tend to distract you.
  • In rare cases the dictionary may become corrupted. If no suggestions show up anymore, rename the dictionary file /MyDocuments/PhraseExpress/words.pal and restart PhraseExpress. The program will then recreate a new dictionary file and start learning suggestions from scratch.
  • If the dictionary file is set as read-only, then PhraseExpress does not learn new sentences and will not be able to suggest yet unknown phrases.

We thank D. Knoch very much for proof-reading this manual.