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
- 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.
- Press it again to stop. Or hold the key while you speak and let go when you're done.
- Whisper turns your speech into text, on your own PC.
- WoW Chat types it into WoW for you: it opens the chat box, pastes
/sand your words, and sends it. Long messages are split into several lines, because WoW only allows 255 characters per line. - 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-modelsfolder 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.
- Press Ctrl+Shift+Esc to open Task Manager, and click Performance.
- 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.PowerShellWindows has an older "Windows PowerShell 5.1" built in. WoW Chat needs version 7, which is called
pwsh.
3. Install ffmpeg
winget install Gyan.FFmpegClose and reopen your terminal, then check that ffmpeg has Whisper:
ffmpeg -hide_banner -filters | findstr whisperYou 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" -ForceThis 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.binsmall.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.binlarge-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.binWith 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.
- Right-click the WoW Chat icon by the clock and choose Dashboard.
- Click Install the addon. (The button only appears while the addon isn't installed.)
- Quit WoW completely and start it again. WoW only finds new addons when it starts;
/reloadisn't enough the first time.
8. Set up your Stream Deck buttons
For each chat channel, add a button:
- In the Stream Deck app, drag System → Hotkey onto a button.
- Click in its hotkey box and choose the channel's key, for example F13 for Say (see the table below).
- 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:
- Tap your Say button and say "Hello there".
- Tap it again.
- 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
- Start WoW Chat from the desktop shortcut, and stay quiet for the 3-second calibration.
- Play. Press a chat key, speak, press it again.
- 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.
The list on the left shows your keys. Click one to change it, or use Add and Remove.
Name is what the label shows while you speak. It doesn't have to be unique.
Sends to is where your words go (see the table below).
Key is the key that starts it. The box is a list and a text box:
- Pick from the list: F13 to F24, alone or with Ctrl. Keyboards don't have these keys, so they never clash with anything; they're made for Stream Deck buttons.
- Or click in the box and type any key or combination you can press yourself, such as
Ctrl+Alt+G,Shift+F2orAlt+NumPad1.
Each key can only be used once.
Save keeps the window open, and WoW Chat uses the change straight away. Close closes it; anything not saved is dropped.
Recalibrate mic measures your room's background noise again, as WoW Chat does when it starts. Click it and stay quiet for 3 seconds: the label shows Calibrating, then Calibrated. Use it if WoW Chat keeps saying Nothing heard, or picks up background noise, for example if someone was talking when it started or your room has got louder or quieter.
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
- WoW must be running. WoW Chat brings it to the front to type, and types nothing if it can't. Check the label: it says WoW isn't running or Couldn't switch to WoW.
- If WoW runs as administrator, Windows stops normal programs from typing into it. Run WoW normally, or run WoW Chat as administrator too.
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
- Is the addon installed? The Dashboard shows Install the addon if not.
- After installing it the first time, quit WoW completely and start it again. The Dashboard reminds you if WoW hasn't loaded it yet.
- Then log in, type
/reload, and click Refresh list.
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"
- Stay quiet during the 3-second calibration at start-up. If you weren't, open the Dashboard, click Recalibrate mic and stay quiet for 3 seconds.
- Check your mic is the Windows default (Settings → System → Sound → Input) and its volume isn't too low.
- Still failing? Set a fixed
"SilenceDb": -45in the settings file. Lower numbers let quieter sound through.
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
- Your voice stays on your PC. After the one-time downloads, Whisper runs on your own computer, and nothing is uploaded. The optional AI cleanup uses Ollama, also on your own PC.
- The history folder keeps the text of everything you've said, so you can check what was sent. Recordings aren't kept unless you turn
KeepAudioon. Delete the folder whenever you like, or set"History": { "Enabled": false }. - The addon only keeps a list of the channels your characters are in, saved in WoW's own settings folder.
- WoW Chat only types what you say, when you press a key, just as if you'd typed it yourself. It doesn't play the game or send anything on its own.