Text To Speech Monitor and WoW Addon
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Type Name Latest commit message Commit time
Failed to load latest commit information.


Monitor and WoW Addon • Download

  • Text to Speech Monitor 2.6.16 (2018-11-10) • Digitally Signed
  • Text to Speech “World of Warcraft” Addon 2.3.3 (2018-09-24)

Reads quests and chat messages with text-to-speech voices. Program will choose correct gender and applies special audio effects depending on character class. Makes game more immersive and you will not miss messages in chat. If “Monitor” doesn't work, you may need to disable IPv6 in WoW game. Read... Problems and Solutions.

How it works: When you open window with text (dialogue, quest, book, etc.) or receive chat message in game, WoW “Addon” creates and sends message to you between <message><part>text</part></message> tags. This message can include text, name, gender, effect, group, pitch, rate, volume, etc. and command value. Then, “Monitor”, which must be running in background, while gaming, picks-up this message from your local network traffic, converts it to SAPI XML and reads it with specific text-to-speech voice.

To move mini frame with [≡][■] buttons: Move mouse pointer over [■] button. [≡] (Options) button will appear. Click on [≡] (Options) button, to open “Options” window. Unlock mini frame by unchecking first check-box in “Options” window. You can move “Options” window out of the way, if it is on top of mini frame with [≡][■] buttons. Move mini frame by clicking on black background around [≡][■] buttons. Lock it again, by checking the same check-box.

Old “Monitor” and “WoW Addon” versions.
To show WoW's ( Version / Interface )... paste in chat: /run print((select(4, GetBuildInfo())));

You can create your own text-to-speech addon (if game supports addons) or send messages directly to “Monitor” from your own game, to add text-to-speech feature to your game. We don't mind if code from our WoW Addon will be used to add text-to-speech features to other addons. How and what messages to send with SendAddonMessage(...) in WoW, so “Monitor” could see them, can be founded in our addon's lua file. These messages can be visible in chat window, if check-box “Hide addon <messages> in chat window” is unchecked in our addon's “Options” window. Messages are also visible in “Options” window itself and in “Monitor”'s [1. Incoming Messages] tab. If other addon will take over one of the text categories, this category can be disabled in our addon, by unchecking corresponding check-box, to avoid text-to-speech duplication. There is also help about <messages> with examples in “Monitor”'s [Help] tab or JocysCom.TextToSpeech.Monitor.rtf document • Tested on Windows 8 and 10 • All code is available under open source licence.

FREE text-to-speech voices can be installed with Microsoft language packs.
BETTER text-to-speech voices are developed by and distributed by

YouTube video ... “WoW Addon” ( very old 2014-08-06 version ) with Ivona voices

addon video

Security and concerns • Why it is not on Curse?

It is not on Curse, because of “Monitor”, which is external program. Blizzard has no control outside the game over “Monitor” and, reasonably, can't take responsibility for it, by allowing it on Curse. Therefore, we keep everything as transparent, as possible. This project is open source and anyone can check all code at any time. We digitally sign our software and put our real names on it, so everyone could know, who to blame, if something will go wrong. “Monitor” and “WoW Addon” does not give you more power over NPCs or other players in game. It does not send data back to game or anywhere else. It only reads local network messages between <message> tags or text from your clipboard with installed text-to-speech voices, when you want it. It makes game more involving, fun and interesting (especially for those people, who played WoW from the first day, when it was released… like us. It became slightly boring to read all quests after some time). Also, it makes game easier for people with dyslexia or visual impairments. We are grateful, that gods from Pantheon of Blizzard are merciful enough not to block “WoW Addon” and let people use it :). Please download this “WoW Addon” and “Monitor” only from trustworthy sources. Make sure that “Monitor” is always signed by verified publisher with signature, issued by trusted certificate authority.

Installation • Exit WoW before installing or updating addon

1. Download file.
2. Open “File Explorer” (Win+E), locate downloaded file and open it.
3. Copy “JocysCom-TextToSpeech-WoW” folder (folder is inside downloaded zip file).

4. Paste “JocysCom-TextToSpeech-WoW” folder inside “AddOns” folder of WoW.

Usual directory: C:\Program Files\World of Warcraft\Interface\AddOns

5. Install additional text-to-speech voices, if needed.

BETTER text-to-speech voices are developed by Ivona and distributed (~$45 each) by Harpo Software.
Download and test voices 30 days for free from distributor Harpo Software.
Good Ivona voices are English-British “Amy” and “Brian”. Some other voices are not bad too. If you know free of charge text-to-speech voices as good, as voices by Ivona, please, write us.

FREE text-to-speech voices can be installed (on Windows 8.#) with Microsoft language packs. 1. Right-click the “Start Button” > Control Panel > Language.
2. Add additional languages like... English (United States) or English (United Kingdom)... etc.
3. Go to “Options” of each language and... [ Download and install language pack ].

Not all languages have text-to-speech voices. To switch between languages in Windows, you can use (Win+Space).

Windows 8.1 language packs and text-to-speech voices (Wikipedia):

• English (United States) - David (male), Zira (female).
• English (United Kingdom) - Heera (female), Hazel (female), Zira (female).
• Chinese Simplified - Hanhan, Huihui.
• Chinese Traditional - Tracy.
• French - Hortense.
• German - Hedda.
• Japanese Haruka.
• Korean - Heami.
• Italian - Elsa.
• Polish - Paulina.
• Portuguese - Maria.
• Russian - Irina.
• Spanish - Helena, Sabina.

When you will run “JocysCom.TextToSpeech.Monitor.exe”, additional text-to-speech voices should be visible now.

6. Run “JocysCom.TextToSpeech.Monitor.exe” file (file is inside pasted folder).

Usual directory: C:\Program Files\World of Warcraft\Interface\AddOns\JocysCom-TextToSpeech-WoW\

You can pin “Monitor” to Windows OS taskbar, if you plan to use it frequently. Administrator rights are required to run this program. Make sure that you are using digitally signed software. Any modification in code of software, after it is signed, invalidates digital signature. Digitally signed software ensures that users can verify origin of software and that no one has tampered with it.

7. User Account Control window must show “Verified Publisher:” or “Verified Publisher: Evaldas Jocys”.

Do not trust executables from “Publisher: Unknown”.

8. Click [ Yes ] button.

“Monitor Clipboard” option doesn't work and must be [Disabled] in Windows XP.
“Addon” requires latest version of “World of Warcraft” game.

9. When “Monitor”, will open, setup voices in [Voices] tab (example).

3 voices are enabled in this setup:
“IVONA 2 Brian” -- will be used as Male (100) and Neutral (100) voice.
“IVONA 2 Amy” -- will be used as Female (100) voice.
“Microsoft Hazel Desktop” -- will be used as Neutral (50) voice.

Number ( from 0 to 100 ) sets, how often voice should be used, relatively to other voices in the same category (Male, Female or Neutral). If you have IVONA male and female voices, you can disable “Microsoft (...) Desktop” voices ( as they are quite bad ).

Monitor can't play voices, if their trial period is expired. You can test, which ones are expired, by enabling one voice at a time and pressing [ Speak ] button in Monitor. Such voices must be disabled in [ Voices ] tab.

Speed of voices can be adjusted in “Monitor's” “Rate” fields. Values can be from “-10” (very slow) to “10” (very fast). Default value is “2”. You can select “1” or “0” in both fields to make voices slower.

10. Run “World of Warcraft” game.

11. [■] (Stop text-to-speech) button will appear at the center of the screen. If you will move mouse pointer over [≡] (Options) button, menu with various check-boxes will appear. Move mouse pointer over any check-box and title will show, what it enables/disables.

To move mini frame with [≡][■] buttons: Move mouse pointer over [■] button. [≡] (Options) button will appear. Click on [≡] (Options) button, to open “Options” window. Unlock mini frame by unchecking first check-box in “Options” window. You can move “Options” window out of the way, if it is on top of mini frame with [≡][■] buttons. Move mini frame by clicking on black background around [≡][■] buttons. Lock it again, by checking the same check-box.

If “Social-Friends” button is not visible:
1. Open JocysCom-TextToSpeech-WoW.xml file with Notepad.
2. Find and change "QuickJoinToastButton" to "UIParent"
3. Reload WoW. -- [■] (Stop) button should appear at the top-center of your screen. You can unlock [■] (Stop) button in [≡] (Options) and move it to desired position.
Usual file directory: C:\Program Files\World of Warcraft\Interface\AddOns\JocysCom-TextToSpeech-WoW\
  1. [■] (Stop) and [►] (Play) buttons will appear at the bottom of some windows too.

13. “Addon” gets genders of targeted (you are interacting with) NPCs. “Addon” also gets conversations-chat, but not genders of NPCs, who are walking and talking around you. Therefore, “Addon” automatically saves every NPC (name, gender and type), which you are targeting, in “Monitor“ (must be running in background). Also, if slot is available, “Addon“ will create “NPCSaveTTSMacro” and will update it during the game. You can use this macro to target at once up to 9 last chatting NPCs or any nearest friendly NPC (to save them in “Monitor“). Saved in “Monitor“ NPCs have genders (male and female voices) in their conversations. I didn't figure out yet, how to get NPCs genders directly from NPC chat event or some database (although, there is no problem with players). For example: If you see two female NPCs chatting, but they have male voices... just click on them (or use macro to target them) and they should get female voices from that moment. Enter /m in chat window to show macros:

Usual per-account settings directory:
#:\Program Files\World of Warcraft\WTF\Account\<AccountName>\SavedVariables\JocysCom-TextToSpeech-WoW.lua
Usual per-character settings directory, where Addon settings are saved:
#:\Program Files\World of Warcraft\WTF\Account\<AccountName>\<RealmName>\<CharacterName>\JocysCom-TextToSpeech-WoW.lua
You can delete these files to reset settings or clear saved NPCs (game must be closed).

“Stop text-to-speech” macro and hotkey setup in “World of Warcraft” game

1. Game Menu > [Macros] > [New]
2. Enter macro name (for example: “Stop TTS”).
3. Choose an icon for macro.
4. Click [Okay] button.
5. Write in “Enter Macro Commands” field:

/run SendChatMessage("<message command=\"stop\" />", "WHISPER", "Common", UnitName("player"))

6. Click [Save] button.
7. Drag “Stop TTS” macro icon from “General Macros” tab on desired “Action Bar” button.
8. Click [Exit] button.
9. Game Menu > [Key Bindings] > [Action Bar]
10. Bind desired keyboard key to "Action Bar" button with “Stop TTS” macro. After pressing this key on keyboard, text-to-speech will stop.

Network problems and solutions

Sometimes, “Monitor” doesn't work with “Internet Protocol Version 6” (IPv6). To test this, you can:

A) Disable IPv6 in latest version of “World of Warcraft” game:

1. WoW Main Menu > System > Network > Uncheck (disable) “[ ] Enable IPv6 when available” check-box.
2. Restart WoW game.


B) Temporary disable IPv6 on your network card:

1. Close WoW game and “Monitor”.
2. Click [Win]+[X] keyboard keys together.
3. Select “Control Panel” from menu.
4. Select “Small icons” in “View by:” drop-down menu.
5. Find and select “Network and Sharing Centre”.
6. Click on “Change adapter settings”.
7. Click with second mouse button on network card, you are using.
8. Select “Properties” from menu.
9. Uncheck (disable) “Internet Protocol Version 6”.
10. Click [ OK ] button.
11. Run WoW game and “Monitor”.

Don't forget to enable (check) “Internet Protocol Version 6” again later.

Cache Options in “Monitor” (Create text-to-speech audio files)

If your computer is slow, you can use “Monitor's” “Cache Options” to write and read audio files. The next time, when you will encounter the same dialogue-text, “Monitor” will not use TTS voices and will not create audio file again, but will play instantly previously created audio file instead. If you put custom recorded MP3 file with the same name then "Monitor" will play MP3 file, instead of WAV.

“Monitor” > [Options] tab > “Cache Options” section

Usual directory for audio files: C:\ProgramData\\Text to Speech Monitor\Cache\

Desired improvements in “World of Warcraft” game

• Getting UnitSex of NPC from chat and quest log -- no need to select it to get gender.
• Getting UnitAge of NPC (%) -- (1-100) in order to apply “Child", “Adult” or “Senior” effects.
• Getting UnitRace of NPC -- Sound effects on NPCs are applied by UnitCreatureType now.
• Getting value if NPC has voice over for all text -- in order not to start TTS speech.
• NPC “talking” animation should loop, depending on length of the text.