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

External Data

PhraseExpress can embed data from a variety of external files and online services into the phrase.

Language translation

PhraseExpress supports online AI services, such as DeepL or OpenAI, to translate any provided text into a specified language.

Video tutorial

If no source language is specified, the translation algorithm analyzes the text to determine the language of the provided text.

In most cases, you probably nest macros into the source text input box, e.g. to insert the current clipboard content or to insert a variable.

AI text processing

Video Demo and Tutorial

The PhraseExpress macro function "AI text processing" allows you to use AI in any application.

In the macro dialog, you can define the input that is sent to the AI engine and the instruction in natural language how the AI shall process the text:

The gear icon allows you to fine-tune AI related parameters.

The true strength lies in integrating the AI macro with other PhraseExpress macro functions. Right-click the input box and choose the appropriate macro function from the popup menu to incorporate it into the AI macro.

You can leave the input empty and just prompt OpenAI to generate any text, e.g. "write a random cookie recipe".

AI Parameters

Parameters for large language models (LLMs) are used to control various aspects of their performance, behavior, and output.


The "variation" parameter (also known as "temperature") affects the diversity and unpredictability of AI generated outputs. It controls how much the model deviates from the most likely responses. Higher variation leads to more creative but potentially less coherent results, while lower variation results in more precise but possibly less innovative answers.

  • High variation: More diversity, more creative outputs, increased risk of incoherent or inappropriate responses.
  • No variation: Less diversity, more precise and predictable outputs, reduced risk of inappropriate responses.


The parameter "accuracy" refers to the AI model's ability to correctly predict or classify inputs based on the given data.

Effects of a high accuracy setting include:

  • Correct Predictions: The model makes accurate predictions or classifications, which is crucial in fields like medical diagnosis, fraud detection, and autonomous driving.
  • User Trust and Satisfaction: Consistently accurate results build user trust and satisfaction, leading to greater adoption and reliance on the technology.
  • Business Advantages: High accuracy can lead to increased efficiency, cost savings, and improved reputation. For instance, accurate product recommendations in e-commerce can enhance customer experience and boost sales.
  • Resource Efficiency: High accuracy maximizes the value of computational resources, reducing the need for additional post-processing or human intervention.
  • Minimized Harm: In critical applications, high accuracy helps prevent serious consequences such as misdiagnoses, wrongful convictions, or security breaches.
  • Reduced Error Correction: Less need for post-processing and human intervention lowers overall system costs and complexity.
  • Reliable Metrics: High accuracy, especially when aligned with other metrics like precision and recall, indicates strong model performance, even with imbalanced datasets.
  • Positive Feedback Loops: Accurate predictions can improve future performance in applications using feedback loops, like recommendation systems.

Overall, high accuracy leads to better performance, higher user satisfaction, business benefits, and lower costs.

Key impacts of a low accuracy setting:

  • Incorrect Predictions: A low accuracy setting means that the model makes more incorrect predictions or classifications. This can be detrimental in applications where precision is crucial, such as medical diagnosis, fraud detection, or autonomous driving.
  • User Trust and Satisfaction: Users are likely to lose trust in the system if it frequently makes mistakes. This can lead to reduced user satisfaction and reluctance to adopt or rely on the technology.
  • Business Impact: For businesses, low accuracy can result in financial losses, inefficiencies, and damage to reputation. For example, in e-commerce, inaccurate product recommendations can lead to poor customer experiences and lost sales.
  • Resource Waste: Continuing to use a low-accuracy model can waste computational resources, time, and effort that could be better spent on developing or deploying a more accurate model.
  • Potential Harm: In critical applications like healthcare, legal decisions, or security, low accuracy can lead to serious consequences, such as misdiagnoses, wrongful convictions, or security breaches.
  • Need for Post-Processing: Models with low accuracy may require additional post-processing or human intervention to correct errors, increasing the overall cost and complexity of the system.
  • Performance Metrics Misalignment: Depending on the context, relying solely on accuracy might be misleading. For example, in imbalanced datasets, a model might achieve high accuracy by predicting the majority class but fail to identify minority class instances. In such cases, other metrics like precision, recall, and F1-score are also critical.
  • Feedback Loop Issues: In applications using feedback loops, such as recommendation systems, low accuracy can propagate errors, leading to degraded performance over time as incorrect recommendations influence future predictions.

Embed external file contents

This macro function inserts the contents of the specified file into the phrase:

CSV file values

This macro function inserts a specified values of a CSV file ("comma separated values):

You can define a range of values by their start and end row/column coordinates (starting with 1). Multiple cells can optionally be separated with a separator text.

XML value

This macro function inserts a XML file value, addressed by its xpath value (see Wikipedia).

This macro function can be used as a data bridge to external databases which can create an XML file.

Table of Contents

Table of Contents