Installation ... Exit WoW before installing or updating “Addon”

1. Download JocysCom-TextToSpeech-WoW.zip file.
2. Open “File Explorer” (Win+E). Locate and open downloaded zip file.
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: #:\Program Files\World of Warcraft\Interface\Addons\

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

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

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

Usual directory: #:\Program Files\World of Warcraft\Interface\Addons\JocysCom-WoW-TextToSpeech\

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. Digitally signed software ensures that users can verify origin of software and that no one has tampered with it. Any modification in code of software, after it is signed, invalidates digital signature.

7. User Account Control window must show “Verified Publisher: Jocys.com” 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).

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[■] button, [≡] (Options) button will appear. If you will move mouse pointer over [≡] button, menu with various check-boxes will appear. Move mouse pointer over any check-box and title will show, what it enables/disables.

12. [■] (Stop) and [►] (Play) buttons will appear at the bottom of some windows too.

13. “Addon” can’t get NPC’s gender from chat (if NPC is walking and talking around you). “Addon” can get NPC's gender only, when NPC is targeted (if you are interacting with NPC). Therefore, “Addon” automatically sends name, gender and type of all NPCs, you are targeting, to “Monitor“ (“Monitor“ must be running in the background). “Monitor“ saves this information and uses it to generate text-to-speech voices. Saved in “Monitor“ NPCs have genders (male and female voices) in conversations. You can see saved NPCs in “Monitor's“ [Voice Defaults] tab. If macro slot is available, “Addon“ will create “NPCSaveTTSMacro” and will update it during the game. You can use this macro to target up to 9 last chatting NPCs or any nearest friendly NPC (this will save them automatically in “Monitor“). I didn't figure out yet, how to get NPC’s gender directly from NPC chat event or some database (there is no problem with getting genders of players from chat). For example: If you see two female NPCs chatting, but they have male voices... just target (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:

“Stop text-to-speech” macro and hotkey setup in “World of Warcraft” (optional)

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 “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.

...OR...

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\Jocys.com\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.