Cookie F Y I

Short Description:

Personal F Y I Bot

Full Description

**Saved for convenient Locating. No changes made.**

Short Description:

Keep everyone in your room up-to-date with your latest news, rules and/or promotional offers...
Full Description

*NEW FEATURES* Added 12/12/13 See also *NEW* F A Q s

Enter up to three notices and have FYI cycle through them at a rate that can be time-based, chat-based or tip-based.

Choose different colors, background colors and font weights for each notice.

Block common forms of chat spam.

Quick Start:

FYI is a notification bot that will cycle through up to three different notices of your choice, at a rate of your choosing.

You only need to make two decisions on the settings page, before clicking the Start Bot button, in order to use FYI, (1) what 'news' notice you want repeated, and (2) how often it repeats.

To change either, while the bot is running use the following two in-chat commands:

/fyi text - sets the 'news' notice content to text

/fyi number - sets the repeat rate for notices to number (default 25, 0 to temporarily suspend notifications)

All other configuration decisions give you more control but can be safely ignored, if you just want a 'news' notice displayed repeatedly in chat.

Launch Bot Settings vs In-chat Commands:

The contents of each notice, their look, and how FYI repeats them can all be configured on the Launch Bot settings page before you start FYI, or altered while it is running using in-chat commands.

The difference is that configuration changes made using in-chat commands while FYI is running, revert back to the choices made on the settings page, whenever it is re-started.

For this reason, it is recommended that you configure the content and style of notices on the settings page, and reserve in-chat commands for changing how they repeat while the bot is running.

However, there is nothing to stop you using in-chat commands, if you want to change a notice's content and, or look while FYI is running, as long as you bear in mind that those changes will be lost when the bot is re-launched.

Changing How Notices Repeat:

FYI can repeat notices after a certain number of messages have been posted into chat, or after a certain number of minutes have elapsed, or after a certain number of tips have been received.

The 'certain number' is the repeat rate that you configure on the settings page, where you can also choose between the three repeat modes.

There are more in-chat commands that allow you to switch between the different repeat modes, while the bot is running, and an alternative to /fyi number for changing the repeat rate:

/chat - switch to a chat activity based repeat rate

/time - switch to an elapsed time based repeat rate

/tips - switch to a received tips based repeat rate

/rate number - sets the repeat rate to number

HINT: Use lower value repeat rates for time-based repeats than for either chat-based or tip-based repeats.

TIP: You can use more than one in-chat command at a time. For instance, /time /rate 5 switches to time-based repeats, repeating every 5 minutes.

Cycling Between Different Types of Notice

As well as a 'news' notice, you can also configure a 'rule' notice and a 'promo' notice on the settings page. In which case, the bot will cycle between them at the repeat rate setting.

There are in-chat commands to change the content of each type of notice:

/news [ text ] - sets the 'news' notice to text (leave blank for no notice)

/rule [ text ] - sets the 'rule' notice to text (leave blank for no notice)

/promo [ text ] - sets the 'promo' notice to text (leave blank for no notice)

Changing How Notices Look:

There are three aspects to how a notice looks: the color of the text, the color of the text background and the boldness of the text.

On the settings page you configure a notice's look by specifying its style using an HTML Style Attribute Value, which is a list of one or more CSS property : value pairs separated by semicolons, for example
color:red; background-color:green; font-weight:bold.

FYI only knows about color, background-color and font-weight CSS properties.

CSS color and background-color values can be either CSS color names, HTML color codes or rgb() colors.

CSS font-weight values can be either normal, bold or bolder.

There are a bunch of in-chat commands to control each aspect of each type of notice's appearance:

/[news]bold - toggles the weight used to display the 'news' notice between normal, bold (the default) and bolder

/[news]color [ value ] - sets the 'news' notice color to value (leave blank for default Chaturbate Orange (#DC5500))

/[news]bgcolor [ value ] - sets the 'news' notice background color to value (leave blank for default Chaturbate Dark Blue Background (#D5EBF8))

/rulebold - toggles the weight used to display the 'rule' notice

/rulecolor [ value ] - sets the 'rule' notice color (default White (#FFFFFF))

/rulebgcolor [ value ] - sets the 'rule' notice background color(default Red (#FF0000))

/promobold - toggles the weight used to display the 'promo' notice

/promocolor [ value ] - sets the 'promo' notice color (default Red (#FF0000))

/promobgcolor [ value ] - sets the 'promo' notice background color (default Yellow (#D5EBF8))

Type /help into chat for a reminder of the available in-chat commands.

Type /help followed by style, news, rule, or promo for a reminder of the style and notice type specific commands.

Any command that clashes with that of another app or bot can be pre-pended with fyi, for example /fyihelp.

TIP: Although the three types of notice are referred to as 'news', 'rule' and 'promo', they can be used to display any type of notice you want, using any combination of color, background color and weight you like.

Multi-line Notices:

To configure a multi-line notice, include one or more \n newline escape sequences in the notice content.

For example, you might create a rule notice for your chatroom while the bot is running using

/rule Cam Club Rules: \n 1) You do not talk about CAM CLUB. \n 2) You DO NOT talk about CAM CLUB.

which produces the following notice
Notice: fyi: Cam Club Rules:
Notice: fyi: 1) You do not talk about CAM CLUB.
Notice: fyi: 2) You DO NOT talk about CAM CLUB.

REMINDER: Enter notice content that you want to appear every time you run the bot on the Launch Bot settings page, so that the bot remembers it. Notices entered using in-chat commands are forgotten when the bot is de-activated.

Including Emoticon Images and Special Characters:

As well as \n newline escape sequences, you may also use characters from the extended unicode character set in a notice, by including unicode escape sequences of the form \uXXXX, where XXXX is the hexadecimal code of the unicode character you want to appear.

In addition, any valid Chaturbate emoticon shortcut may be used in notice content.

So, for example,
/fyi :) I \u2665 sexy tip notes. ;)

produces the following 'news' notice:

Notice: fyi: I sexy tip notes.

And as shown, the classic short forms of both wink and smile are converted into their corresponding Chaturbate Standard emoticons.

TIP: Forward slash characters, /, used directly in chat are interpreted by the bot as in-chat command qualifiers. So, if you want to use them in notice content entered via an in-chat command, use their unicode escape sequence equivalent, \u002f, instead.

For example,
/promo \m\u002f rock-chick gets blasted video = 200tks \m\u002f

produces the following 'promo' notice:

Notice: fyi: \m/ rock-chick gets blasted video = 200tks \m/

Additional Settings: Blocking Common Spam

FYI contains a basic version of the spam detecting engine used in both of my anti-chat-spam bots, No Grey Spammers and SpHammer, which, if enabled, will block many common forms of chat spam from appearing in your chat while the bot is running.

/spam - toggles common spam blocking on and off

Using the in-chat command to disable spam blocking, also displays any recently blocked spam messages. So it can be used to check for spam activity, as long as you remember to re-enable it, if you want it to keep blocking spam ;)

Additional Settings: Multi-line Safe Mode:

It can sometimes happen that Chaturbate has problems displaying multi-line notices. The /help command produces a multi-line notice. So if you use it and get no response, re-launch the bot, enabling Safe Mode, to convert all multi-line notices into their single-line equivalents. Unfortunately, in Safe Mode, the single-line equivalents aren't guaranteed to be displayed in the intended order, which can lead to confusion, which is why it is better to run the bot with Safe Mode disabled, if possible.

Running More Than One Copy of the bot:

It is perfectly possible to run more than one copy of FYI at a time, with different notices, appearances and repeat rates. However, there are some things you need to bear in mind when doing so.

The bot settings page only remembers the most recent configuration you enter. So if you start up another copy of the bot any changes you make on the settings page become the latest configuration.

If you don't want the second copy's configuration to over-ride that entered on the first copy's Launch Bot settings page, you need to use in-chat commands to configure the second copy of the bot, instead.

The problem is that you need to qualify the in-chat commands, so they affect only the copy you want to configure.

You qualify an in-chat command by pre-pending it with the slot number into which you loaded the copy of FYI you want to target.

For instance, if you want to change the 'news' notice of the copy of FYI you loaded into Bot #2 slot, type:
/#2news making a list, \n checking it twice; \n gonna find out \n who's naughty and nice...
and to change it's appearance:
/#2newscolor green /#2newsbgcolor red
and to change how it's repeated:
/#2tips /#2rate 5

Notice that all commands need to be pre-pended with the slot qualifier in order to target a particular copy of the bot, but that, because you're targeting a particular slot, pre-pending with fyi is unnecessary.

NOTE: The Active App slot is Bot #0 slot.