This tool supports a multitude of languages provided through Azure and Google Cloud. For a detailed list, please refer to the respective sections below.

WARNING

Please note. If you use any online TTS system, the data is sent to a server and sent back. These services do not store this data, but it is up to you to check this and how it may work against your own IG policy. The app does have a feature of 'caching' data, too - but this is not sent to Ace or anyone else. It's all on the device.

Languages by Azure

For the most up-to-date list see the list here

Languages by Azure (Online)

Languages by Google Cloud (Online)

Languages by Sherpa-Onnx (MMS)

As this is a quick prototype, it may have some issues. For issues regarding connectivity or functionality, please note that Azure, Google Cloud and translation services require an online connection. If you have any questions, suggestions, or contributions, please create a pull request or .

Common Feature requests

• Offline Translation. Although possible with NLLB (Meta) its not easy to do all the language pairs we potentially need.

So we are not providing here software Gridsets/Pagesets of Keyboards for different languages.

If you want a client to write in the language of this TTS system (not use translate) You have to

• Find a keyboard layout the client is familar with in the correct script.

• Copy and paste the characters needed into a Gridset/Pageset that you need. Remember to not put spaces behind the characters

• This is painstaking. Please consider sharing your work so others can benefit.

Run the installer. Click through the options. At the end you can choose to run the applications - we recommend running these.

If you don't check these boxes - you can run them from your desktop or Start Menu. The applications you need to run are:

1. AACSpeakHelperServer - this runs in the background in your task bar

2. Configure AACSpeakHelper CLI - this allows you to configure the setup you need using a command-line interface

AACSpeakHelper is a small tool that enables you to\

• Take text written in a Windows AAC application

• If you need to - Translate it using a choice of online translation systems

• and if you need to - Speak that text using a range of online or new offline speech models supporting 1000's of languages not currently supported by commercial providers

It is good if you

• Want to set up a AAC system for someone speaking in a language not currently supported by solutions available

• If you have a client who wants to communicate to some people using a language they aren't familiar with. For example speaking to carers who are don't communicate using the communication aid users language or need to speak to family members who only speak in a language that they dont have a understanding of that written form

What its not good for

• Reading or saving long streams of text (eg reading a book aloud)

• If you want to use with a piece of software you cant copy the text from a message bar

• You really have to use iOS, Android or something else

Typical Use Cases

1. Language translation and speech output

Imagine you are a Kurdish speaker with limited English skills residing in a care facility. AAC Speak Helper bridges you and your caregivers, translating Kurdish text into English. Moreover, it supports people who need to speak languages less commonly supported by TTS technology.

1. Language not supported by current commercial solutions

If you speak Urdu - either as a bilingual speaker or as your primary language it can be difficult to find the perfect AAC system to meet your needs

Compatibility

AAC Speak Helper is a lightweight Windows executable. It can be called from any AAC app on Windows that can run external programs.

How it Works

AAC Speak Helper reads the text once the text is copied to the clipboard (using Ctrl+C). Depending on the configuration settings, it either translates the text using the selected service, speaks it aloud, or reads it. There are additional features, such as putting intonation (or style) onto some voices. We provide a CLI configuration tool to set up the application. The main application, though, has no interface.

AACSpeakHelper ISNT a SAPI Speech engine. What this means is it is not seen by your AAC Software as a voice you would pick in your regular settings screen. We have to do some things to get this to work. And note you will have to be comfortable editing your software.

In short you need to:

• Add a button to copy the message bar (writing area)

• Then, have an action on this button to call the executable found at %UserProfile%\AppData\Local\Programs\Ace Centre\AACSpeakHelper\client.exe (Note: You will need to browse for the app. You can paste this link into the file explorer but you need to find the exact path on your own computer)

• Then it's wise to wait around 4-10 seconds

• Clear the message bar

• Paste the returning text back if you are translating

You can test it by copying some text from a text file and running the app client.exe. Give it a go.

The Grid 3

We make things a little easier for the Grid as we provide an example pageset with the correct path to the application on your desktop under "Example pagesets". You can double click this and then try it out. Write some text - and then press on the flag icon

Tobii Dynavox Snap

Communicator

See the demo pageset

NuVoice

MindExpress

To-do

If you want to use mind-express for translation note that MEX already can do this. See

Azure TTS

• You first need an Azure subscription - .

• in the Azure portal.

• It works on Python 3.10 or 3.11. The dependencies aren't well covered on all other versions (and there are a lot!)

• We use a GitHub action to build the application (see workflow .)

Download the installer from our . You click on the link under "assets" for the file named AACSpeakHelper-v2.2.8.exe (or whatever number is there)

Alternatively you will find the current most release on the Ace Centre Website

Blood, sweat and tears

We have

1. A pipe server (AACSpeakHelperServer.py)

   1. Reads in a config dict from settings.cfg

Help! It doesnt say anything when I press the preview button!

• Have you just downloaded a new model? Give it a little while.. The pipe service doesnt report back when the model has downloaded and ready so the GUI tool just reports back ready. It should cue up your request though so it might take a little while

• Preview just says "Hello world" and runs client. If it is set to translate it may be sending the incorrect text. Try using translate and match the language you are trying to preview

Ummm its stopped working

• In the bottom right of the task bar you will find a small blue icon. Quit the AACSpeakHelper server and start it again. To do this navigate to %AppData%/Local/Programs/Ace Centre/AACSpeakHelper/ and double click on AACSpeakHelperServer.exe

• If it keeps happening send us the logs which are all plain text files %AppData%/Roaming/Ace Centre/AACSpeakHelper/

The translations are really bad - or have just stopped

• We default to using Google - the standard translate.google.com interface for this - not their paid for tier. Two problems with this: 1. Its rate limited. If you use it a lot rapidly it may stop for a short while. 2. The code we use to access this may have stopped working. Just let us know.

• Try changing translation providers. Some you will need to pay for but are likely to be better

Can I use this to batch-process a file of strings?

Sure. You may want to do this, for example, to create audio files for some phrases for a bilingual speaker. There are other tools to do this, but this is possible. You can just copy your text and run the main application - then look at the cache directory for the audio file. But if you want to automate this, check out this Powershell script

When supporting people with a language not supported by AAC

• Does the Voice exist on any system? (See our)

• If it doesnt can we get by with recorded clips?

• Do we need symbol vocabulary or can they write?

• If they can write what script are they familar with (Hint: Ask them if they write in their language to their friends on their phone - if they use the standard latin (UK/US) keyboard they could be using transliteration. This is not bad - you will just have to test if your TTS engine works with that. And remember if you are going to do phrases you may want to use transliteration too if they are not familar with the written form )

The app (client.exe) is designed to be called by a AAC application - and relies on some text being available in the copy buffer. You can use these parameters/flags to control aspects like which settings file is loaded or other aspects. Read below for all the flags.

General Usage

Options

Using the style flag for Azure voices

You can use the command line's --style flag for Azure voices. If you do this, follow it with one of these style flags. You can change the strength of these with --styledegree being 0.1 to 2. By default it is 1. So 2 would double it. Be warned. Some voices don't have all styles. .

CLI Configuration Tool

The CLI Configuration Tool (Configure AACSpeakHelper CLI.exe or cli_config_creator.py in development) provides an interactive way to configure AACSpeakHelper.

Usage

Development:

Installed version: Run "Configure AACSpeakHelper CLI" from the Start Menu, or:

CLI Configuration Options

The CLI tool provides a menu-driven interface with these options:

1. Configure TTS Engine - Set up text-to-speech engines

   • Choose from Sherpa-ONNX, Azure TTS, Google TTS, and others

   • Configure voice settings, rate, volume

   • Set up API keys for cloud services

Configuration File Management

The CLI tool automatically:

• Loads existing configuration from the default location

• Creates default configuration if none exists

• Supports custom configuration file paths with --config parameter

• Saves configuration in the appropriate location based on installation type

AACSpeakHelper now uses a modern, intuitive configuration system with positive boolean logic. This guide explains how to configure it effectively.

New Configuration System

After installation, you need to configure the application. There are two main ways to configure AACSpeakHelper:

1. CLI Configuration Tool - Use our command-line configuration tool

First up, check the table below for Languages officially supported by the software you are using. You can also use this as a tool to find which apps support a language you are interested in. Be careful. Some languages write in different scripts. Check the script that the TTS engine expects.

MindExpress

RHVoice (SAPI)

SAPI - MSSpeech

anReader

Note:

• All versions of anReader 4.2.8 support both 32-bit and 64-bit versions of Windows OS.

• It is recommended that Windows is updated and the latest system patches are installed.

• On Windows 10 and Windows 11, only the latest version of NVDA is currently supported, with other screen readers minor problems may occur in the operation of anReader.

Cereproc (SAPI)