Getting Started

Installation

Download the latest VGhostSetup.exe from the Download page and run it. The installer will place V-Ghost in %LocalAppData%\Programs\V-Ghost and create a Start Menu shortcut.

V-Ghost requires the .NET 9 Desktop Runtime. If it is not already installed, the setup wizard will offer to download it automatically.

First Launch

On first launch V-Ghost will ask you to:

1. Grant microphone permission — Windows will show a permission prompt, click Allow.
2. Choose your default language (English is pre-selected).
3. Choose your recognition engine — Vosk (recommended, offline) or Windows SAPI.

If you chose Vosk, the app will download the language model (~50–150 MB depending on language) on first use. An internet connection is only required for this initial download; afterwards everything runs offline.

Create a Profile

Profiles group voice commands together. You can have as many profiles as you like — for example one for a game, one for your code editor, one for general Windows control.

1. Open the Profiles tab (second icon in the bottom bar).
2. Tap the + button to create a new profile.
3. Give it a name, e.g. Visual Studio Code.
4. Optionally set a Confidence Threshold (0–1). The default of 0.75 is a good starting point — lower it if commands aren't triggering.
5. Press Save.

Add Voice Commands

Inside a profile, each command maps a spoken phrase to one or more actions.

1. With a profile open, tap Add Command.
2. In the Phrase field, type the spoken trigger — e.g. save.
3. Choose an Action Type:
   • Key Press — simulate a key or modifier combo
   • Mouse Click — left, right, or middle click at a target
   • Process Launch — start an application or script
   • Delay — pause for N milliseconds (useful in sequences)
4. Configure the action. For Key Press, select the key and any modifier (Ctrl, Shift, Alt, Win).
5. Press Save.

Example: "save" → Ctrl+S

Phrase:      save
Action:      Key Press
Key:         S
Modifiers:   Ctrl

Say "save" while the profile is active and V-Ghost sends Ctrl+S.

Macro sequences

You can chain multiple actions into a single command using a Macro Sequence. Add multiple steps (key presses, delays, etc.) in order — they execute in sequence when the phrase is heard.

Vosk vs Windows SAPI

V-Ghost supports two recognition backends. Both work fully — choose based on your preference:

Auto-Activate Profiles

A profile can be set to automatically activate when a specific application is in the foreground. This means your gaming profile switches on the moment you alt-tab into your game and switches back when you leave it.

1. Open a profile and scroll to Auto-Activate.
2. Enter the process name of the target app — e.g. Code for VS Code or EliteDangerous64 for Elite Dangerous.
3. Save the profile. It will now activate and deactivate automatically.

Settings Reference

Recognition Engine

Switch between Vosk and Windows SAPI globally, or override per profile.

Push-to-Talk

When enabled, recognition only runs while you hold down the configured hotkey. Useful if you don't want accidental triggers during normal conversation.

Overlay

A small on-screen indicator that shows the last recognized phrase and the active profile. Can be positioned in any corner of the screen (Top-Left, Top-Right, Bottom-Left, Bottom-Right) or disabled entirely.

Command Timeout

How long (in seconds) V-Ghost waits after a phrase is heard before discarding the match. Default: 30 seconds.