Tags Tab Help

This tab is used to create new tags. A tag defines a search on incoming notifications and makes Buzzby play a selected sound when a matching notification appears.

What does a tag look like?
What about other tags?
How complex can a rule line be?
What happens when I tap 'Save'?
Can I change the ruleset later?
See the entry in the manual

What does a tag look like?

Suppose we have various sources of information providing notifications (Twitter, Facebook, Google+, email, SMS, etc.), and that we want to know immediately a notification appears that mentions a particular topic. This new "TAG" tab lets you set up that "future search" easily.

The top part of the panel is for choosing a sound which will be played when an incoming notification matches your search terms. A short sound file from somehere on your phone or a notification sound should be used. If you have time, you might consider recording a quick message specific to the search and then using that recording as the sound file.

For this example, let's suppose we want to know about notifications containing reference to the Nexus 5X phone. We would fill in the details to get something like this:

As soon as we tap the "Save" button the rules in the tag will become active and any new notification which contain "Nexus" and "5X" will cause the sound file to be played.

When we are no longer interested in tracking these terms, we can just delete the tag.

What about other tags?

You can see a list of all tags from the 'Tag list' button that appears when you you choose 'Aditinal Functions' from the menu:

From the tag list you can edit any tag or look at and edit the component rules in a tag.

How complex can a rule line be?

You can have multiple "words" separated by a space as an 'and' operation. Use a plus sign as an 'or' operation, and parentheses to organise precedence. 'and' has precedence over 'or'.

Some examples should help.

"pigs might fly" uses the 'and' operator twice, so it means the tickertext must contain all three words 'pigs', 'might' and 'fly' to match this rule line.

"pigs+might+fly" uses the 'or' operator twice, so it means tickertext containing any of the words 'pigs' or 'might' or 'fly' would match this rule line.

"water runs+downhill" will match any tickertext which contains both the words 'water' and 'runs' or any tickertext which contains the word 'downhill'. The space takes precedence over the plus sign.

"water (runs+downhill)" uses parentheses to overcome the natural precedence of the previous example to get an entirely different meaning. Now the rule matches any ticker text which contains both 'water' and one of either 'runs' or 'downhill'.

When you press the 'Save' button Buzzby checks each rule line for operator or parenthesis problems and shows a reddish background on lines it can't understand. You can then alter such lines and press 'Save again'.

What happens when I tap 'Save'?

Buzzby checks each non-blank rule line to see if it understans it.

It checks that the tag name is not blank.

If all is well, Buzzby forms the non-blank rule lines into extraction rules and creates a matching sound rule for each extraction rule. The rules are all assigned the tag name in the panel so that they can be found again.

From that point on the rules are all active against incoming notifications.

Can I change the ruleset later?

Yes, when you are viewing the list of tags from the Options tab you can tap on a tag name and Buzzby will show the panel with the tag name, selected sound, and rule lines.

When you make ruleset Buzzby creates a set of extraction rules and a matching set of sound rules. As a result, only tags which have exactly the same number of extraction rules and sound rules (and have zero filter and buzz rules) are editable through this special panel.

When editing an existing ruleset you can delete the whole ruleset (with the 'Delete' button), change the selected sound, change the tag name, or alter/add/remove rule lines. A rule line is removed by blankng it.