Speech Logger
- Author: Luke Davis, with contributions by James Scholes
- Download stable version
- NVDA compatibility: 2019.3.1 and later
An NVDA add-on to log speech to a file or files. It can log speech generated on the local machine into a text file. It can also log speech from a remote machine received through the NVDA Remote add-on, either to the same or a different file.
Configuration
To configure this add-on, open the NVDA menu, go to Preferences, then Settings, then Speech Logger (NVDA+N, P, S, then press S until you get there, on a default U.S. English keyboard).
Note: the add-on can only be configured while in the Normal Configuration profile of NVDA. The add-on is not profile-aware. If you can think of some use case that requires it to operate differently in different profiles, please contact the author or file an issue on the GitHub repo.
The following settings are available:
- The log directory. You can enter or browse for your desired destination directory, which must already exist. System variables such as %temp%, %userprofile%, etc., can be used in this field.
- Local log filename. The created file will be placed in the above directory. This will contain speech logged while the local log mode is engaged. This can be the same as the remote log file. Leave blank to disable this kind of logging completely.
- Remote log filename. The created file will be placed in the above directory. This will contain speech logged while the remote log mode is engaged. It can be the same as the local log file. Leave blank to disable this kind of logging completely.
- Separator. This combobox lets you choose one of the available utterance separators. See below for more information.
- Custom separator. This field lets you enter a custom utterance separator (see below), which is used if "custom" is chosen in the combobox.
- Timestamp mode. This combobox allows you to choose between no timestamps, and a timestamp at the start and end of each log session.
Utterance separator
When NVDA speaks something such as "recycle bin 1 of 55" while it's
reading your desktop, this is considered two separate utterances. The first
one is the item name ("Recycle bin", in this example), and the second is
the object position information ("1 of 55", in this example).
Depending on what you are reading, and how you have NVDA configured, there can be several separate utterances that happen during a single speech sequence.
In the normal NVDA log at debug level, each individual utterance is separated with two spaces, as it is written in the example above.
Speech Logger allows you to separate utterances in the same way NVDA does (with two spaces), or by one of a few reasonable alternatives (a newline, a comma and a space, a tab, two underscores), or by a custom sequence of your own devising.
If, for example, you wanted your utterance separator to be two dollar signs
($$), you would set the combobox to "custom", and enter "$$" (without
the quotes), in the custom separator field. If you wanted it to be a
newline followed by a tab, you could enter "\n\t".
Starting and stopping logging
This add-on has two gestures set by default. You can change them in the NVDA Input Gestures Tools category. Look for "Toggles logging of local speech" and "Toggles logging of remote speech".
- NVDA+Alt+L: start/stop logging of local speech.
- NVDA+Shift+Alt+L: start/stop logging of remote speech.
A note on remote speech logging
This add-on is intended to work with the NVDA Remote add-on, for logging of remote speech.
It is important to know, that it is not possible to start logging for remote sessions until you actually start one. There is no way to, for example, start logging, and have it wait, on stand-by, until a remote session starts, and begin logging at that time.
However, once started, logging will continue across remote sessions.
Feedback and feature requests
If you would like to suggest a feature or report a bug, please reach out by email, or file an issue.
As always, I appreciate hearing that my add-ons are useful, and what people are using them for.