This page is out of date and needs to be updated for VC version 2
VoxCommando offers many options that determine the way the program works, how commands can be spoken, and also how VC interfaces with other programs such as XBMC (**EDEN only, Frodo settings are found in the plugin settings).
To access these settings, click "Options" on the top menu of the main VoxCommando window.
Options are broken up into different tabs.
- On mode
- This defines what sound is played when VoxCommando is activated.
- Standby mode
- This defines what sound is played when VoxCommando goes into standby mode.
- Off mode
- This defines what sound is played when VoxCommando goes into off mode.
- This defines what sound is played when VoxCommando has recognized a command and is about to execute it.
OSD Alternates options
- When VoxCommando hears a command, it will have an associated "confidence" based on how well it heard you and if there are similar commands that it is listening for.
- Confidence is shown on the popup OSD, in the command history panel, and in the large text box in the main VoxCommando window. Percentages close to 100 indicate that VC is very confident that it heard you correctly.
- You may experiment with this required confidence percentage to execute your "good" commands, while ignoring other sounds. If you have an accent that VoxCommando has trouble understanding, you may need to lower this number.
- When the confidence for a command is lower than the "Required Confidence" for a spoken command, a ? icon will appear in the history tab and the command will be ignored.
- When the confidence is higher than "Required Confidence", a megaphone icon will appear in the history tab and the command will be executed.
Show OSD on Command
- If checked, a small text window (OSD, or on-screen display) will open showing the command, whenever a command is recognized.
Show OSD alternates
- If checked, when you say a command a text window (OSD) will open showing possible alternate commands (if any) in a numbered list. To then execute an alternate, say the phrase "Option 2", or "Option 3" etc.
- Note that, by default -- even if it recognizes possible alternates -- VC will automatically execute the most likely command (i.e. Option 1). You can disable this by checking the "don't execute if there are alternate commands" box (see below).
- If you are using a program that takes over the screen in fullscreen mode (e.g., Windows Media Center, or XBMC when in "true fullscreen" mode), you will probably not be able to see the alternates OSD window. There are various solutions to this depending on which program you are interacting with. Please search the forum for more information.
Only show OSD/Alternates if command is executed
If this box is checked then OSD message popups will not be shown:
- when in Standby mode, except for commands that are "always on"
- when the confidence test fails
- if the command is not executed for some other reason
OSD appearance options
- OSD font scale adjust. Change the font size of all OSD messages
- OSD screen number. If you use multiple monitors, specify which screen displays OSD messages. The screen number is 0 based, so your primary display is 0, second display is 1, etc. If you set this to a higher number, when that screen is not active the display will switch automatically to the primary display (i.e. screen '0').
- OSD vertical position. Specify vertical position of all OSD messages. Positive numbers measure number of pixels up from the bottom of the screen. Negative numbers measure number pixels down from top of the screen
- Generate VC.Alternates event. When checked, VC will generate an event whenever alternate potential commands are detected. This event will carry alternate commands as payloads, and can be seen in the history panel when alternates are available. See forum for an example of how this feature can be used.
- Don't execute if there are alternate commands. By default, VC will automatically execute the most likely command that it understands, even if it recognizes possible alternates. If you select this checkbox, VC will not execute the most likely command but will instead always wait for you to select an option (i.e.,"Option 1," "Option 2," etc.).
When in standby mode, VoxCommando only reacts to certain commands that are set to be always on, such as "pay attention". If you enable prefix mode, you can issue any command while in standby by first saying the prefix. (See also: Prefix Mode demo video)
For example, if you enable prefix mode and set the prefix to "Jarvis", you could execute a command such as "Who is this?" by saying "Jarvis, who is this?"
This will allow the command to execute, but VoxCommando will remain in standby mode. You can use multiple alternate prefixes by separating them with commas.
Enabling, disabling, or changing the prefix will require a full rebuild of all commands. This should be done automatically when you save your options and may take some time depending on the size of your media library.
The prefix can be more than one word (this is good as it will avoid false positives). You can also use multiple prefixes by separating them with commas.
- Use Prefix(s)
- Use this checkbox to enable or disable prefix mode.
- 'Prefix' field
- This defines the text that will be used as a prefix (or name). See above for an explanation. Multiple alternate prefixes can be used by separating them with commas. For example, if you want to be able to start your command by saying either "jarvis" or "computer" then you could fill in the prefix field with jarvis, computer.
- Required Prefix Confidence
- VoxCommando must be confident that it understood you correctly before executing a command. Normally it is sufficient to define the confidence required for the command (see Other Options, below), however, you can further fine tune this by requiring a minimum confidence for the prefix as well as for the entire command. If you are not concerned with this, set it to a very low number like 1. If you get false positives based on the prefix you can raise this number, or try a longer prefix.
TTS (text to speech )
Default TTS Voice
- This is the default voice that will be used by VoxCommando for text to speech. This means VoxCommando speaks any text such as song name, album, time, etc. using the voice that is set here. You can test that the selected voice is accessible to VoxCommando and audible by clicking the "Test" button. If you have more than one voice installed, these should be listed here and you can select your preferred voice.
- By default, Windows 7 only comes with one voice (Anna if your OS is English). Good TTS voices are usually paid for. Do a web search and you may find some good free TTS voices. If you have more than one TTS voice installed, you can change the voice to another one via an action in your command.
- If you want your TTS to speak in a certain language you must use a voice designed for that specific language.
Don't listen during TTS.SpeakSync
Turns speech recognition off before each TTS.SpeakSync action occurs, and then turns it back on after the TTS.SpeakSync action is completed. This may be useful if you are finding that VC is mistakenly trying to execute commands when it hears the TTS voice speaking aloud. Note that this only works for Actions#Speak|TTS.SpeakSync]] actions, not TTS.Speak actions. See the forum for more discussion of this function.
Speech Recognition Language
Select the language that will be used for speech recognition. We also refer to this as the language of the speech "engine".
- Standard configurations of VoxCommando that use English will default to English (US) but if you have an accent that sounds closer to British you should change this to English (UK).
- If you are going to train Windows to understand you better, make sure that you are training the profile using the same language as you are going to select here.
- You can only select languages that are installed on your system that support speech recognition. Windows Ultimate supports the following languages:
- English (US)
- English (UK)
- Chinese (untested with VC)
- Japanese (untested with VC)
- The phrases defined in the command tree editor should use the same language as the speech language here. When you first install VoxCommando, there are standard configurations offered in several different languages. If possible, choose one for the language you wish to use. Other "unofficial" configurations can sometimes be found on the forum or by asking another user for their language-specific configuration.
- Some versions of Windows (such as Windows Ultimate) will allow you to easily install new language packs using Windows update. For most users it is recommended to select English because most media (song titles, artist names, and sometimes movies and TV-show titles) are in English. Of course, if your media library does not contain a lot of English titles and you do not intend to issue English commands you should choose the most appropriate language pack for your needs, if possible.
- Even if you use English as the "speech engine", you can probably simulate many phrases in other languages by spelling phrases phonetically (e.g., our Brazilian users seem to have good success with this method, as Portuguese is not a supported language).
- This is a complex topic that can be discussed in the forum if you need more help.
Also see the Languages wiki page for a more detailed discussion.
Select the language that will be used for the VC interface (VoxCommando menus and buttons). For the time being, most items are only available in English. With the constant changes and updates to VoxCommando it was too difficult to update multiple languages. Hopefully more languages will be available soon, at least on key windows.
Confirmation Command Phrases
Any command can be set to require confirmation. For example, if you have a command to delete a file, or a command to shut down Windows, to be safe you may want to require confirmation so that the command is not triggered by accident. Commands can be set to require confirmation in the LCB (Logical Command Builder). See the image at right. By default, most commands do not require confirmation.
Specify the phrase(s) that you wish to speak to confirm a command (when required).
Specify the phrase(s) that you wish to speak to cancel a command (if it was triggered by accident, or you changed your mind).
Auto cancel after (sec)
After a certain amount of time, if you do not confirm a command, VC will automatically cancel. Here you can set the amount of time before this happens.
Show OSD when confirmation required
Displays an OSD user prompt whenever VC is expecting a confirmation. The OSD message will display the expected confirmation phrase(s).
Idle Timeout in seconds
- Enter a number here (in seconds) to have VoxCommando automatically switch to standby or off mode after a period of inactivity (no commands recognized). Set to 0 to disable this function.
- Send port
- Set the the port for sending events to EventGhost. EventGhost needs to have the Broadcaster plugin enabled and set to listen on this port.
- Broadcast or Target IP radio button
- If Target IP is selected, then you must specify the IP address to send UDP messages to.
- If Broadcast is selected, then the IP will be set to 255.255.255.255, which means that all machines or devices on the LAN will receive the message provided that they are listening on the correct UDP port.
- Listen port
- VoxCommando will listen for UDP messages on this port.
Phrase Processing (PayloadXML)
Settings that affect how VoxCommando processes payloadXML files.
Whenever you create a payloadXML file, you have the option of checking the "SubMatch" box. The Phrase Processing advanced option defines the minimum and maximum sub-phrase lengths (in characters) that VoxCommando will recognize if that box has been checked.
If you only ask for part of a song or movie name, for example, VoxCommando can still recognize your command (if submatch is enabled for that phrase). This is what allows you to ask VC to "Play artist Marley" when what you would actually like to hear is the artist "Bob Marley and the Wailers".
Note: The complete phrase will always be one of the possible phrases even if it happens to be shorter than the minimum length specified here.
- Wav folder watcher
- Default: leave blank
- If a local folder (directory) is specified, VoxCommando will monitor this folder. Whenever a new .wav file is detected, VoxCommando will attempt to open the file and process the audio contained in the file, as speech. The file will be automatically deleted after processing is complete.
- Sox preprocessing
- It is recommended to leave this at the default setting: unchecked.
Time to Reinitialize Microphone
- Mic check status every (sec)
- Is sometimes useful if your usb microphone disconnects itself. Set this to number of seconds between checks. If VoxCommando determines that it has lost connection with the microphone it will reinitialize. Set to 0 to disable. Recommended to leave off unless you determine that you need to use this feature to stay connected to your microphone.
UI - Minimize to system tray on close
If you want to completely (almost) hide VoxCommando you can select this and then when you close VoxCommando, it will not really close, but instead be moved to the system tray (near the clock on the task bar). When in this mode you can actually close VoxCommando by right-clicking on the system tray icon, and selecting "close".
WMC (Windows Media Center)
WMC Song Artist Grammar
- After selecting an artist can create VoxCommando for all titles from this artist, commands.
- Create Song Grammar - Grammar created title
- Recognize Partial Match - recognize partial matches
WMC Pop Up Messages (OSD)
- WMC does not allow other windows to the front, the OSD window is not normally visible. When using the options below, WMC in information window displays.
- Show popup commands
- Show popup for alternative commands
- This will set the settings for XBMC EDEN
- If you are using XBMC Frodo or later please see Installation_XBMC_Frodo
Settings are mostly self-explanatory.
- For more information see Installation_XBMC_Eden
Use XBMC built in OSD popup window
- If selected, recognized commands and alternates will be sent to XBMC and displayed using the XBMC "notification" system.
- If you are using XBMC in "true fullscreen" this is one way to get around the fact that XBMC will "hog" the display and won't allow other windows to appear in front of it.
Partial Mute Level (0-100 )
- This sets the temporary reduction in volume as a percent of the current system volume when using the action
Note: This setting is deprecated and will probably be removed since the value can be set as a parameter when calling the action.
Check Program Focus Every (ms)
- This is the time in milliseconds (1000 ms = 1 sec) that VoxCommando will wait before checking to see which program has focus. If VC determines that focus has changed to a new program an event will be generated and will appear in the history tab.
Windows Sound Settings
- Here you can access the playback and recording settings of Windows.
Windows Advanced Speech
These buttons will take you to the Windows configuration windows for speech recognition and text-to-speech:
- Text-to-Speech settings are usually controlled directly by VoxCommando and don't need to be modified here, but it can be a convenient way to see what voices are installed and do some testing.
- You can set the default voice used by Windows TTS, create speech profiles, do speech training etc. It can also find the language profiles for different user training, which then can be changed via a command in VoxCommando. [I will expand this later, but VoxCommando must be restarted in each case after a change in the language profile.]
For more information visit http://windows.microsoft.com/en-ca/windows7/setting-speech-options
If you wish to use commands to check for new email messages on your Gmail account then you will need to enter your username and password here so that VoxCommando can access your account.
For your security, values are encrypted using your main hard drive ID. Therefore, if you move your VC settings to another computer (or accidentally send your VC options to another user) this information will not be readable.
- Disclaimer: If for some reason your credentials are readable by others who have access to your options file, we will not be held responsible.
SMTP server settings
Set up the SMTP account settings that will be used when sending email with the SMTP actions. Default info is provided for Gmail.
Note: Most users don't need to worry about this feature...
The Events table found on this tab allows you to define event "shortcuts" that you can trigger on the event menu of the main VoxCommando window.
- This can sometimes be useful for testing commands.
- If no events are defined in this Options tab, then the "Events" item will not appear on the main menu.
On this tab you can toggle active plugins on and off.
In order for the plugins to become active, you must click Save, and then restart VoxCommando.