diff --git a/changes.txt b/changes.txt index 0bacc7b..035f04b 100644 --- a/changes.txt +++ b/changes.txt @@ -1,5 +1,53 @@ -0.9 (2017-12-26) Latest Version +0.9.1 (2018-04-02) Latest Version + +### Main Features +- Added basic support for Rooms (join via Channels-menu and Favorites/History) +- Added initial support for translating the Chatty GUI to other languages, + added some partial translations (thanks to volunteers translating) + +### Highlighting/Ignore +- Added Highlight Blacklist, to prevent some matches from triggering Highlights +- Improved Highlight pattern tester (used in other places as well), now with + match color highlighting, and open directly instead of hiding behind "Test" +- Some text matching prefixes changes (Highlighting/Ignore/..): + - Changed `w:`/`wcs:` to not take Regex anymore + - Added `reg:` prefix and variations for using Regex with more consistent and + predictable naming scheme (`re:` and `re*:` still work as before) + +### Settings +- Setting files `favoritesAndHistory` and `statusPresets` now both merged into + `settings` file, unused files are removed +- Possibly made saving settings more reliable in some circumstances +- Reorganized Settings Dialog, added new menu for navgiation +- Added setting for vertical zoom in Channel Info Dialog, improved context menu +- Added setting for logging regular chat messages (and thus a way to disable it) +- Added setting whether to show chat inputbox by default (and thus a way to hide + it by default) +- Added "Off" option for notification type setting +- Updated Livestreamer context menu qualities setting format to allow specifying + display names for groups of qualities +- Changed TAB Completion default to complete both usernames and emotes with TAB + +### Other Changes +- Changed chat inputbox to automatically grow when entering long lines +- Added /favorite and /unfavorite commands (Channel Favorites) +- Added /joinhosted command to join currently hosted channel +- Changed /appinfo command to contain more information +- Don't add space anymore when chat timestamp is empty +- Show more stream types as "[VOD]" (Premiere, Vodcast, Rerun..) +- Updated help + +### Bugfixes +- Fixed bug loading emotes.txt +- Fixed possible Community search issue +- Fixed username capitalization locale bug (e.g. Turkish locale) +- Fixed bug where "Cancel" in the Open URL dialog would sometimes copy the URL +- Fixed possible bug with tray icon +- Fixed some FFZ API/other URLs not using https + + +0.9 (2017-12-26) ### Twitch Updates - Added /raid command and display of incoming raids, joining raids doesn't work diff --git a/help/help-custom_commands.html b/help/help-custom_commands.html index a504eec..2827159 100644 --- a/help/help-custom_commands.html +++ b/help/help-custom_commands.html @@ -494,7 +494,11 @@ Spoiler[S]=/timeout $$1 600 No spoilers dialog is open and focused. They are interpreted by getKeyStroke() which means anything that function understands can be used. However - spaces are not allowed, so a plus sign + can be used instead.

+ spaces are not allowed, so a plus sign + can be used instead. + Examples: alt+Q, shift+1, INSERT

+ +

Note: The lowercase/uppercase matters for it to be parsed + correctly.

Adding a vertical bar | after the shortcut will use the text after it as label for the shortcut on the button (no spaces allowed). If diff --git a/help/help-guide_folders.html b/help/help-guide_folders.html index 40ce1e3..2ecb33a 100644 --- a/help/help-guide_folders.html +++ b/help/help-guide_folders.html @@ -128,6 +128,9 @@ +

Note: favoritesAndHistory and statusPresets + have been merged into settings as of v0.9.1.

+

Working Directory

This directory is associated with Chatty when you start it. This is usually the directory the program is started from. In some cases, diff --git a/help/help-livestreamer.html b/help/help-livestreamer.html index 60d72b3..64f7d5f 100644 --- a/help/help-livestreamer.html +++ b/help/help-livestreamer.html @@ -63,11 +63,14 @@ bar) to add a separator to the menu.

Enclose qualities in brackets { } if you need to add commas, for example if you want to specify a list of fallback qualities.
+
Optionally add a display name for a group of qualities by separating + it with a colon (:).
Examples:
diff --git a/help/help-releases.html b/help/help-releases.html index 54c68b9..59cd4a8 100644 --- a/help/help-releases.html +++ b/help/help-releases.html @@ -17,6 +17,7 @@

Release Information

+ 0.9.1 | 0.9 | 0.8.7 | 0.8.6 | @@ -50,7 +51,69 @@ full list of changes.

- Version 0.9 (This one!) (2017-12-26) + Version 0.9.1 (This one!) (2018-04-02) + [back to top] +

+

This version has a lot of under-the-hood changes to allow for the new + Rooms feature that Twitch added. The implementation in Chatty is rather + basic: You can join rooms available for the current channel through the + "Channels" menu and you can favorite rooms, however for example there is + not yet an implementation for viewing the Room chat history.

+ +

If you're a heavy user of the Highlight system you may appreciate the + addition of the Highlight Blacklist as well as improvements to the + dialog used for editing the text matching pattern. Also note that there + have been slight changes to some prefixes (see below).

+ +
+### Main Features
+- Added basic support for Rooms (join via Channels-menu and Favorites/History)
+- Added initial support for translating the Chatty GUI to other languages,
+  added some partial translations (thanks to volunteers translating)
+
+### Highlighting/Ignore
+- Added Highlight Blacklist, to prevent some matches from triggering Highlights
+- Improved Highlight pattern tester (used in other places as well), now with
+  match color highlighting, and open directly instead of hiding behind "Test"
+- Some text matching prefixes changes (Highlighting/Ignore/..):
+  - Changed `w:`/`wcs:` to not take Regex anymore
+  - Added `reg:` prefix and variations for using Regex with more consistent and
+    predictable naming scheme (`re:` and `re*:` still work as before)
+
+### Settings
+- Setting files `favoritesAndHistory` and `statusPresets` now both merged into
+  `settings` file, unused files are removed
+- Possibly made saving settings more reliable in some circumstances
+- Reorganized Settings Dialog, added new menu for navgiation
+- Added setting for vertical zoom in Channel Info Dialog, improved context menu
+- Added setting for logging regular chat messages (and thus a way to disable it)
+- Added setting whether to show chat inputbox by default (and thus a way to hide
+  it by default)
+- Added "Off" option for notification type setting
+- Updated Livestreamer context menu qualities setting format to allow specifying
+  display names for groups of qualities
+- Changed TAB Completion default to complete both usernames and emotes with TAB
+
+### Other Changes
+- Changed chat inputbox to automatically grow when entering long lines
+- Added /favorite and /unfavorite commands (Channel Favorites)
+- Added /joinhosted command to join currently hosted channel
+- Changed /appinfo command to contain more information
+- Don't add space anymore when chat timestamp is empty
+- Show more stream types as "[VOD]" (Premiere, Vodcast, Rerun..)
+- Updated help
+
+### Bugfixes
+- Fixed bug loading emotes.txt
+- Fixed possible Community search issue
+- Fixed username capitalization locale bug (e.g. Turkish locale)
+- Fixed bug where "Cancel" in the Open URL dialog would sometimes copy the URL
+- Fixed possible bug with tray icon
+- Fixed some FFZ API/other URLs not using https
+
+ +

+ Version 0.9 (2017-12-26) [back to top]

This version includes more Look and Feels which you can select in the @@ -89,7 +152,7 @@ - Fixed some BTTV emotes (like D:) appearing when they shouldn't - Added Emoji TAB Completion (anything starting with ":") - Added conversion of Emoji short code to Emoji character when entered into the - inputbox (e.g. :thinking: -> 🤔 when being sent) + inputbox (e.g. :thinking: -> <unicode_character> when being sent) ### Settings - Added -d launch argument to directly specify settings directory @@ -108,7 +171,7 @@ - Fixed some emote code conversions - Fixed error on "Use title only" in Admin Dialog - Possibly fixed rare error with parsing livestreamer menu options - +

Version 0.8.7 (2017-09-12) diff --git a/help/help-settings.html b/help/help-settings.html index 66ed765..eaa4c77 100644 --- a/help/help-settings.html +++ b/help/help-settings.html @@ -6,25 +6,31 @@

Settings

Main + | Look + | Chat Colors + | Message Colors + | Usercolors + | Usericons + | Emoticons + | Fonts + | Chat | Messages | Moderation - | Chat - | Emoticons - | Usericons - | Colors - | Usercolors + | Names | Highlight | Ignore - | Sounds - | Notifications | Log to file | Window | Tabs - | Commands + | Notifications + | Sounds | Other + | Commands | Advanced - | Hotkeys - | TAB Completion

+ | TAB Completion + | History + | 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 @@ -35,6 +41,344 @@ Main [back to menu] +

Startup

+

You can select what will happen when you start Chatty:

+ + +

+ Look + [back to menu] +

+ +

Look&Feel

+

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.

+ +

+ Chat Colors + [back to menu] +

+ +

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.

+ + +

+ Message Colors + [back to menu] +

+

You can customize the 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 message color is set on the "Colors" settings + page ("Normal message").

+ +

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

+

Examples of how to match certain messages, so you can assign it a custom + color.

+
+
status:r
+
Matches all messages from a known bot (FFZ, BTTV or the + botNames setting).
+ +
cat:vip
+
Matches all messages from users in the vip Addressbook + category.
+ +
chan:#tailsgaming start:!points
+
Matches all messages in channel #tailsgaming, starting + with !points.
+ +
re*:(?i)(?<!practice |debug )\bROM\b(?! hack)
+
Matches all messages containing the word ROM, not + preceded by practice  or debug , nor + followed by  hack (case-insensitive).
+
+ +
More examples: Highlight settings help
+ + +

+ Usercolors + [back to menu] +

+

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):

+ + +

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 $mod + or $sub first).

+ +

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.

+ + +

+ Usericons + [back to menu] +

+

Usericon Settings

+ + +

Custom Usericons

+

Add entries to the table to show additional icons (Addon-Type) + or replace the default icons (all other Types).

+

The order of the entries can matter, they are looked at from the top:

+ + +

Custom Usericon Properties

+
+
Type
+
A type of Addon will add an additional badge. All + Addon-badges that matche the Restrictions are shown at once.
+
Other types replace an already shown default badge. For example + adding an entry of Type Turbo allows you to define a + custom icon for all Turbo badges shown in chat. Accordingly, if you + selected Bits it would target all variations of the + Bits badge.
+
The Type Other Twitch allows you to directly select a + default icon via Twitch's own Badge ID/Version, which allows you to + target badges that are not a supported Type.
+ +
ID/Version
+
You can only use this when you have the Other Twitch + Type 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.
+
For example if you wanted to replace the 100-Bits Badge, you'd want + to use 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.
+
If you are already connected to a channel, it should automatically + populate the list with known ID/Version combinations. Note that some + of these may only be used in some channels.
+ +
Restriction
+
This is similiar to the Usercolors settings, + where you can enter special restrictions the user has to match in order + for the icon to be displayed. What makes the most sense in this case is + probably just entering a username (e.g. 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.
+
Specifying a Type other than Addon carries an + implicit restriction, since e.g. the default moderator icons are only + displayed if the user is a moderator.
+
Normally you can only specify one restriction, but you can + also add special restrictions: + +
+
Example: $cat:streamer $first - Matches users + in the Addressbook category streamer and puts the badge + in front of the default ones.
+
Example: lotsofs - Matches a user by the name + lotsofs.
+
Example: $cat:vip $badge:bits - Matches users + in the Addresbook category vip, but only if they also + have a Bits-Badge displayed.
+ +
Channel
+
You can enter a channel name here, so that the icon will only be + displayed in that channel. You can add an exclamation mark in front + of the channel name (like !#channel) to have it + displayed in all channels except the one you specified.
+
If you keep this empty, then it will be displayed in all channels.
+ +
Image File
+
The image to use. Must be a .png and 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.
+
Chatty lookes for images in <working_directory>/img/ + (Chatty directories help). + You can click on Image Folder to show information about + it and rescan to update the list.
+
The special image file name $default will 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.
+
Tip: You should also be able to manually enter the full + path to an image, in case you don't want to use the dedicated image + folder. A filename starting with http is 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.

+ + +

+ Emoticons + [back to menu] +

+

General Emoticon Settings

+ +
+
Show emoticons
+
Turns emoticon codes into images. This needs to be enabled for any + emotes to show up.
+ +
Scale (Chat)
+
The relative size of how emotes are displayed in chat (100% is regular size).
+ +
Maximum Height
+
The maximum height of emotes in chat (in pixels). Use 0 to allow any height.
+ +
Emotes Dialog
+
The relative size of how emotes are displayed in the Emotes Dialog (100% is regular size).
+ +
Double-click on emote closes Emote Dialog
+
If enabled, double-clicking on an emote in the Emote Dialog closes + the Emote Dialog.
+ +
Cheers (Bits)
+
You can choose whether to show Cheering + emotes in chat animated, as static images (like other emotes) or + not at all (so they'll just show up as text).
+
Sending Cheers is not supported at this point.
+
+ +

Third-Party Emoticons

+
+
Enable BetterTTV Emotes
+
Shows BetterTTV emotes (Personal Emotes not supported at this time).
+ +
Allow animated emotes
+
Show animated emotes (BTTV GIF emotes).
+ +
Enable FrankerFaceZ (FFZ)
+
Downloads FrankerFaceZ emotes and + Mod Icons (where available).
+
Requires a restart to take full effect when you change it.
+ +
Enable FFZ Mod Icon
+
Show the FFZ Mod Icon in place of the default Mod Icon (where available).
+ +
Enable FFZ Featured Emotes
+
Show special FFZ emotes available in some channels (mainly + Speedrunning Events). To receive these emotes Chatty maintains a + connection to the FFZ Socket Server.
+
+ +

Emoji

+
+
Set
+
Turns Emoji characters into images. You can choose between different + sets of Emoji images, or choose None to turn off Emoji + images altogether.
+ +
Replace Emoji codes in entered text
+
Emoji codes like :joy: or :mouse: get + replaced with their respective Emoji character (and thus image, if + a Set is chosen) when entering them into the inputbox.
+
Tip: Use TAB Completion + to complete partially entered Emoji codes.
+
+ +

Ignored Emotes

+

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. :) has \:-?\) 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 + the list.

+ + +

+ Fonts + [back to menu] +

+

Chat Font

Change font and font size by clicking on Select font.

@@ -58,26 +402,56 @@ note about the adverse effects it may have.

-

Startup

-

You can select what will happen when you start Chatty:

+ +

+ Chat + [back to menu] +

+

Chat Settings

+ +

Pause Chat

+

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.

+ + -

Look&Feel

-

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.

Messages @@ -220,19 +594,8 @@ - -
Show moderator actions in chat
-
Outputs extra messages for commands that moderators execute in the - channel, except for the commands you exexcute yourself.
-
This is only available for the broadcaster and moderators.
-
This is a Twitch Beta, so it may still change and break things.
-
To view mod actions you can also open a separate dialog via - Extra - Moderation Log.
-

Name Capitalization

-

This has been moved to it's own settings page.

-

Moderation @@ -250,358 +613,7 @@ can also view those messages even if this setting is disabled. - -

- Chat - [back to menu] -

-

Chat Settings

- - -

Pause Chat

-

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.

- - - -

- Emoticons - [back to menu] -

-

General Emoticon Settings

- -
-
Show emoticons
-
Turns emoticon codes into images. This needs to be enabled for any - emotes to show up.
-
Scale (Chat)
-
The relative size of how emotes are displayed in chat (100% is regular size).
- -
Maximum Height
-
The maximum height of emotes in chat (in pixels). Use 0 to allow any height.
- -
Emotes Dialog
-
The relative size of how emotes are displayed in the Emotes Dialog (100% is regular size).
- -
Double-click on emote closes Emote Dialog
-
If enabled, double-clicking on an emote in the Emote Dialog closes - the Emote Dialog.
- -
Cheers (Bits)
-
You can choose whether to show Cheering - emotes in chat animated, as static images (like other emotes) or - not at all (so they'll just show up as text).
-
Sending Cheers is not supported at this point.
-
- -

Third-Party Emoticons

-
-
Enable BetterTTV Emotes
-
Shows BetterTTV emotes (Personal Emotes not supported at this time).
- -
Allow animated emotes
-
Show animated emotes (BTTV GIF emotes).
- -
Enable FrankerFaceZ (FFZ)
-
Downloads FrankerFaceZ emotes and - Mod Icons (where available).
-
Requires a restart to take full effect when you change it.
- -
Enable FFZ Mod Icon
-
Show the FFZ Mod Icon in place of the default Mod Icon (where available).
- -
Enable FFZ Featured Emotes
-
Show special FFZ emotes available in some channels (mainly - Speedrunning Events). To receive these emotes Chatty maintains a - connection to the FFZ Socket Server.
-
- -

Emoji

-
-
Set
-
Turns Emoji characters into images. You can choose between different - sets of Emoji images, or choose None to turn off Emoji - images altogether.
- -
Replace Emoji codes in entered text
-
Emoji codes like :joy: or :mouse: get - replaced with their respective Emoji character (and thus image, if - a Set is chosen) when entering them into the inputbox.
-
Tip: Use TAB Completion - to complete partially entered Emoji codes.
-
- -

Ignored Emotes

-

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. :) has \:-?\) 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 - the list.

- -

- Usericons - [back to menu] -

-

Usericon Settings

- - -

Custom Usericons

-

Add entries to the table to show additional icons (Addon-Type) - or replace the default icons (all other Types).

-

The order of the entries can matter, they are looked at from the top:

- - -

Custom Usericon Properties

-
-
Type
-
A type of Addon will add an additional badge. All - Addon-badges that matche the Restrictions are shown at once.
-
Other types replace an already shown default badge. For example - adding an entry of Type Turbo allows you to define a - custom icon for all Turbo badges shown in chat. Accordingly, if you - selected Bits it would target all variations of the - Bits badge.
-
The Type Other Twitch allows you to directly select a - default icon via Twitch's own Badge ID/Version, which allows you to - target badges that are not a supported Type.
- -
ID/Version
-
You can only use this when you have the Other Twitch - Type 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.
-
For example if you wanted to replace the 100-Bits Badge, you'd want - to use 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.
-
If you are already connected to a channel, it should automatically - populate the list with known ID/Version combinations. Note that some - of these may only be used in some channels.
- -
Restriction
-
This is similiar to the Usercolors settings, - where you can enter special restrictions the user has to match in order - for the icon to be displayed. What makes the most sense in this case is - probably just entering a username (e.g. 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.
-
Specifying a Type other than Addon carries an - implicit restriction, since e.g. the default moderator icons are only - displayed if the user is a moderator.
-
Normally you can only specify one restriction, but you can - also add special restrictions: - -
-
Example: $cat:streamer $first - Matches users - in the Addressbook category streamer and puts the badge - in front of the default ones.
-
Example: lotsofs - Matches a user by the name - lotsofs.
-
Example: $cat:vip $badge:bits - Matches users - in the Addresbook category vip, but only if they also - have a Bits-Badge displayed.
- -
Channel
-
You can enter a channel name here, so that the icon will only be - displayed in that channel. You can add an exclamation mark in front - of the channel name (like !#channel) to have it - displayed in all channels except the one you specified.
-
If you keep this empty, then it will be displayed in all channels.
- -
Image File
-
The image to use. Must be a .png and 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.
-
Chatty lookes for images in <working_directory>/img/ - (Chatty directories help). - You can click on Image Folder to show information about - it and rescan to update the list.
-
The special image file name $default will 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.
-
Tip: You should also be able to manually enter the full - path to an image, in case you don't want to use the dedicated image - folder. A filename starting with http is 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.

- -

- Colors - [back to menu] -

-

Customize colors of certain types of chat messages. For the general look - of the program you can choose another Look&Feel from the "Main" - settings page.

- -

- Message Colors - [back to menu] -

-

You can customize the 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 message color is set on the "Colors" settings - page ("Normal message").

- -

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

-

Examples of how to match certain messages, so you can assign it a custom - color.

-
-
status:r
-
Matches all messages from a known bot (FFZ, BTTV or the - botNames setting).
- -
cat:vip
-
Matches all messages from users in the vip Addressbook - category.
- -
chan:#tailsgaming start:!points
-
Matches all messages in channel #tailsgaming, starting - with !points.
- -
re*:(?i)(?<!practice |debug )\bROM\b(?! hack)
-
Matches all messages containing the word ROM, not - preceded by practice  or debug , nor - followed by  hack (case-insensitive).
-
- -
More examples: Highlight settings help
- -

- Usercolors - [back to menu] -

-

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):

- - -

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 $mod - or $sub first).

- -

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.

- -

Names [back to menu] @@ -652,8 +664,7 @@

General settings

Add terms to be highlighted

Add items to the list to make a message highlighted if any one of them - match the message. The following two types of prefixes can be used to change - highlighting behaviour per item.

+ match the message. The Users to never highlight and + Highlight Blacklist settings can be used to prevent some of + those Highlights.

Text Matching Prefixes

-

By default, matching is done case-insensitive and when the word or phrase - appears anywhere in the message. However, you can add the following - prefixes in front of the text to change this matching behaviour. You can - only use one of these prefixes per item, because all text following the - prefix is interpreted as text to match.

+

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: [text-prefix:]<search text>

+

Meta Prefixes

-

The following prefixes mostly influence which messages are matched, - however they don't change the matching of the text itself, but instead - provide other information for the highlight system. They can be - placed in front of the Text Matching Prefixes (or the text if you don't - have any other prefixes) and you can even use more than one per item. - These prefixes have to be seperated from eachother and the text by a - space.

+

The following prefixes don't change the matching of the text itself, but + rather provide other information for the highlight system. You can place + one or several of these prefixes before the search text (separated by + spaces): + [meta-prefix:value] [..] [text-prefix:]<search text>

+ -

General Notification Settings

There are different types of Notifications:

+
Off
+
Don't show any notification
+
Chatty Notifications
The default popup Notification created by Chatty, with additional settings (see below).
@@ -1109,216 +1324,12 @@

- Log to file + Sounds [back to menu]

-

If you enable logging, chat messages (and more if enabled) will be written - into a seperate textfile for each channel.

-

Channels

-

You can specify which channels should be logged:

- +

Sounds are now integrated into the Notifications.

-

Other Settings

-
-
Folder
-
Select where to save the log files.
- -
Split Logs
-
Start a new log file every Day, Week or Month.
- -
Channel Subdirectories
-
Create a subfolder for each channel.
- -
Lock files while writing
-
By default Chatty requests exclusive access while writing to the - file, so that no other program can interfere. This can however cause - issues if you try to open the log while in the channel, for example - if you want to look something up for moderation, so disabling this - setting can make sense. This means that you have to ensure yourself - that only one instance of Chatty and no other programs write to or - the lock the files.
- -
Timestamp
-
Select the timestamp to be used in the logs.
-
-

Messages Types

-

Normal chat messages are always logged, however you can log additional - information:

- -
-
Chat Info
-
General chat releated info messages like connecting, disconnecting, - trying to timeout someone, stream title..
- -
Bans/Timeouts
-
Bans and Timeouts in chat. Timeout length and reason will be added - if available.
-
BAN: name1, name2 (30s) [reason], name3 (600s)
-
The reason is specified by the mod taking the action, so it may be - consist of any text.
- -
Mod/Unmod
-
When someone in chat is modded or unmodded. Remember that this info - may be inaccurate, since mod/unmod events are not send immediately - by Twitch Chat.
-
MOD: name1, name2
-
UNMOD: name3, name4
- -
Joins/Parts
-
When someone enters/leaves the channel. Remember that this info may - be inaccurate, since joins/parts are not send immediately by Twitch - Chat (and sometimes not at all).
-
JOIN: name1, name2
-
PART: name3, name4
- -
System Info
-
Any info messages that are related more to Chatty itself than to - chat, like info about new versions, when you use setting commands..
- -
Viewerstats
-
Stats about the viewercount which are logged in a semi-regular - interval to give you an idea about the viewercount during that time.
-
Each Viewerstats line shows which interval it refers to, the - min/max/avg viewers, the number of values and the development: - First value/after offline is absolute, then +- relative change, _ - means offline before/in between/after that value.
-
Viewerstats (21:03-21:06): avg:28.612 min:28.432 max:28.887 [3/28.519-87+455_]
-
In the example, the stats were recorded between 21:03 and 21:06 and - the Viewercount started out at 28.519, then went down (-87) and then - up (+455). After that the stream went offline (_).
- -
Viewercount
-
Directly logs the viewercount as it is received from Twitch, without - any processing, except being formatted depending on the current - locale.
-
VIEWERS: 12,521
- -
Mod Actions
-
Logs the commands performed by mods in your channel (Broadcaster/Mods only).
-
MOD_ACTION: tduva (host coollertmb)
- -
Ignored Msg.
-
Logs messages that have been hidden by the Ignore list, like normal - messages. You can disable this if you don't want ignored messages to - show up in the chat log files.
-
- -

- Window - [back to menu] -

-

Dialogs Location/Size

- - -

Other

- - -

Popout

- - -

- Tabs - [back to menu] -

-
-
Tab Order
-
Whether to show tabs in the order they were opened or alphabetically.
- -
Tab Placement
-
Where to put the tabs bar.
- -
Tab Layout
-
If the amount of tabs doesn't fit, choose whether tabs should wrap - into multiple rows (or columns) or keep in one row, while having to - scroll through them.
- -
Scroll through tabs with mousewheel
-
Hover mouse over tabs and scroll to change tabs. -
-
Scroll through tabs anywhere
-
Don't restrict scrolling through tabs to the tab bar, - although this mostly only applies to the inputbox. So you - can hover your mouse over the inputbox and scroll to switch - between tabs.
-
-
-
- -

- Commands - [back to menu] -

- -
This help is on a separate page: Custom Commands & Context Menus
-

Other [back to menu] @@ -1399,6 +1410,15 @@ If the stream is offline it writes "Stream offline" to title.txt and empties game.txt.

+ +

+ Commands + [back to menu] +

+ +
This help is on a separate page: Custom Commands & Context Menus
+ +

Advanced [back to menu] @@ -1452,78 +1472,7 @@ switched over to IRCv3 tags and commands (receiving of joins/parts is now controlled by the Correct Userlist setting).

-

- Hotkeys - [back to menu] -

- -

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 globalHotkeysEnabled - setting directly.

- -

If a dialog pops up that tells you that global hotkeys - have not been properly initialized, check out the - Troubleshooting page.

- -

Adding/Editing hotkeys

-

When adding or changing a hotkey you have the following options:

- - +

TAB Completion [back to menu] @@ -1662,6 +1611,95 @@

Remember that you can also use TAB Completion for command names. Kappab

+ + +

+ History + [back to menu] +

+

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.

+ + +

+ Hotkeys + [back to menu] +

+ +

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 globalHotkeysEnabled + setting directly.

+ +

If a dialog pops up that tells you that global hotkeys + have not been properly initialized, check out the + Troubleshooting page.

+ +

Adding/Editing hotkeys

+

When adding or changing a hotkey you have the following options:

+ diff --git a/help/help-troubleshooting.html b/help/help-troubleshooting.html index d15bb97..9c8e67a 100644 --- a/help/help-troubleshooting.html +++ b/help/help-troubleshooting.html @@ -303,6 +303,8 @@ and add the parameter, similiar to this (obviously adjusting to your paths): javaw -Dsun.java2d.d3d=false -jar "D:\Chatty\Chatty.jar" +
  • Try the Windows Standalone version of Chatty (if you're on Windows + of course).
  • Read Issue #64 diff --git a/help/help.html b/help/help.html index 450f893..ebcce9a 100644 --- a/help/help.html +++ b/help/help.html @@ -5,7 +5,7 @@ -

    Chatty (Version: 0.9)

    +

    Chatty (Version: 0.9.1)

    @@ -23,6 +23,7 @@
  • Userlist
  • Favorites / History
  • Whisper Feature
  • +
  • Rooms
  • Chat moderation / utility @@ -179,6 +180,8 @@ just like in normal Twitch Chat
  • /join <channel> - Joins the given channel
  • /part or /close - Leaves the current channel
  • +
  • /joinhosted - Join currently hosted channel (if any)
  • +
  • /favorite [channel] and /unfavorite [channel] - Add/remove a channel to/from the Channel Favorites
  • /reconnect - Disconnects and reconnects
  • /fixMods - Temporarily fixes the list of mods (like /mods but without showing the list of mods in chat)
  • @@ -227,7 +230,7 @@

    Housekeeping/System commands:

    • /uptime - Shows how long Chatty has been running
    • -
    • /appinfo - Shows Chatty uptime and current memory stats
    • +
    • /appinfo - Shows Chatty version, uptime, current memory usage, system info and connection status
    • /dir - Show the directory the settings (and other stuff) are saved in
    • /wdir - Show the current working directory
    • /openDir - Opens the settings directory in your file browser
    • @@ -471,7 +474,7 @@
    -

    FrankerFaceZ provides a custom +

    FrankerFaceZ provides a custom mod icon for some channels. You can disable this in the settings if you want to keep the default one for all channels.

    @@ -690,6 +693,29 @@

    You can also add channels from the history or any you enter manually to the favorites, which will always be kept until you remove them yourself.

    + +

    + Rooms + [back to menu] +

    +

    The new Rooms + can be used in Chatty:

    + + + +

    Currently not available in Chatty:

    +

    Highlight @@ -745,7 +771,7 @@

    Chatty supports the following types of emoticons: