Filters
Filters are used to redirect incoming chat into custom channels. This is done through the use of regular expressions (regex). Filters are saved per-server and can be created via the server settings panel.
To create a new filter, right-click on the * channel tab to access TabbyChat's settings. Then click on the Server tab and click "New" in the Filters section. This will create a new empty filter. Click edit to edit it.
The edit screen contains many settings for the filter that effect its behavior and display. Edit the settings and click "done" to save and go back to the server panel. Clicking "Cancel" will discard changes. The settings and their descriptions are as follows.
| Name | Description |
|---|---|
| Name | The filter's name for identification |
| Destinations | Comma separated list of channel names |
| Destination is PM | Whether the destination channels be considered PMs |
| Hide Matches | Hides the message from chat if it matches |
| Audio Notification | Plays a sound when this filter triggers. Textbox below is used to pick a sound. Button to the right tests it. |
| Expression | The regex pattern that will trigger this filter. You will be told of invalid patterns as you type. |
Expressions, aka regex, is a way to match varying texts. More information can be found at http://www.regular-expressions.info/. You can test your patterns at http://regexr.com/
If you include groups in your expression, you are able to use them in Destinations. The channel name should be a $ followed by the group number. For example, \[([\w\d]+)\].+ will match [great] hello. Setting the destination channel to $1 will send it to a new tab great.
TabbyChat comes by default with some variables that can be used in patterns. In order to use them, the variable must be in the format of ${variable}. Current variables are:
- player
- onlineplayer
Any variable used that doesn't exist will simply be ""