Add your custom phrases in two steps

Step 1

Create a text file with your data.

Step 2

Copy the entire content of your file and paste it into the text box under 'Add custom phrases with short keys'.

Create your text file

Create your text file with a simple text editor (e.g. Windows Editor or WordPad) and save the empty file on your local hard disk. You can freely choose the file name, the file extension must be .txt (example: yourfilename.txt). Click the green button 'Copy Template Data' below and paste the copy into your text file.

Now you can overwrite the values of the field names "text" and "short" with your user-defined values. However, never change the field names themselves. These are fixed in the app and will no longer be recognized if you change them. Each data record must be placed between curly brackets {} and separated from the previous data record by a comma (,).

To add further data, copy one of the inserted data records including the curly brackets { }, place a comma and a line break after the last data record - but before the last square bracket ] - and paste the copied data record. Overwrite the copied field values with your user-defined data.

Copy your data to the app

Copy the entire content of your text file. Go to the text box under 'Add custom phrases with short keys' Place the cursor in the text box and paste your data using CTRL + V or by clicking the 'Paste Data' button. Your data will then be displayed in the text box. Then click the 'Store Data' button.

Every time you paste and store user-defined data, the app automatically deletes any user-defined data that has already been saved. You must therefore always copy and paste your entire file content, even if you have only changed, added or deleted one data record. Your file contains the original data. You should therefore always create a backup copy of your file after you have made changes.

The textfile with your data is to save the data persistently on your harddisk. It is recommended to make a backup copy outside of your harddisk of that file. You can change that file (add, change or delete phrases and short names) and copy the content to the app again whenever you want.

Structure of the text file content

For the app to be able to read your data from the text file, it must be in Json format. This means specifically:

The entire content of your file must always be between square brackets []. This [ opening square bracket must always be the first character in your file. And this ] closing square bracket must be the last. These brackets contain your data like a table.

Then you can add an indefinite number of data records to the square brackets. Each data set starts with a { opening curly bracket and ends with a } closing curly bracket. Place a comma after each data record to separate the data records.

Each data record contains two fields. The "text" field and the "short" field. The "text" field contains the phrase to be spoken and the "short" field contains a short key with which you can call up the phrase. Example:

{"text": "not now", "short": "nn"},

This means that you can enter nn in the keyboard and the app will display the desired text as a dark blue text button. As you can see from the example, the field names as well as the values must always be in quotation marks. In addition, the field name and the field value must always be separated by a colon. And the two fields must be separated by a comma. Finally, here is another complete example with two data records for a valid data format:

[{"text": "not now", "short": "nn"}, {"text": "I would like", "short": "iwl"}]

How many data records can be added?

There is no fixed data set limit. But there are other limits. The input field in which you enter your data is limited to 100000 characters. The storage space of the localStorage is also limited. This is usually around 5 - 10Mb. But 100 to 200 data records are no problem. If you need more, you have to test it. It also depends on the performance of your device.

Short name

The short name must contain at least 1 letter or a number. You can use a short name once or multiple times. If you use it more than once, you create a phrase group. This is useful for phrases that are often used in specific situations. For example, you can use the same short name for the phrases "hello", "how are you?", "I'm fine, thank you" etc. For example, "mt" for meet. If you then enter "mt" on your keyboard, all phrases with this short name will be displayed. You can then press the Pin button to temporarily fix the buttons. The buttons remain fixed until you call up the next phrase group or deactivate Pinned mode again. Attention! As long as you have activated the pinned mode, the search no longer behaves in the same way. Results from word searches are no longer displayed.

How does the app search for my phrases?

If you use the app keyboard (or the device keyboard if you have activated the "device keyboard search" option), the app only searches in the "short" field. You must enter the exact short name to get a hit. If the app finds a short name that only occurs once, you will get two slightly dark blue buttons as a result. This color is only used for search results from the user-defined data. One button is displayed at the top with the short name, the other button is displayed with the text below the home buttons. It does not matter which button you click. In both cases, the corresponding text is written in the text box. If the app finds several phrases with the same short name (a phrase group), all hits are displayed under the home buttons. If you wish, you can then click on the Pin button. All buttons then remain temporarily fixed until you call up the next phrase group.

But as long as you have Pinned activated, results from single short names are only displayed as a button at the top. If the app finds a single short name, the app sets the focus to the button with the short name. To write the text of the button in the text box, you can press the tab key or the space bar.

• Second click/tap on a word or number button starts textbox to speech.
• Click/tap the copy icon left to key 'a' to repeat a number or word.
• All light green buttons replace the last word in the textbox.
• If your device is a pc/notebook with mouse: right mouse click displays all home buttons. The first right click displays Home Buttons 1 (H1) and the second right click displays Home Buttons 2 (H2). If H1 is already displayed, the first click will display H2.