Main | Look | Chat Colors | Message Colors | Usercolors | Usericons | Emoticons | Fonts | Chat | Messages | Moderation | Names | Highlight | Ignore | Log to file | Window | Tabs | Notifications | Sounds | Other | Commands | Advanced | TAB Completion | History | Stream Highlights | Hotkeys
This page details some of the settings in the Settings Dialog
Main Menu - Settings). Also try hovering over settings
in the settings dialog itself, sometimes you can get a tooltip with some
additional information. You can open this help in the settings dialog by
clicking on the "Help" link on the bottom left.
You can select what will happen when you start Chatty:
The Look&Feel changes the overall look of the program. The "System" Look&Feel depends on the system you are on, the others are cross-platform. Some Look&Feels also allow you to additionally select a different font size, which affects most of Chatty.
Customize colors of certain types of chat messages. For the general look of the program you can choose another Look&Feel from the "Look" settings page.
You can customize the foreground and background color of messages based on the same message matching rules and patterns that are used for the Highlight system (not all prefixes apply). Add a new item, enter what messages you want to match and select the color you want them to have.
The order of entries can matter, the first color from the top that matches is used.
Note: The default colors are set on the "Colors" settings page.
Note: This feature only changes the message color. Use the Highlight system instead if you want to highlight important messages, have them added to a separate Highlighted Messages window and maybe show a notification or play a sound for it at the same time.
Examples of how to match certain messages, so you can assign it a custom color.
#tailsgaming, starting with
re*:(?i)(?<!practice |debug )\bROM\b(?! hack)
ROM, not preceded by
debug, nor followed by
This allows you to specify your own usercolors for either certain types of users (mod, subscriber etc.) or specific usernames. There are special items that you can use to specify that (to specify a username, just enter it without anything else):
$turbo- Turbo Users
$staff- Staff members
$globalmod- Global Moderators
$anymod- All Admins, Broadcasters, Global Moderators, Moderators and Staff members
$all- All users, this can be used to specify a default color (should be put at the very end of the list)
$cat:<category>- A category from the Addressbook
#<color code>- A Html color code, e.g.
#0000FFfor blue, which can be used to replace colors
$color:<color code or name>- A Html color code or name (names as hardcoded into Chatty, may be different from other programs), e.g.
$color:Bluefor blue, which can be used to replace colors
The order of the
entries in the table matters, because it is checked from the top. If you
were to put the
$all item at the very top, any items below
wouldn't do anything, because the first item would already match all users.
This e.g. allows you to specify what color a user should have when he is
both a subscriber and a moderator (by either putting
If an item is red and has "(error)" appended (e.g. "$color.Blue (error)"), this means the item is invalid. In the example this is because a point has been used instead of a colon, so "$color:Blue" would be correct. This can also happen if it doesn't recognize the given color or the item is just in an invalid format.
botNamessetting, the BTTV API and the FFZ API.
Add entries to the table to show additional icons (
or replace the default icons (all other Types).
The order of the entries can matter, they are looked at from the top:
Addonicons that match are shown, unless you use the
$stoprestriction (see section Restriction below).
Addonwill add an additional badge. All Addon-badges that matche the Restrictions are shown at once.
Turboallows you to define a custom icon for all Turbo badges shown in chat. Accordingly, if you selected
Bitsit would target all variations of the Bits badge.
Other (Twitch)allows you to directly target a Twitch Badge by it's Badge ID/Version, which allows you to replace badges that are not an originally supported Type.
Othertypes selected. This specifies the Badge ID/Version that Twitch uses to identify Badges, which allows you to target any Twitch Badge you want, including a specific variation.
bits/100. If you don't specify a Version, so just
bits, then it matches all versions, in this case it would match all Bits Badges.
serenity) or an addressbook category (e.g.
$cat:vip, which would refer to the category
vip). If you keep this empty, then no restriction is applied.
Addoncarries an implicit restriction, since e.g. the default moderator icons are only displayed if the user is a moderator.
$stopmeans if this icon matches (and is thus used), it stops searching for further
Addonicons. So it's not really a restriction for this icon, but rather a restriction that affects the following icons and can be used to limit the number of
Addonicon before the regular icons. The
$stoprestriction only applies to one group of
Addonicons separately (before or after the regular icons).
$badge:<ID/Version>matches a Twitch Badge a user has. For example
$badge:bits/100will only target users that currently have the 100-Bits Badge. This it not to be confused with replacing the Bits Badge, this merely checks if the user has it.
$cat:streamer $first- Matches users in the Addressbook category
streamerand puts the badge in front of the default ones.
lotsofs- Matches a user by the name
$cat:vip $badge:bits- Matches users in the Addresbook category
vip, but only if they also have a Bits-Badge displayed.
!#channel) to have it displayed in all channels except the one you specified.
$start- Add before all other badges
$mod- Add after mod badge (including broadcaster etc.)
$sub- Add after sub badge
$bot- Add after bot badge
$end- Add after all other badges (same as leaving this field empty)
$other- Add after 'Other' badges (e.g. FFZ Supporter badge)
$other:<id>- Add after 'Other' badge with the specified badge id/version
<id>- Add after Twitch badge with the specified badge id/version
.pngand is recommended to be about 18x18 pixels (because that is the default size). If you specify no image, then the matching default icon is removed.
<working_directory>/img/(Chatty directories help). You can click on
Image Folderto show information about it and rescan to update the list.
$defaultwill use the default image file, that would be shown without defining Custom Usericons. This can be useful if you e.g. want to replace all Badge Types, except for one, so you can define that one to use the default.
httpis interpreted as URL.
Tip: Jump to entries in the table by clicking into a column and start to type. Backspace or wait to get out of the search mode.
Noneto turn off Emoji images altogether.
:mouse:get replaced with their respective Emoji character (and thus image, if a Set is chosen) when entering them into the inputbox.
Emotes added to this list will not be turned into an image, but instead are just shown as their emote code.
The code added to the list has to be the
exact code used internally to find the emote in the messages. Usually this is simply
the emote code as you would type it in chat, but some emotes have a special syntax
that you might not even know (e.g.
\:-?\) as actual code).
It is recommended to use the emote context menu (right-click on an emote in chat) to
ignore emotes, because then the correct code will automatically be added to
Change font and font size by clicking on
Input font is restricted to two fonts by default, because other fonts cause issues due to a bug in Java. The number behind the font is the font size. You can manually change this setting via Setting Commands (as with most settings) if you really need another font, but pay attention to the note about the adverse effects it may have.
<x>seconds of inactivity: If you scrolled up in chat but haven't moved scrollposition in the given number of seconds, it will scroll down if new messages come in. This prevents new messages from being hidden indefinitely if you accidently stayed scrolled up.
The Pause Chat feature stops Chatty from scrolling down when you move the mouse over chat. This can be useful if you want to click specific stuff in a fast moving chat, for example if you are moderating or just want to click on an emote to see what it is.
Please note: This will not work properly until the chat window is filled with text, because only then will Chatty actively scroll down. Also, this only stops Chatty from actively scrolling down, so if e.g. a big message is being timed out and thus shortened, stuff may still move around accordingly (which in that case couldn't really be prevented anyway).
Chat is paused as long as you move the mouse over chat or if you hold Ctrl (and initiated pausing by moving the mouse). A little popup in the top-right will indicate that the chat is paused.
Holding Ctrl basicially acts as if you moved the mouse continuously.
Tip: Click on a username in chat to open the User Info Dialog, which also shows the timeouts/bans and the original messages.
[12:30] Spammer: Deleted spam message Long copy pas..
[23:12] Spammer: spam message (10m)
[23:12] Spammer: spam message (banned)(permanent ban)
[23:12] Spammer: spam message (10m)*
[23:12] Spammer: spam message (banned) [rude tbh]
[23:12] Spammer: spam message (10m) [emote spam]
<name> has been timed out
<name> has been banned(permanent ban)
<name> has been timed out (3).
<name> has been timed out (60s)
<name> has been banned [rude tbh]
<name> has been timed out (600s) [emote spam]
/set timestamp <format>. The format can be anything specified by the Java SimpleDateFormat class.
Advanced - Correct Userlistis enabled). See the Userlist help on more about that.
Extra - Moderation Log. Only works if you are a moderator yourself.
[Info] This room is now in subscribers-only mode. (@tduva).
Extra - AutoMod, where you can also view those messages even if this setting is disabled.
Users can customize the capitalization of their name, or set a localized name for some locales, like Japanese.
Chat messages and the Userlist can be configured separately with the following options:
If you have a Custom Name set for a user, then only that Custom Name will be shown.
Other related settings:
user:prefix with your own name.
Add items to the list to make a message highlighted if any one of them
match the message. The
Users to never highlight and
Highlight Blacklist settings can be used to prevent some of
The following sections list different kinds of prefixes that can modify the behaviour of the system:
By default only regular chat messages are matched, however with the
config:info prefix info messages (e.g. subs, chat status)
can be matched instead.
By default, matching is performed case-insensitive and anywhere in the
message. However, you can add one of the following prefixes in front of
the search text to modify the matching behaviour:
cs:makes it case-sensitive, so
w:matches at word boundaries, e.g.
wcs:is the same as
w:, but case-sensitive.
start:to match at the start, so
start:!betwill match messages starting with
reg:(and variations) to use a Regular Expression (Regex), which are case-sensitive by default:
re*:) will search anywhere in the message.
reg:(?i)\bGTA ?[V5]\bwill match
gta5.. anywhere in the message, case-insensitive (
(?i)), but only on word boundaries (
regi:matches case-insensitive (adds
(?iu)), so the example would be:
regw:matches on word boundaries (surrounds with
\b), so the example would be:
regwi:matches on word boundaries and case-insensitive, so the example would be:
re:) always tries to match the entire message (adds
$), which means
regm:Testwill only match the message "
Test", but not anything added to it, even just a space like "
The following prefix don't match on the text itself, but define other
things that should or should not trigger a Highlight. You can place one
or several of these prefixes before the search text (separated by
[meta-prefix:value] [..] [text-prefix:]<search text>
user:to specify one exact username (case-insensitive) which should highlight only if this user send the message, doesn't search in the message itself.
reuser:to specify a regex to match usernames against. Behaves like the
re:prefix, in that it always tries to match the entire username. Example:
reuser:(?i)a.*would match all names starting with "a".
cat:to specify a category the user who send the message should be in (as defined in the Addressbook).
!cat:to specify a category the user who send the message can NOT be in.
chan:to specify one or more channels the message has to be send in to match (several channels are specified as comma-separated list, without spaces).
!chan:to specify one or more channels the message must NOT be send in to match.
chanCat:to specify one category the channel the message was send in has to be in (as defined in the Addressbook with the name of the channel, including leading #).
!chanCat:to specify one category the channel the message was send in can NOT be in.
status:to specify that the user has to have one of the given status codes (case-sensitive):
rBot as in Robot (depending on what the FFZ/BTTV APIs provides (if enabled) and values in the botNames setting)
MUser with any kind of moderator/special powers (so Broadcaster/Moderator/Global Moderator/Admin/Staff combined)
status:stmatches all subscriber and turbo users.
!status:to specify that the user must NOT have any of the given status codes (see
status:for codes). For example:
!status:stMmatches all 'normal' users that have no badge by default (NOT a Subscriber, Turbo User or any kind of Moderator).
config:to specify on or more options (separated by comma, no spaces):
config:firstmsg- Restrict matching to the first message of this user in this channel during the current session (first message in User Dialog)
config:info- This item applies to info messages instead of regular user messages
config:any- This item applies to both info messages and regular user messages
The following prefixes don't change what is highlighted, but rather
change what a Highlight does. You can place one or several of these
prefixes before the search text (separated by spaces):
[meta-prefix:value] [..] [text-prefix:]<search text>
color:to specify a color other than the default Highlight color for displaying this Highlight (HTML Color Codes as well as some Named Colors such as "blue").
bgcolor:to specify a background color other than the default Highlight background color for displaying this Highlight.
config:to specify one or more options (separated by comma, no spaces):
config:silent- Disable sounds for this item
config:!notify- Disable notifications for this item
Note: If you're using the
prefix to merely change the message color, but are not interested in
actually Highlighting it - which includes a Notification and adding the
message to the Highlighted Messages window - then consider using Custom
Message Colors instead.
When using prefixes that change the behaviour (like setting a color) the order of Highlight items may be important, since the settings of the first matching item (from the top of the list) will be used. Contrary to that, if the choice is merely whether or not to highlight, then the order matter less (it can still matter for which matches in the message are emphasized).
Example: If you have one item
that makes all messages of "Joshimuz" have a yellow background and
start:!bet that highlights all messages
starting with "!bet", then messages from "Joshimuz" that also happen to
be starting with "!bet" will either have a yellow background or not,
depending on the order of the two items in the list, so which one comes
Note: If you have the "Highlight own name" setting enabled, then
it creates a Highlight item containing your name that will always be
checked first. So if you want to e.g. change the color of messages
containing your name as well, then you should disable that option and
manually add an appropriate entry to the list (e.g.
w:<yourname>), so that you can control it's position
in the list in relation to other items yourself.
Word1 word2anywhere in the message
word2anywhere in the message
Helloanywhere in the message, if the message was sent by the user named
Hello user:joshimuzanywhere in the message
Hello, does NOT matter who send the message
abc re:\w+anywhere in the message
abc test, but also NOT
abc testanywhere in the message
Hello S!and makes the message display in yellow color
Hello, but only if in the channel
status:s chanCat:vip start:!test
!testsend by subscribers of the channel, but only if the channel is in the Addressbook category
/ab add #joshimuz vip, notice the leading
Allows you to ignore chat messages that match the specified text or -
using prefixes - that match other properties like ignoring messages of a
specific user. Ignored messages get added to a special dialog that can
be opened via
View - Ignored.
The matching of messages works the same as the Highlights system, please see that help for information on that. For quick reference here just a few examples:
namein all channels
config:info subscribed to
x has subscribed to yinfo messages that you get when someone subscribes in the channel that is being hosted
ignorein all channels, except
!bet, but only in
/ab add #joshimuz subonly, notice the leading
Ignored Users list allows you to ignore
users in chat or prevent them from whispering you, which is possible via
the main ignore list as well, but was added as a separate function to be
more convenient. Aside from the settings, you can also ignore/unignore
users via the User Context Menu.
Ignored users are independant of the main ignore list, so they also apply if ignore is disabled.
user:prefix on the main Ignore list.
As opposed to the Ignore list, which blocks entire
messages from being shown, the Filter only removes parts of a message.
For example if you add
regw:a\w* to the list, it will
remove all words starting with
a from messages in chat and
replace it with
.., which can be hovered over to
show the original text.
An example usage for this could be to shorten bot messages by removing parts that are always the same.
The text matching syntax is the same as for the Highlight list, although you have to remember that only the the parts of a message that match the pattern are removed, so you may have to use it a bit differently than for Highlighting and Ignoring.
It currently only works for regular chat messages (no info messages). It also only uses the matches from the first item in the list that matches any part of the message. This may be changed in the future.
replacement: prefix can be used to change the default
.. the filtered text is replaced with to something
more meaningfull. For example if your entry is
replacement:Wordwitha regw:a\w* then the removed text gets
You can use
replacement:none to output no replacement at
If you enable logging, chat messages (and more if enabled) will be written into a separate textfile for each channel.
You can specify which channels should be logged:
Normal chat messages are always logged, however you can log additional information:
BAN: name1, name2 (30s) [reason], name3 (600s)
DELETED: name1 (msg1), name1 (msg2), name2 (msg3)
MOD: name1, name2
UNMOD: name3, name4
JOIN: name1, name2
PART: name3, name4
Viewerstats (21:03-21:06): avg:28.612 min:28.432 max:28.887 [3/28.519-87+455_]
MOD_ACTION: tduva (host coollertmb)
Main - Exitor the tray icon context menu.
The Events table can contain several entries that describe events and whether they should trigger a Desktop Notification and/or Sound.
The entries are checked from the top and only the first enabled Notification and Sound of matching events are chosen, and then triggered if the Cooldowns allow it (given that any are configured).
Example: You could have two "Highlights" events, the first restricted to a certain channel with a Notification/Sound and the second non-restricted with just a Notification. This way only Highlights in said channel would play a Sound (and maybe have different Notification colors) and all others just show a Notification. Note that if you were to switch those entries, then the channel-restricted one would never be chosen, because the non-restricted one already catches everything. So as a general rule, the more specific/restricted entries should always come first.
Possible event types that can be selected for an entry:
Cooldownto prevent this sound from playing too often.
Passive Cooldownwill only play the sound if enough time has passed since this event was last matched. Or in other words it will reset the Cooldown every time the sound would have been played, even if it actually wasn't because another sound took precedence or the regular
Cooldowndidn't allow it.
Chat Messagewith a
5m, which means the sound only plays if someone writes a message after the chat has been silent for at least 5 minutes. If on the other hand you would set it as a regular
Cooldownit would play the sound after 5 minutes even if the chat has been busy non-stop, at which point you probably wouldn't need to be alerted since you're already paying attention to it.
On both the Notification (Tab) and Sound (Tab) you can enable/disable the according action by choosing one of the following:
There are different types of Notifications:
If you have selected Chatty Notifications:
You can enable or disable all sounds here. Sounds are searched in the
displayed folder, which is the current working directory, although you can
Change it to a folder of your choice. If you added or removed files,
you may have to use
Rescan folder to make the files show up in
the list of sounds selectable in the event settings. You can
the folder in your standard file browser from here to add files to it more
The Output Device lets you choose the device on your computer the sounds gets output to. This is kind of experimental and may not work properly.
Enable this to make Chatty get a list of your followed streams regulary so it can display notifications if their status changes. This simpy allows Chatty to know about your followed streams, so notifications aren't the only advantage. It also allows it to record the viewer count and status history of followed live streams as long as Chatty is running.
Sounds are now integrated into the Notifications.
/unhostcommand to your channel if you started your stream session in the last 15 minutes and the stream status changes (usually from offline -> live).
/add autoUnhostStreams <streamName>, in order to tell Chatty that you are authorized/want to use the automatic
/unhostfeature in that channel).
You can let Chatty write information (title, game, viewercount) of a
certain stream to a file. The file will be written to the subfolder
exported of the settings directory
/dir to find out where that is). Stream information is
only written if Chatty gets that data, so for it to work properly you need
to currently have the channel of that stream open in Chatty. (When you change
the setting, data will be requested once for testing, but you have to be in
the channel for it to be updated regulary.)
To save stream information to a file, you have to define it in the setting. Each line represents one stream/file and the content to write into the file. The format for each line is:
<streamname> <filename> [online/offline] <content>
The optional parameter
online/offline defines whether to
write the given content to the file when the stream is online or offline. So
you could for example define one line for online, which writes the viewercount
and another for offline which writes "Offline" or maybe no content at all, which clears the file.
If you only define one for online, then
the file is not written if the stream is offline, so the previous info will
stay in there. If you ommit this parameter, then online is assumed.
The following codes in the content will be replaced with the appropriate data:
%title- The title of the stream
%game- The game of the stream
%viewers- The current viewercount
%followers- The current number of followers, only updates correctly when the Followers Dialog for this channel is open (Main Menu - Extra - Followers)
%subscribers- The current number of subscribers, only updates correctly when the Subscribers Dialog for this channel is open (Main Menu - Extra - Subscribers)
%subscribersf- The same as above, but formatted numbers (e.g.
Example which will write two files (if joined to #joshimuz):
joshimuz title.txt %title (%viewers Viewers)
joshimuz title.txt offline Stream offline
joshimuz game.txt %game
joshimuz game.txt offline
If the stream is online, it writes the title and viewercount to
and the game to
If the stream is offline it writes "Stream offline" to
title.txt and empties
This settings page allows you to do the following, which is explained in more detail on another page:
These settings should only be changed if you know what you're doing. You can however reset any setting to the default by either deleting the settings file or using setting commands.
The server/port values are used when connecting, unless the commandline
-port are used,
then the value that is given there is used instead (without it being shown
here). You should know if you set a server or port with a commandline
parameter, but you can also check that by using
Manage the actual login data under
Main Menu - Login...
-tokenparameter to override existing token
-tokenparameter sets the login token used in Chatty. If a token is already saved in Chatty, then the
-tokenparameter will have no effect, unless this setting is enabled.
-tokenparameter, then it will be overriden anyway.
-tokenparameter is in use, it will be shown as such in the
Main Menu - Login..dialog.
The Twitch Client Version setting has been removed since Twitch Chat was switched over to IRCv3 tags and commands (receiving of joins/parts is now controlled by the Correct Userlist setting).
TAB Completion allows you to write the beginning characters of a nickname in chat and then press TAB to complete it. To learn how to use TAB Completion check out the general help.
Either TAB or Shift-TAB can be pressed after some text to initiate Completion, and here you can change what type of Completion each should do:
In addition to this there are special cases where a certain type of Completion is chosen independant of these settings:
@always completes usernames
/always completes command names
:always completes Emoji codes, and by default also Twitch Emotes
.always performs Custom Completion
/banalways complete usernames
/banwhich needs a regular username as parameter, then always prefer the regular name.
testand has the Localized Name
名前, then entering
tesand TAB will show in the results both
名前 (test), so you can select either name by cycling through the results via TAB as usual.
Custom Completion allows you to add your own keyword/value pairs for
completion. Custom Completion can always be performed by prepending the
keyword with a dot (
.) and then pressing TAB
or Shift-TAB, or by selecting Custom Completion for the
TAB or Shift-TAB setting, in which
case no prefix is required.
chatty as Key and
https://chatty.github.io as Value and then in the
.chatty (notice the dot in front) and press
TAB to complete it to the URL.
Custom Completion items can only have one completion, so you can't have
.chatty complete to several different values.
Besides the Settings Dialog, you can also use the
command to modify custom completion items:
/customCompletion add <item> <value>- Add an item
/customCompletion set <item> <value>- Change an item if it already exists (or otherwise add it)
/customCompletion remove <item>- Remove an item
Remember that you can also use TAB Completion for command names. Kappab
Controls the behaviour of two different types of automatically stored history:
Both of these lists also allow you to manually add favorites, in addition to the automatic history.
Allows your mods to trigger Stream Highlights, which writes the current uptime/optional note to a textfile.
zoton2you would enter
!highlightmods would enter
!highlight [optional message].
status:prefix to match only on some types of users. The preset names/values are:
/set streamHighlightMatch <value>. You can use anything the Highlighting syntax provides (for example Addressbook categories), not just the
You can add hotkeys for certain actions. In general, there are the following types of hotkeys:
With the Enable global hotkeys setting you
can enable/disable the currently defined global hotkeys if your
Chatty version supports global hotkeys. It does not do
anything on it's own, it just toggles global hotkeys you defined
on and off, in case you only need them sometimes and they
interfer with other programs you use. You can also toggle that
setting in the main menu under
Extra - Options or
use setting commands to change the
If a dialog pops up that tells you that global hotkeys have not been properly initialized, check out the Troubleshooting page.
When adding or changing a hotkey you have the following options:
Custom Command, you have to enter the command to perform in the field below (just the name of the command, see Commands).
50will execute the action only once per 5 seconds, even if you keep the hotkey pressed. This can be useful for actions you normally would only want to execute once (e.g. running a commercial, sending a message to chat) and that you don't want to spam by accident.