KQuote allows you to "send" audio quotes through WoW's chat channels.

KQuote is based on WoWQuote by Lev@Die Ewige Wacht and Harag@Die Ewige Wacht. Many thanks to both of them!

KQuote can't really send audio to other players though. Instead it will post a normal text message into the chat channel, which contains an ID of the desired quote.
Provided the receiver has KQuote installed, it will recognize that ID and play the appropriate sound.

What's new in KQuote
How to update from WoWQuote
Usage / Console Commands
Create Media AddOns
Tools needed
Step by Step
Common Problems

What's new in KQuote

Contents

KQuote introduces some new features over WoWQuote (v0.x):

Mute

Use /kqm to mute KQuote. Typing /kqm a second time will re-enable playback. This setting is not remembered after logout.
You may assign a key to this function, using WoW's Options – Key Bindings dialog.

Tags

Instead of a single category for a quote KQuote uses tags. The difference is that a quote may have multiple tags assigned to it.

Search Field

There's a text input field in the upper right of the KQuote window. Entering a search term will filter the quote list to only display quotes that contain that term. This does work in combination with the tag pop up.

Quick Search

Adding a search term at the end of the /kq command will insert that term into the window's search field. /kq -t <tag> will select the corresponding entry in the tag pop up menu. Read more here.

Separate Media AddOns

For KQuote I moved the actual media data to separate add-ons. There are several advantages to this approach:

There's no need to re-download audio data for every small change to the main add-on.
It is possible to create additional media add-ons that can be loaded and updated without affecting already existing quotes.

Read more about creating media add-ons here.

How to update from WoWQuote

Contents

KQuote is backwards compatible to WoWQuote (Fan-Update 0.9c).
It will recognize and playback all quotes from the original version. Also, quotes will be sent so that the older WoWQuote is able to play them — provided they did exist in that version of course.

Usage / Console Commands

Contents

KQuote does not usually display a user interface. It's working in the background, catching quotes and playing the appropriate audio files.

To send audio quotes yourself, you either use console commands directly or you open the selection window — also by issuing a console command.

/kq [<search term>|-t <tag>] modified in KQuote: Open or close the selection window.
A given search term will be entered into the search field, a tag will select the appropriate entry in the tag pop up menu.
/kqh: Print a list of chat commands.
/kqm new in KQuote: Mute playback. This setting is not saved between sessions. Playback is always on when you log in.
/kqc [<channel>] ["on"|"off"]: Display or change channel settings. Channel may be one of: s(ay), p(arty), r(aid), g(uild) or (o)fficer. This setting is retained between sessions.
/kqt new in KQuote: Print all tags with descriptions. The tag description is what you can see in the tag pop up menu.
/kql <tag> modified in KQuote: List all quotes that are tagged with <tag>.
/kqf <search term>: List all quotes that contain <search term>.
/kqa [<alias> [<quote id>]] modified in KQuote: Create an alias for a quote. In case the quote id is omitted, the given alias will be deleted.
/kqs <quote id|alias>: Post to your surroundings.
/kqp <quote id|alias>: Post to the party channel.
/kqg <quote id|alias>: Post to the guild channel.
/kqr <quote id|alias>: Post to the raid channel.
/kqo <quote id|alias>: Post to the officers' channel.

Create Media AddOns

Contents

Media AddOns require KQuote to function. Still, technically they are the same as stand alone add-ons.
That is they follow the same folder structure and are installed in exactly the same way.

Tools needed

Contents

an unarchiver for ZIP files
a text editor that is able to read and write files with UTF-8 encoding
(for Windows there is e.g. notepad2; on a Mac you may simply use TextEdit)
audio files for your quotes ;)

Step by Step

Contents

Download this Media add-on template (KQMediaTemplate.zip, 6 KB).
Unzip the archive and replace the text "Template" in the folder's name with a term that fits your new add-on. (The resulting folder name might be something like "KQMediaMine".)
The file names of the two files inside that folder (KQMediaTemplate.toc and MediaTemplate.lua) need also be changed accordingly.
Open the .toc file and replace all occurences of "Template" with your new name. You should also update the remaining tags like Author, URL and Title.
Now open the .lua file and replace all occurences of "Template" in that one too. (All affected lines are marked with !!!.)
Then locate the line local moduleid = "tpl"; and replace the tpl with a key for your add-on. This key needs to be unique. You can only use one media add-on with the same key at any one time. In addition, the key should be as short as possible, since it is part of the quote id that will be posted to the chat for every quote.
Next, find these lines …
-- replace this list of data with your own
-- end of media data
… and between them add the meta data for your quotes. You can find a description of the necessary format here.
As a last step you need to copy the audio files for your quotes (in MP3 format preferably) into the media folder inside the add-on's main folder.

You now have your own media add-on for KQuote!

Move it to WoW's AddOns folder and restart WoW. Make sure the add-on is actually activated and log in. You should now be able to select and play your new quotes. All that is left is to distribute your new add-on to your friends. :)

Media Meta Data

Contents

A media add-on's .lua file contains meta data about all its quotes. Each entry for a quote looks like this:

{
    id = "tpl:02",
    file = "secondfile.mp3",
    len = 4,
    msg = "Description for second file",
},

The id consists of the add-on's key followed by a colon and an index number.

file is the name of the audio file inside the media folder.

len is the length of the quote in seconds.

msg is a short description for the quote.

Optionally, an entry may have one or more tags assigned:

{
    id = "tpl:02",
    file = "secondfile.mp3",
    len = 4,
    msg = "Description for second file",
    tags = {"hi", "rogue"}
},

This quote will be listed under Hi and Rogue. You can find the definitions for the standard tags in the file Localization.lua inside the KQuote folder.

Common Problems

Contents

The AddOn does not load.

Make sure that …

… the name of the .lua file mentioned inside the .toc file matches the actual file name.
… you did indeed replace all occurences of Template with your new name.

WoW displays an error on log in.

Make sure you didn't make any changes in the .lua file that result in a syntax error — like removing a comma or semicolon for instance.

One or more sounds won't play.

WoW can play sound files in MP3 or WAV format only.
Make sure all file names inside your .lua file match the names of the actual sound files inside the media folder.

Umlauts or other special characters don't display correctly.

The .lua file must be saved using UTF-8 encoding. Check the settings of your text editor.