Documentation

VoiceCommander v1.3.0

Advanced workflow automation with variables, conditionals, TTS, audio, mouse control, and command nesting.

Overview

VoiceCommander v1.3.0 brings state-driven automation to voice control. Store variables, branch on conditions, trigger audio feedback, and compose complex workflows from reusable commands.

Variables & State Management

Variables are named storage for runtime state — perfect for tracking game mode, equipment status, or workflow context.

  • Set Variable — Store a value with {VarName} interpolation
  • Increment Variable — Add or subtract from numeric variables
  • Toggle Variable — Flip boolean values between true/false
  • Profile-scoped — Variables persist across commands in a profile session

Example: "Set flightAssist = true" then reference it in later commands.

→ Full Variables Guide

Conditional Branching (If–Then–Else)

Execute different action sequences based on variable state. Perfect for adaptive, context-aware commands.

  • 8 Operators: Equals, NotEquals, GreaterThan, LessThan, IsTrue, IsFalse, IsSet, IsNotSet
  • Then/Else branches — Different actions for true/false conditions
  • Nested conditionals — Build complex decision trees

Example: "If combatMode Equals 'active' Then raise shields Else lower shields"

→ Full Conditionals Guide

Command Nesting (Call Command)

Invoke other commands as subroutines. Eliminate duplication and build complex workflows from reusable pieces.

  • Call any command — Look up by phrase, case-insensitive
  • Shared variable context — Called commands modify the same variables
  • Recursion protection — Automatic depth limit (10) prevents infinite loops

Example: "Battle stations" calls "Raise shields" then "Weapons hot" then "Alert crew"

→ Full Call Command Guide

Text-to-Speech (Say Text)

Speak text aloud using Windows SAPI — get audio feedback, announcements, and immersive callouts.

  • Dynamic speech — Use {Variable} interpolation to announce values
  • Rate control — Speed from -10 (slow) to +10 (fast)
  • Volume control — 0–100%
  • Voice selection — Choose from installed system voices

Example: Say "Targeting {targetName} at {distance} kilometers"

→ Full TTS Guide

Audio Playback (Play Sound)

Trigger audio files for notifications, alerts, and immersive sound effects.

  • Multi-format support — WAV, MP3, FLAC, OGG, WMA
  • Volume control — 0.0–1.0 (0–100%)
  • Synchronous playback — Blocks until audio completes

Example: Play alert.wav at 85% volume before TTS announcement

→ Full Audio Guide

Mouse Control

Move the mouse and control scrolling entirely by voice.

  • Mouse Movement — Absolute positioning or relative offset
  • Mouse Scrolling — Vertical or horizontal, configurable clicks
  • Precision input — Full pixel accuracy on all resolutions

Example: "Scroll inventory up 5 clicks" or "Click screen center"

→ Full Mouse Control Guide

Command Groups

Organize commands in collapsible editor sections for cleaner navigation.

  • Category organization — Group by Weapons, Navigation, Communication, etc.
  • No functional impact — Groups are UI-only, don't affect execution
  • Improved discoverability — Find related commands instantly

Example: Group all weapons commands together, all navigation commands together

→ Full Command Groups Guide

Global Profiles

Create profiles that are always active, regardless of which game profile is running.

  • Always-on commands — Available in any game or application
  • System controls — Ideal for mute, volume, settings, recording control
  • Separate variable context — Global profile variables don't mix with game profiles

Example: Global profile with "Mute Microphone", "Volume Up", "Toggle Overlay"

→ Full Global Profiles Guide

First-Run Onboarding Setup

Guided 7-step wizard sets up microphone, recognition engine, language, and first profile.

  1. Microphone Selection — Test mic, verify audio levels
  2. Engine Choice — Vosk (offline, recommended) or Windows SAPI
  3. Language Selection — 28+ languages, auto-download model
  4. Profile Creation — Start blank or from template
  5. Optional Tutorial — Learn first-command workflow
  6. Launch — Ready to use

→ Full Onboarding Guide

Real-World Examples

Elite Dangerous: Flight Control

Command: "Toggle flight assist"
  Actions:
    1. Toggle Variable: flightAssist
    2. If flightAssist IsTrue
       Then: Say Text: "Flight assist enabled"
       Else: Say Text: "Flight assist disabled"
    3. Play Sound: alert.wav

Visual Studio: Smart Build

Command: "Build and test"
  Actions:
    1. Call Command: "Build project"
    2. If buildSuccess Equals "true"
       Then: Call Command: "Run tests"
       Else: Say Text: "Build failed"

VR Gaming: Multi-State Weapons

Command: "Select weapon"
  Actions:
    1. Set Variable: weaponMode = "{selectedWeapon}"
    2. If weaponMode Equals "rifle"
       Then: Press Key: W1, Say Text: "Rifle selected"
       Else: Press Key: W2, Say Text: "{weaponMode} selected"

What's Next?

Start with the Getting Started guide, then explore individual feature guides above. Each guide includes practical examples, troubleshooting, and best practices.

Download VoiceCommander 1.3.0