Interpreter States

Interpreter states affect the behavior of the interpreter. These states can be activated and deactivated at any time. This page describes these states.

Commands Only

The commands-only state can be enabled to ignore normal typing and only process commands. This is useful when you want to avoid accidental typing in a user interface when incorrect recognition causes typing. This state is inactive by default. You can activate or deactivate the state by saying "commands only on" or "commands only off".

Auto Spacing

The auto-spacing state controls whether space characters are automatically inserted between words within an utterance. This state is active by default. You can activate or deactivate this state by saying "spacing on" or "spacing off".

Deactivating this state is useful when you are writing code or entering alphanumeric sequences, where automatic spacing is sometimes undesirable.

Auto Utterance Spacing

The auto-utterance-spacing state controls whether space characters are automatically added after each utterance. This state is inactive by default. You can activate or deactivate this state by saying "utterance spacing on" or "utterance spacing off".

Activating this state is useful when you are mostly typing new text. This state may be undesirable when you're editing existing text or entering alphanumeric data.

Auto Capitalization

The auto-capitalization state controls whether the recognizer can control capitalization of typed words. This state is inactive by default, because most recognizers do not accurately capitalize words. You can activate or deactivate this state by saying "capitalization on" or "capitalization off".

Note that this feature only works for recognizers that are capable of applying capitalization. You can see whether a recognizer is applying capitalization in the user interface utterance history ("Recognizer: ..."). Currently, the default recognizer, Vosk, does not apply capitalization, but all other supported recognizers do apply capitalization.

Auto Scrolling

The auto-scrolling state is used to automatically scroll. When activated, the mouse scrolls down a few ticks every few seconds. This is useful when skimming long content or social media. You can activate automatic scrolling by using the "start scrolling" command. This command starts automatically scrolling down three ticks every N seconds, where N is provided as an optional utterance argument. For example, "start scrolling seven" will scroll down three ticks every seven seconds. If no argument is provided, it will scroll every 5 seconds. If automatic scrolling is already active, you can use this command to change the seconds value.

You can deactivate this state by saying "stop scrolling".

Holds

Some commands allow you to hold down modifier keys and mouse buttons. For example, you can say "hold shift" and "release shift" to hold and release the shift key. While the key is being held, the user interface shows the key currently being held. If your input suddenly starts behaving strangely, you have likely forgotten to release a key.

In rare circumstances where Utterly Voice is forced to terminate abruptly (for example, end process from the task manager) while it is holding a key or mouse button, it will remain held after the application closes. All of your computer's physical keyboard and mouse input will behave strangely. To remedy this, simply press and release the held modifier key or mouse button on your physical keyboard and mouse.