Contents

WoW Chat: Voice to World of Warcraft Chat

Press a key, speak, and press it again: your words are typed into a World of Warcraft chat channel. Each channel gets its own key, so you can talk in Say, Guild, Party, Trade or a channel of your own without stopping to type. Speech is turned into text by Whisper running on your own PC, so nothing you say is sent to the internet.

It's made with a Stream Deck in mind (one button per channel), but works just as well with keyboard shortcuts.


How it works

  1. Press a chat key (for example F13 for Say) to start recording. You keep playing while you talk: nothing is typed into the game yet.
  2. Press it again to stop. Or hold the key while you speak and let go when you're done.
  3. Whisper turns your speech into text, on your own PC.
  4. WoW Chat types it into WoW for you: it opens the chat box, pastes /s and your words, and sends it. Long messages are split into several lines, because WoW only allows 255 characters per line.
  5. Everything you say is saved to a history log, so nothing is lost if it doesn't arrive.

A small label at the bottom of the screen shows what's happening: ● Say 0:04 while it records, then ✓ Sent to Say.


What you need

Requirement Notes
Windows 10 or 11
World of Warcraft Made and tested on WoW: Forever. Other versions of WoW use the same chat commands
PowerShell 7 Free; installed in step 2
ffmpeg 8.0 or newer, full build Free; installed in step 3. It includes Whisper
A microphone Any mic Windows can see. The one you stream or play with is fine
A Whisper model file Free download, 75 MB to 1.6 GB. You choose it in step 5
A Stream Deck (optional) Any model. Without one, you use keyboard shortcuts
Ollama (optional) Only for the optional AI cleanup (see Tray menu)

Already use Whisper dictation? WoW Chat needs the same setup. If you've done the Whisper dictation guide, you already have PowerShell 7, ffmpeg and a model: skip to step 4. WoW Chat finds your models in the whisper-models folder by itself.


Setup

1. Find out how much video memory you can spare

Whisper runs fastest on your graphics card, but WoW uses the same video memory (VRAM). Pick a model that fits beside the game.

  1. Press Ctrl+Shift+Esc to open Task Manager, and click Performance.
  2. Click your GPU and note Dedicated GPU memory, the total. That's your VRAM.

You'll use this number in step 5. No graphics card, or a GPU with well under 1 GB of dedicated memory? That's fine: Whisper runs on the processor instead, using a small model.

2. Install PowerShell 7

Open Terminal or Command Prompt and run:

winget install Microsoft.PowerShell

Windows has an older "Windows PowerShell 5.1" built in. WoW Chat needs version 7, which is called pwsh.

3. Install ffmpeg

winget install Gyan.FFmpeg

Close and reopen your terminal, then check that ffmpeg has Whisper:

ffmpeg -hide_banner -filters | findstr whisper

You should see a line containing whisper. If nothing appears, your ffmpeg is too old or isn't a full build: run winget upgrade Gyan.FFmpeg.

4. Download WoW Chat

Open PowerShell 7 (search for pwsh in the Start menu) and run:

curl.exe -L -o "$env:TEMP\wow-chat.zip" https://tastysnak.gitlab.io/wow-chat/wow-chat.zipExpand-Archive "$env:TEMP\wow-chat.zip" "$env:USERPROFILE\wow-chat" -Force

This puts WoW Chat in a folder called wow-chat in your user folder. Inside are:

File What it is
wow-chat.ps1 WoW Chat itself
whisper-engine.ps1 The speech-to-text part (recording, Whisper, the tray icon)
addon\WoWChatVoice A small WoW addon, installed in step 7

They're plain text files: open them in Notepad to see exactly what they do.

5. Choose and download a Whisper model

Skip this if you already have Whisper dictation's models in %USERPROFILE%\whisper-models.

Bigger models make fewer mistakes but need more memory, and WoW needs memory too:

Model file Download Memory Good for
ggml-base.en.bin 142 MB ~0.4 GB No graphics card, laptops, or little VRAM to spare
ggml-small.en.bin 466 MB ~0.9 GB Graphics cards with 6–8 GB of VRAM (WoW needs most of it)
ggml-large-v3-turbo.bin 1.6 GB ~1.9 GB Graphics cards with 12 GB or more. The most accurate

Models ending in .en understand English only. To speak another language, use large-v3-turbo and set Language in the settings (see The settings file).

Download straight into the WoW Chat folder. Run one or more of these, one for each model you want:

base.en (142 MB):

curl.exe -L -o "$env:USERPROFILE\wow-chat\ggml-base.en.bin" https://huggingface.co/ggerganov/whisper.cpp/resolve/main/ggml-base.en.bin

small.en (466 MB):

curl.exe -L -o "$env:USERPROFILE\wow-chat\ggml-small.en.bin" https://huggingface.co/ggerganov/whisper.cpp/resolve/main/ggml-small.en.bin

large-v3-turbo (1.6 GB):

curl.exe -L -o "$env:USERPROFILE\wow-chat\ggml-large-v3-turbo.bin" https://huggingface.co/ggerganov/whisper.cpp/resolve/main/ggml-large-v3-turbo.bin

With several models in the folder, WoW Chat uses the most accurate one. To choose, set Model in the settings.

6. Create a shortcut and start WoW Chat

This creates a WoW Chat shortcut on your desktop, which starts WoW Chat without a window. Copy the box below, paste it into PowerShell 7 and press Enter. You only need to do this once:

$script = "$env:USERPROFILE\wow-chat\wow-chat.ps1"$pwsh = (Get-Command pwsh).Source$lnk = (New-Object -ComObject WScript.Shell).CreateShortcut("$([Environment]::GetFolderPath('Desktop'))\WoW Chat.lnk")$lnk.TargetPath = "$env:SystemRoot\System32\conhost.exe"$lnk.Arguments  = "--headless `"$pwsh`" -NoProfile -ExecutionPolicy Bypass -File `"$script`" -Background"$lnk.WorkingDirectory = Split-Path $script$lnk.IconLocation = "$pwsh,0"$lnk.Save()"Shortcut created on your desktop: WoW Chat"

When it says Shortcut created on your desktop: WoW Chat, double-click WoW Chat on your desktop. Stay quiet for about 3 seconds while the label says Calibrating: it measures your room's background noise. Then it says WoW Chat ready, and a microphone icon appears by the clock.

Windows may hide new icons under the ^ arrow by the clock. To keep this one visible, drag it onto the taskbar.

7. Install the addon

WoW Chat comes with a tiny addon, WoW Chat Voice. It's needed for two things: whispering your current target, and sending to a channel by its name. Everything else works without it.

  1. Right-click the WoW Chat icon by the clock and choose Dashboard.
  2. Click Install the addon. (The button only appears while the addon isn't installed.)
  3. Quit WoW completely and start it again. WoW only finds new addons when it starts; /reload isn't enough the first time.

8. Set up your Stream Deck buttons

For each chat channel, add a button:

  1. In the Stream Deck app, drag System → Hotkey onto a button.
  2. Click in its hotkey box and choose the channel's key, for example F13 for Say (see the table below).
  3. Give the button a title, such as Say.

Keyboards don't have F13 to F24, so these keys never clash with WoW or anything else. Each button works both ways: tap it to start talking and tap again to send, or hold it while you speak and let go to send.

No Stream Deck? F13 to F24 aren't on keyboards, so give each channel a key you can press. In the Dashboard, click in a channel's Key box and type a combination, such as Ctrl+Alt+G or Ctrl+F1. You can then tap it, or hold it while you speak.

Extra mouse buttons or macro keys? Gaming mouse and keyboard software (Razer Synapse, Logitech G Hub, Corsair iCUE and similar) can usually set a spare button to send F13 to F24. Then the default keys work from your mouse, no Stream Deck needed.

9. Try it

In WoW, find somewhere quiet, then:

  1. Tap your Say button and say "Hello there".
  2. Tap it again.
  3. A moment later Hello there appears in Say.

The default keys

Key Sends to What WoW receives
F13 Say /s your words
F14 Yell /y your words
F15 Emote /e your words: an action after your name. Say "waves at everyone" and chat shows "YourName waves at everyone"
F16 General /1 your words
F17 Trade /2 your words (Trade only works in cities)
F18 Reply /r your words: replies to whoever last whispered you
F19 Whisper target Whispers the player you have targeted (needs the addon)

Change, add or remove keys in the Dashboard.


Daily use

  1. Start WoW Chat from the desktop shortcut, and stay quiet for the 3-second calibration.
  2. Play. Press a chat key, speak, press it again.
  3. To stop WoW Chat, right-click its icon and choose Quit WoW Chat.

If WoW isn't running, or WoW Chat can't bring the game to the front, nothing is typed. The label says so, and your words are still saved in the history.

The icon by the clock

Icon Meaning
Grey ring Starting up
Blue-grey Ready: press a chat key
Red Recording
Amber Turning your speech into text
Orange with ! Something's wrong: right-click it and choose Show log

The tray menu

Right-click the icon for:

Menu item What it does
Dashboard Set up your chat keys (see below)
AI cleanup Tidies your words before they're sent: removes "um"s and repeated words, and fixes punctuation. Needs Ollama running, with a small chat model (for example qwen3.5:4b), and uses under 4 GB of video memory, so it's off by default. If Ollama isn't running, it tells you and stays off. Turning it off, or quitting WoW Chat, frees that video memory straight away
Beeps A beep when recording starts and stops
Restart Whisper dictation when WoW Chat closes Only shown if you also have Whisper dictation (see below)
Open history folder Everything you've said
Show log What WoW Chat has been doing, for troubleshooting
Quit WoW Chat Close it

These choices are saved straight away and kept for next time.


The Dashboard

The Dashboard is where you choose your chat keys. Open it from the tray menu.

Where a key can send to

Sends to Notes
Say, Yell, Emote, Party, Guild, Officer, Raid, Raid warning, Battleground The usual chat types
Reply to the last whisper Like typing /r
Whisper your target (addon) Whispers whoever you have targeted. If no player is targeted, a red note in chat says so and nothing is sent
Whisper a player by name Type the player's name
Numbered channel (/1, /2, ...) Pick from the list, or type the number
Channel by name (addon) For channels players make. Pick from the list, or type the name
Other slash command (advanced) Any chat command, for example /i for instance chat

Why "by name"? WoW numbers channels in the order you joined them, so a channel you made can be /5 today and /6 tomorrow. Sending by name always reaches the right one.

The channel lists come from the addon, which notes which channels each of your characters is in. WoW saves that note when you /reload or log out. Joined a new channel? Type /reload in WoW, then click Refresh list in the Dashboard. Hidden channels that addons use to talk to each other are left out of the list on purpose: they're not for people.


Using it with Whisper dictation

WoW Chat and Whisper dictation are separate apps, but they can't both use the microphone at once. If Whisper dictation is running when WoW Chat starts, WoW Chat closes it.

With Restart Whisper dictation when WoW Chat closes ticked in the tray menu (the default), dictation starts again when you quit WoW Chat, so your F9 key comes back by itself.


The settings file (wow-chat.json)

The Dashboard and the tray menu cover everyday changes. For anything else, the file wow-chat.json in the WoW Chat folder can be opened in Notepad; restart WoW Chat after editing it.

Setting What it does
Mic "auto" uses the Windows default microphone, or put a microphone's exact name
Model "auto" uses the most accurate model found, or a full path to a model file
ModelDir Where to look for models. "" means the WoW Chat folder, then %USERPROFILE%\whisper-models
Language The language you speak, e.g. "en", "de", or "auto". Use a model without .en for other languages
SilenceDb "auto" measures background noise at every start. Or a fixed number such as -40 to skip calibration
HoldMs Holding a key longer than this many milliseconds means hold-to-talk; a shorter press is a tap
GameProcess The game's program name; "Wow*" matches WoW's usual names
AddOnsDir WoW's AddOns folder. "" means find it automatically
History Enabled; Dir ("" = a history folder next to WoW Chat); KeepAudio (keep the recordings too; off by default); KeepAudioDays
Cleanup The AI cleanup's Ollama Model ("auto" = smallest installed), Url, TimeoutSec and KeepAlive

Troubleshooting

Nothing appears in WoW

Half-typed text got sent If you'd started typing in WoW's chat box and left it open, WoW Chat's first Enter sends what was there. Close the chat box (Esc) before you speak.

"Some chat keys are not working" Another program has taken those keys. Pick different keys in the Dashboard.

The channel list is empty

Whisper target says "Target a player to whisper them" Click a player before you speak. NPCs can't be whispered.

It always says "Nothing heard"

It mishears names and abbreviations Whisper is best at ordinary sentences. Player names, "LFM", "SFK" and similar may come out wrong. Your history log shows exactly what it heard.

It types phrases you didn't say, like "Thank you." Whisper sometimes invents phrases when it hears only noise. The common ones are dropped automatically. If it keeps happening, click Recalibrate mic in the Dashboard while your room is as noisy as it usually is (fan on, music at its normal level) and stay quiet yourself. Still happening? Set a fixed SilenceDb a little higher (less negative), e.g. -35.

"WoW Chat is already running" Only one copy can run. Look for its icon by the clock (check under the ^ arrow).

"ffmpeg not found" or "no whisper filter" Repeat step 3, then start WoW Chat again.


Privacy and fair play