TextSpy

From WowAce Wiki

Allows you to define a text search to watch for. When your chatbox contians those words, TextSpy will alert you by playing a sound.

• Supports your own custom sounds.
• Supports pattern matching: WoWWiki Guide to Pattern Matching
• Supports notification output to SCT, Parrot and MSBT
• Configurable with both Waterfall and Niagra

Contents 1 Examples 2 Custom Text "Captures" 3 Setting Up TextSpy 4 TextSpy in Action 5 Getting In Touch 6 Adding Custom Sounds 7 Menu Overview

Examples

• Play a sound every time one of your auctions sells
  

==Search==
your auction of.*sold
==Sound==
chaching.wav

• Enable WoW sound option's "Sound in background" and you tab out of the game with an alert that you have gone afk
  

==Search==
you are now afk
==Sound==
zomgimafk.mp3

• If you're wanting to watch for the name of an item, just type the name of the item in the search box. There's no need to use an item link. The following search will find people selling a Sentry Cloak, for example.

==Search==
wts.*sentry cloak
==Sound==
howmuchforthat.wav

Custom Text "Captures"

Refer to final section of this page for more information on how Captures work.

In order to use part of the text found in your scrolling text output, you will need to use a pattern match Capture. This can be done by enclosing part of your search string in parentheses.

Chat contains:    Your auction of Wool Cloth sold.
Your search text: your auction of (.*) sold
Saved text:       Wool Cloth

In this example, the .* will match any text between the words 'of' and 'sold'. The parentheses define the matched text as a Capture. TextSpy can save the captured text for you to use in the Custom Text field of the trigger's scrolling text output options.

In order to put whatever you captured into the custom output, you would enter %s. You can place the %s anywhere you would like in the custom text field.

Saved text:  Wool Cloth
Custom Text: Auction Sold: %s.
Output:      Auction Sold: Wool Cloth.

At this time, TextSpy will not let you Capture multiple times in a single trigger.

Setting Up TextSpy

Right click on the FuBar icon/text to access the configuration options.

• If you have Waterfall installed, you can left click on the FuBar icon/text to open a GUI configuration window.
• If you have Niagra installed, you can access this addon's options under the Chat/Communication section of the Niagra menu.

See the menu overview for a list of options and what they do.

TextSpy in Action

http://i6.tinypic.com/6h4kolw.jpg

Getting In Touch

To submit bug reports and feature requests, please use the TextSpy forum topic.

Adding Custom Sounds

You can use both .wav and .mp3 files (some users report being able to use other sound formats), and it is best to keep them short (1-2 seconds in duration) to prevent overlapping sounds if you get a lot of triggers going off. Place them in the \media\audio subdirectory of the TextSpy install path. Restart WoW and type the name of the custom sound in the audio file editbox of the trigger's menu you want to use the sound with. There is no need to type anything except the filename. Be sure to check that you have the same upper- and lowercase letters as the filename.

<WoW Install Path>\Interface\AddOns\TextSpy\media\audio\yoursound.mp3
<WoW Install Path>\Interface\AddOns\TextSpy\media\audio\yourothersound.mp3
<WoW Install Path>\Interface\AddOns\TextSpy\media\audio\yoursoundagain.wav

Menu Overview

"Monitor Chat"
	If checked, TextSpy will monitor the chatwindow for your enabled triggers.
	If not checked, TextSpy will not monitor the chatwindow.
"Enable Audio"
	If checked, all enabled triggers will play their sound files.
	If not checked, no triggers will play their sound files.
"Suppress SCT/Parrot/MSBT Output" (Only shown if you have SCT/Parrot/MSBT installed)
	If checked, turns off all trigger output to SCT/Parrot/MSBT.
	If not checked, allows triggers to individually allow/disallow output to
	SCT/Parrot/MSBT.
"New Trigger"
	This option will create a new trigger with the default settings.
	A menu option Trigger Settings will appear to allow editing the new trigger.
"Trigger Settings"
	Opens a submenu containing the names of any triggers you have created.
	Move your mouse onto the name of a trigger for its options.
		"Trigger Enabled"
		|	If checked, this trigger will be searched for.
		|	If not checked, this trigger will not be searched for.
		"Enable Audio"
		|	If checked, this trigger will play its associated audio file.
		|	If not checked, this trigger will not play its associated audio file.
		"Case Sensitive"
		|	If checked, the text you type in Trigger Text will only match if the
		|	words have identical upper- and lowercase letters.
		|	If unchecked, words will match no matter what case they are in.
		"Trigger Name"
		|	This is the text which appears on the Trigger Settings submenu.
		|	You can simply edit this text.  PRESS ENTER WHEN DONE.
		"Trigger Text"
		|	This is the text which this trigger will search for if enabled.
		|	You can simply edit this text.  PRESS ENTER WHEN DONE.
		"Trigger Sound"
		|	The sound file which the trigger will play if the Trigger Text is seen.
		|	Place custom sound files in the \media\audio\ subdirectory of the
		|	TextSpy install path.  You can simply edit this text.  PRESS ENTER WHEN DONE.
		"SCT/Parrot/MSBT Options" (Only shown if you have SCT, Parrot, or MSBT installed)
		|	Opens a submenu containing the options for SCT/Parrot/MSBT output
		|		"Enabled"
		|		|	If checked, this trigger will send a message to SCT/Parrot/MSBT.
		|		|	If not checked, this trigger will not send a message to SCT/Parrot/MSBT.
		|		"Custom Output"
		|		|	If checked, the text sent to SCT/Parrot/MSBT will be what you have
		|		|	typed into the Custom Text field below.
		|		|	If not checked, the name of the trigger will be sent as the text.
		|		"Custom Text"
		|		|	This option appears only if you have a check next to Custom Output.
		|		|	You may enter here whatever text you want this trigger to disply in
		|		|	SCT/Parrot/MSBT.  If left blank, the name of the trigger will be sent.
		|		|	PRESS ENTER WHEN DONE.
		|		"Crit Modifier"
		|		|	Parrot, SCT, and MSBT allow a message flagged as a critical strike.
		|		|	This normally gives an animation and/or size increase in the text,
		|		|	making it more prominent.
		|		|	If checked, this trigger will show as a critical strike when sent.
		|		|	If not checked, this trigger will not show as a critical strike when sent.
		|		"Output Frame"
		|		|	A list to choose from will be shown of the available output frames.
		|		|	Parrot and MSBT should show up any custom frames in the list.
		|		|	SCT has three frames, but a fourth will be in the list if you have
		|		|	SCT+SCTD installed.
		|		|	The message will be shown as defined by your SCT/Parrot/MSBT settings
		|		|	for those frames.
		|		"Color Setting"
		|			Defines the color of the text to use when displaying the message.
		"Delete Trigger"
			Click this to remove this trigger.
"Global Settings"
	This menu contains the default options that all new triggers will have.
	It contains most of the options under Trigger Settings above.
"Short Label"
	If you place a check here, the FuBar label will only show [ON] or [OFF],
	instead of TextSpy[ON] or TextSpy[OFF].