You can try out a beta preview version of the next Chatty version. This is a snapshot from the middle of development and may not be as stable and definitely won't be finished, which means:
+
+
Some features may still change
+
The help won't be finshed/may not be there for some features
+
There may still be more bugs or small inconsistencies
+
New beta versions (e.g. b4 -> b5) are not announced in program, so check this page if you may want to update, especially if you encounter bugs
+
+
What this is for:
+
+
You can use new features right now if you are ok with the downsides in the list above
+
You can help test Chatty
+
+
How to use
+
Download the beta version (0.8.1b3) and put it in the same folder as your regular Chatty.jar, then start it the same way. You need to have the regular version of Chatty from the main website first. If you were using a Chatty version already, you're set.
+
+
As with every new version, if you have invested a lot of time into adjusting settings (like maybe added 50 different usericons), you may want to make a manual backup of the settings (enter /dir in Chatty to display the folder where they are saved, more information on the files Chatty uses). This shouldn't be necessary, but it's always prudent to know where your settings are saved and to keep a backup.
+
The beta version will always be the version with global hotkey support. If you are normally using the version without global hotkey support, there will be an error message about it when you start Chatty that says you can ignore it if you don't actually make use of global hotkeys.
+
If you decide to use the old regular version again, be aware that any changes to settings that were introduced with the beta version will be lost.
+
+
+ If you like Chatty and would like to support me:
+
+
+
+
diff --git a/changes.txt b/changes.txt
new file mode 100644
index 0000000..4adbd34
--- /dev/null
+++ b/changes.txt
@@ -0,0 +1,683 @@
+
+0.8 (2015-06-09) Latest Version
+
+Core Changes:
+- Connection: Implemented IRCv3 tags/commands/membership support
+- Userlist: IRCv3 now supports optional joins/parts (correct userlist), which is
+ enabled by default in Chatty (doesn't mean joins/parts have to be shown)
+- Added experimental support for secured connections
+
+Emoticons:
+- Changed Emoticon parsing to use spaces as delimiter instead of word boundaries
+ (to match changes made to Twitch Chat)
+- Scaling: Added settings to scale emotes in chat and the Emotes Dialog
+- BTTV: Implemented BTTV Custom Channel Emotes, switched to new BTTV API
+- IRCv3: Implemented new Twitch Emotes API, including using IRCv3 tags
+- Emote Dialog: Added overview of all global emotes (Twitch and Other)
+- Detail View: Added Detail View that can be opened for an emote with different
+ scaling and a table of information about the emote
+- Context Menu: Added more entries and information
+- Added emote image caching, making loading of emotes a bit faster and hopefully
+ more reliable if the server can't be reached at the time of loading
+- Added feature to add custom emotes (locally), also allowing you to replace
+ other emotes
+- FFZ: Switched to new API (and showing more info about the emotes)
+
+TAB Completion:
+- Changed to work with @ in front (or any other non-word characters around it)
+- Added info popup to show completion information (how many items are found,
+ which item you are at while cycling through results)
+- Added completion for emotes (Shift-TAB)
+- Added completion for setting names (TAB when using after setting command)
+- Added completion for some commands (TAB after /)
+- Added support for custom completion items that you can add in the settings or
+ via the /customCompletion command
+
+StreamChat:
+- Added fitting context menu to stream chat dialog
+- Added setting to START inserting text a the top in Stream Chat
+ (but not insert text at the top in general), added streamChatResizable setting
+- Added commands /clearStreamChat, /testStreamChat, /setStreamChatSize,
+ /getStreamChatSize
+
+Other Enhancements:
+- Added bot badge (bot names from BTTV/FFZ APIs and local setting)
+- Added ability to record current stream time via commands to assist in creating
+ stream highlights
+- Added setting to clear chat when channel is cleared by a moderator
+- Hosting: Added info in the title which channel is being hosted, added warning
+ in chat when a channel is still being hosted when the stream is going live
+- Streamlined reconnection messages a bit
+- Output message if channel attempting to join doesn't exist on Twitch
+- Added correctly capitalized names from IRCv3 display-name tag, removed
+ commands to change capitalization of names locally
+- Added experimental showing of slowmode/submode status in the titlebar (only
+ shows correctly if mode toggled while you are already in the channel, until
+ chat sends that info on join as well)
+- Added feature to locally set custom names for any user which show up in chat
+ and the userlist
+- Highlighting: Added more prefix options
+- Ignore: Added prefix option to ignore info messages
+- Added Miscellaneous-menu to User Context menu and added entry Copy Name
+ (meaning copy to clipboard)
+- Added Miscellaneous-menu to Channel Context menu and added entry to join
+ currently hosted channel
+- Added /copy command which copies the given text to the clipboard
+- Added /color command which redirects to the Twitch Chat /color command
+- Added /livestreamer command to open streams/dialog via command
+- Added /appinfo command
+- Added /r9k and /r9koff commands
+- Added workaround for Twitch API sometimes returning stream information with
+ missing channel object (no title available), assuming previous title
+- Updated help
+
+Changes:
+- Files: Moved cache files to be saved in the /cache folder
+- Reduced Twitch API debug log spam a bit
+- Increased join delay a bit
+- Updated Settings Dialog layout to adjust to the dialog size better
+- Changed Twitch API version calls to use v3 by default
+- Changed Usericon image files starting with "http" to be interpreted as URL
+- Disabled auto request of mods list for the time being, since mod status for
+ messages should always work and mod status in the userlist should probably
+ work if the userlist works in the first place
+- Decreased Live Streams dialog scroll speed a bit
+
+Settings:
+- Highlighting: Added highlightIgnored setting whether to try to highlight
+ messages that have already been ignored (disabled by default)
+- Changed capitalizedNames (first letter only) setting to default to on (only
+ affects fresh settings)
+- Debugging: Added setting to log raw IRC traffic to file (disabled by default)
+- Added mainResizable setting to be able to turn off resizing of the main window
+- Added setting to ignore Stream Status Notifications for Stream Offline
+- Added some more support for different setting types to setting commands
+- Changed setting commands to support numeric lists
+- Changed Settings Dialog to only tell you to reconnect if you don't have to
+ also restart Chatty (required by a setting change)
+
+Bugfixes:
+- Fixed bug where channel would constantly be reopened when it failed to join
+ (especially happening on non-existing channels)
+- Fixed bug where reonnection timer would sometimes not be cancelled
+- Fixed synchronization that could lock up the GUI when performing API requests
+- Fixed username case-sensitivity issues for commands
+- Fixed error in stream status writer when stream doesn't have a game set
+- StreamChat: Fixed bug where stream chat wouldn't scroll down properly
+- Addressbook: Fixed remove commands issues with case-sensitivity
+- Run correct commercial length in Admin Dialog when using a hotkey
+- Fixed close channel hotkey to close active channel rather chan active tab
+- Possibly fixed some info messages from Twitch Chat not showing up
+- Changed "Mr. Freeman" to "Dr. Freeman"
+- Fixed rare error in tables (like Follower Dialog)
+- Fixed and enabled workaround for some combining characters causing performance
+ issues (replacing more than two combining characters in a row with ****)
+
+
+0.7.3 (2015-01-19)
+
+New features:
+- Added customizable hotkeys feature allowing you to add/remove/change hotkeys
+ in the settings (Global Hotkeys Windows only)
+- Added Stream Chat dialog (only regular messages, optional message timeout to
+ make them disappear after some time, mainly for testing right now)
+- Added support for global mods
+- Added $chan parameter to Custom Commands
+- Log to file: Added setting to customize timestamp (via setting commands)
+
+Changes:
+- Changed inputbox font to prevent bug where fallback fonts wouldn't work
+ properly in JTextPane
+- Changed default for "Restore dialogs" setting to "Restore dialogs from last
+ session" (only if you start from fresh settings)
+- Backup: Increased setting backup count to 5 backups
+- Changed staff usermode symbol to & (text symbol, not the badge)
+- Added scaling to emotes if the image is too big, set maximum size to 100x50
+- Improved setting commands (added add/remove commands for String lists, save
+ default for lists/maps), improved help for setting commands
+- Added "set:" commandline parameter to set any setting that can be set with the
+ /set command
+- Changed to new BTTV emotes API
+- Improved URL parsing a bit
+- Updated help
+
+Bugfixes:
+- Fixed Simple Title menu setting not being updated correctly
+- Set foreground color of Viewer History based on the current foreground color
+ of the dialog, so it fits the LAF
+- Set Notification foreground color to black, in case a LAF uses another color
+ that doesn't go well with the yellow background (Notification colors should be
+ customizable eventually)
+
+
+0.7.2 (2014-12-14)
+
+Features:
+- User Dialog Buttons (Timeout/Custom Commands) now support shortcuts, Ban and
+ Unban buttons are not hardcoded anymore and have to be added to the setting
+ (setting is automatically changed if you switch from a version before 0.7.2)
+- Added User/Line Selection feature to select a User in chat via the keyboard
+ so e.g. timeouts are possible completely via the keyboard
+- Added feature to modify Addressbook entries via a file
+- Added color restriction for Usericons
+- Highlight/Ignore: Added prefixes ("start:", "status:", "!status:", "!cat:",
+ "chanCat:", "!chanCat")
+- Channel Info Dialog now allows to be resized a lot smaller, Viewercount info
+ now adjusting better to smaller sizes
+- Added setting to change Look&Feel (only Default and System for now)
+- Added setting to attach dialogs to main window, so they always stay in the
+ same relative position when the main window is moved
+- Added some keyboard shortcuts
+- Added some support for FFZ feature friday, added /ffzGlobal command to show
+ global FFZ emote codes
+
+Changes:
+- Added menu entry to open login configuration for easier access (no need to
+ disconnect from chat)
+- Improved login configuration dialog
+- When login was determined invalid by automatic check: Changed warning message,
+ don't remove automatically anymore but let user do it if necessary
+- Added Options submenu to View menu to allow more options with direct access
+- Added more options to Title/Game Presets dialog due to S'ome demand
+- Logging to file now enabled by default (only if you start from fresh settings)
+- MOD/UNMOD messages are now disabled by default (from fresh settings)
+- Custom Commands executed from the Channel Context Menu now include the name
+ of the channel as first parameter (without leading #)
+- Some small improvements of labels/info texts in Settings Dialog
+- Increased join delay, increased delay between failed join attempts
+- Ping connection more often if inactive to detect disconnect quicker and
+ possibly prevent disconnect in some cases
+- Improved URL detection (again)
+- Improved debug messages a bit
+- Improved error catching in some places
+- Added more tests
+- Updated help
+
+Bugfixes:
+- Fixed URLs that don't have a protocol prefix (e.g. http://) being opened
+ without a prefix, which resulted in the browser not opening correctly
+- Fixed error in FrankerFaceZ emote parsing
+- Fixed bug where "Close to tray" wouldn't work without "Minimize to tray" being
+ enabled as well
+- Fixed layout problem in Settings Dialog when log path was too long
+- Use usercolor corrected for readability for colored /me messages
+
+
+0.7.1 (2014-10-26)
+
+New features:
+- Added Emoticon Favorites, that are displayed in the Emote Dialog (you can only
+ add Twitch Emotes for now, not FFZ or BTTV)
+- Added support for correct capitalization of names in chat (experimental, you
+ have to enable it in the settings if you want to try it)
+- Show correctly capitalized stream names in Live Streams/Channel Info Dialog
+ (independent of the Correctly Capitalized Names setting)
+- Added minimize to tray/close to tray options
+- Added setting for auto scroll down timeout length
+- Added setting to change font size of dialogs (experimental, only Userinfo now)
+- Added setting to customize chat log file location
+- Added context menu to Follower/Subscriber Dialog to export list to file
+- Added support for FrankerFaceZ global event emotes
+
+Changes:
+- Changed tray icon to only show when needed
+- Set proper tooltip for tray icon
+- Added some more timestamp options
+- Changed stream status writer output to "exported" subfolder of settings folder
+- Changed stream status writer to ignore case of stream name
+- Channel Info: Added approx. last stream length as tooltip to "Offline" text
+- Changed Twitch badges to use images instead of alpha (shows new colors now)
+- Changed base colors for badges to new Twitch colors (affects FFZ Mod Icon and
+ Fallback Icons)
+- Allow for selection of text in chat by double-clicking (focus to inputbox now
+ only on single-click on chat)
+- Detect a few more URL formats to be made clickable
+- Improved debug logging a bit (memory usage)
+- Some small improvements to memory usage
+- Added some more characters to Font Selection Dialog, but also an input field
+ to enter your own text to test the font
+- Catch the error if hotkey library couldn't be found and output warning instead
+- Updated help
+
+Bugfixes:
+- Fixed info messages sometimes going to the wrong window if popouts are used
+- Fixed subscriber sorting in userlist (but overall sorting can still be screwed
+ up sometimes)
+- Fixed wrong channel being joined when joining channel out of user context menu
+ with "Capitalize Names (First Letter)" option being enabled (fixed implicitly
+ by changing some stuff around for supporting capitalized names)
+- Added workaround for Twitch emotes appearing wrong on Retina displays
+- Nothing to do with Chatty in particular (it's the same for every IRC client),
+ but the "xy just subscribed" message should now work for everyone again,
+ because Twitch fixed it :)
+
+
+0.7 (2014-09-25)
+
+New features:
+- Added Emoticon Dialog, showing emotes you paid for (Subscriber/Turbo) and
+ channel-specific emotes (FFZ/BTTV)
+- Added Followers/Subscribers lists, added new follower sound (works only if
+ Followers Dialog is open)
+- Livestreamer: Added setting to use auth (for sub-only streams), added setting
+ whether to open the Livestreamer Dialog when opening a stream from the menu
+- Added setting to write stream info to a file (e.g. for display on stream)
+- Automatically request moderator list once per channel, added /fixMods command
+ to temporarily fix mods status without showing the list of all moderators
+- Added /host and /unhost commands
+- Added shortcut Ctrl-W to close active tab/restore popout to tab
+- Admin Dialog: Added option to automatically repeat commercial on the set delay
+- Added stream uptime to Channel Info Dialog (how long ago a stream was started)
+
+Changes:
+- Changed message parsing to support " is now hosting you" notification
+ (only works on Twitch Client Version 3 though, see Settings - Advanced)
+- Added setting to specify the timezone of the timestamp seperately from the
+ system timezone setting
+- Added kadgar.net to open live streams from the context menu
+- Added optional filter to remove combining characters used in some languages
+ that may cause an error in some cases
+- Livestreamer: Reuse open tabs if process stopped and opening stream with the
+ same stream/quality, re-enable quality selection buttons if process stopped,
+ improved labels and help
+- Added more timestamp options in the settings and changed to showing as example
+- Added gzip support to Twitch API requests
+- Added check to confirm status of stream going offline, which may or may not
+ prevent wrong offline notifications if the Twitch API returns false data
+- Added hint about entering Twitch Commands in invalid command message
+- Updated help
+
+Bugfixes:
+- Fixed error in message parsing
+- Fixed display error with ban messages
+- Fixed a possible bug with notifications
+- Now showing " /host commands remaining this half hour." message
+
+
+0.6.7 (2014-07-20)
+
+New features:
+- Added support for some of the BetterTTV emotes
+- Added feature to ignore indiviual emotes, which makes them not turn into an
+ image (but their code will still show up)
+- Changed game select dialog to one single list for favorites/search as to not
+ waste so much space
+- Added setting to change the livestreamer command (so you can also e.g. set the
+ full path to Livestreamer if necessary)
+- Added option to combine ban messages of the same user within 10 seconds, for
+ example " has been banned from talking (3)" means banned 3 times
+- Added "/ab change" command to add/remove/toggle categories in a single command
+- Added /uptime command
+- Added /openUrl and /openUrlPrompt commands (for use in custom commands)
+- Added ignore setting to not show ignored messages info (count/nick) in chat if
+ the ignored messages dialog is currently open
+
+Changes:
+- Live Streams window always on top of main window (seems a bit flickery though)
+- More Dialogs now closeable with ESC
+- Added Ctrl+J shortcut for opening Join Dialog
+- Save Channel Favorites sort order between sessions
+- Increased number of saved lines per user from 20 to 100
+- Reorganized Settings Dialog a bit (Usericons/Emoticons on seperate pages)
+- Added context menu to Race Id (blue link) in Race Viewer
+- Possibly improved debugging of emoticon loading errors a bit
+- Updated help
+
+Bugfixes:
+- Search dialogs (Ctrl+F) fixed for popouts
+- Fixed error on update notification
+- Improved API response parsing a little bit
+- Fixed context menus in Highlights/Ignored Messages dialogs
+
+
+0.6.6 (2014-06-25)
+
+New features:
+- Ignore messages (similiar to the Highlight system, match messages by keywords,
+ usernames, addressbook categories and channels)
+- Improved Emote Context Menu (now with channel name on subemotes and clicking
+ on emote code inserts it in the input box)
+- Improved subscriber detection on Twitch Client 1
+- Improved Update Notification to now also show in the Main Menubar (clicking
+ on it opens a window showing the changelog)
+- Livestreamer Context Menu quality selection now customizable
+- Added some commands (including /ffz to show FFZ emotes of the current channel,
+ some commands to open dialogs and stuff intended for use in Custom Commands)
+
+Changes:
+- Addressbook categories are now all made lowercase when added/loaded from file
+- Regular commands can now be also used in Context Menus/User Dialog settings
+- Improved error handling a bit (hopefully)
+- Removed Ignore Joins/Parts setting in favor of Twitch Client 3
+- Changed Twitch Client 1/3 setting to include small explanation
+- Added sort by viewercount in Live Streams Dialog
+- Added chan: and !chan: prefixes (Highlights and Ignore)
+- Updated help
+- Show how many Highlighted/Ignored messages are in the dialogs in the View-menu
+- Improved text settings editor (auto adjust size when typing, added help)
+- Changed Context Menu/User Dialog settings to allow more flexible formatting
+ (linebreaks allowed, / for command optional, | for seperator doesn't have to
+ be directly in front of a command, but still applies to the following one)
+- Moved to new FFZ server and updated parsing (recently added emotes should now
+ show up)
+
+Bugfixes:
+- Fixed horizontal scrolling sometimes happening in chat window
+- Fixed URL Context Menu stream detection to be case-insensitive
+- Fixed display of "<" in Notifications
+- Hopefully fixed possible display error
+
+
+0.6.5 (2014-06-14)
+
+New features:
+- Reworked usericon (badges) system, which also allows custom usericons,
+ either replacing the default ones or adding some of your own
+- Added Custom Commands, which allow you to define aliases for anything you
+ can enter into the inputbox (like chat messages, commands)
+- Added settings to add Custom Commands to the User/Channel Context Menus and
+ changed Timeout buttons setting to also add Custom Commands to User Dialog
+- Added option to always show the chat scrollbar, which can be useful for
+ streamers who always want to capture the same subregion of the window
+- Added /clearchat command which clears all text from the current chat window
+- Added settings for what to do when Chatty is started (show connect dialog
+ or connect immediately and autjoin channels etc.)
+
+Changes:
+- Only show the " has been banned from talking" message for users that
+ are currently known in the channel (that have said something, have joined,
+ been modded, etc.)
+- Removed hardcoded /slap command, but added it as default to Custom Commands
+- Removed "Set color" entry from User Context Menu, but added /setcolor
+ command (so it can be readded using Custom Commands if necessary)
+- Updated help
+- Changed list settings editor (used for Highlights, Logging, Commands)
+- Reorganized Settings Dialog a bit
+- Updated /testNotification command to also allow for a channel parameter
+- Changed Highlight Notification to switch to the channel the highlight
+ originated in (similiar to Stream Status Notifications)
+- Regular commands now case-insensitive
+- Handle image URLs which may brake due to possible changes in the Twitch API
+- Added /echo command to just output text as info message (e.g. for testing)
+
+Bugfixes:
+- Fixed speedrun.tv Race Link in SRL Race List context menu
+- Made "Races with.." search case-insensitive
+- Fixed possible flickering of chat window when being scrolled up
+- Remove linebreaks from messages send to the server
+- Fixed some possible display bugs in Settings Dialog
+- Right-clicking on emotes now works on the whole emote
+
+
+0.6.4 (2014-05-26)
+
+New features:
+- Added SpeedrunsLive (SRL) race viewer
+- Added automatic settings file backup (copies settings to the /backup folder
+ when you start Chatty, at most once per day)
+- Added Livestreamer support (start Livestreamer out of dialog/context menus)
+- Added feature for unique addressbook categories under some circumstances
+- Added "Simple Title" setting to have only "Chatty" as title (Extra menu)
+
+Changes:
+- Improved debug logging (added append to current file, max file size, rotate
+ between several files when max file size is reached)
+- Improved scrolling when window is made smaller
+- Added small delay between joins, automatically rejoin if join failed, added
+ "Joining #channel.." message (which indicates a JOIN was send to the server)
+- Some smaller improvements
+- Added commands to open the current settings/working directory
+- Updated help
+
+Bugfixes:
+- Possibly maybe fixed bug with default userlist width, but it can still be a
+ bit finicky
+- Fixed bug in Channel Favorites dialog when table is empty
+- Fixed /myemotes command
+- Fixed bug when joining channel out of popout
+
+
+0.6.3 (2014-05-15)
+
+New features:
+- Popout channels into their own window to be able to view them side-by-side
+- Added context menu and improved sorting to Channel Favorites dialog
+- Added check whether window restore position is actually on a screen (if not
+ then open on default position)
+- Added Highlight prefix to cutomize color for individual highlight items
+ (also added ordering buttons that can be necessary for this feature)
+- Added navigation buttons with page history to Help window
+- Added command to manually refresh emoticons (and badges if you rejoin)
+- Added command to show a list of your subemote codes (better emote
+ integration possibly maybe soon)
+- Added option to show action messages (/me) colored like in webchat
+
+Changes:
+- Commercials hotkey now simulates a click on the 30s button if the
+ Admin Dialog is open on the Commercials tab (so you can also use a delay)
+- Added more information to the emote context menu (unfortunately you have
+ to right-click on the left side of the emoticon to open it)
+- Changed default access options to all selected (you can still deselect them if
+ you don't need them and you think it's safer not having them on the token)
+- Decreased scrolling step a bit
+- Improved scroll detection for scrolled up timeout
+- Improved main window title change responsiveness
+- Some small improvements
+- Reorganized and updated help
+
+Bugfixes:
+- Fixed some possible errors by adding some checks
+- Fixed bug when adding a usercolor (not correctly enabled Done button)
+- Fixed bug canceling the list item edit dialog (highlights/logging)
+
+
+0.6.2 (2014-04-20)
+
+New features:
+- Admin Dialog: Select previously used or favorited stream status (title/game)
+ from the presets dialog for your title changing convenience
+- Optional new chat version that has no joins/parts but has better channel
+ association for bans/timeouts/subscribers and "xy just subscribed" message
+- Added /slap command due to S'ome demand
+- Improved connecting to chat (automatically trying different servers/ports)
+- Added more shortcuts and stuff
+- Added option to rejoin currently open channels when connecting
+
+Changes:
+- Moved Ignore joins/parts option to settings dialog
+- Some small improvements
+- Updated help
+
+Bugfixes:
+- Hopefully fixed synchronization error
+- Fixed error when editing game favorites
+- Fixed error when no stream title is set
+
+
+0.6.1 (2014-03-24)
+
+New features:
+- Added Addressbook to associate name with categories, that can be referenced
+ from usercolor settings and highlight settings
+- Added usercolor settings to locally assign custom usercolors
+- Option to restore dialog positions/reopen dialogs on start
+
+Changes:
+- Improved setting for timeout buttons/added to GUI, improved timeout messages
+- Highlight: Default username now matching on word bounds, added word bounds
+ matching prefixes, added highlight next messages
+- Reorganized settings dialog to accomondate new settings/features
+- Updated help
+- Parse /mods response to make users mods
+- Improved Named Colors panel in color chooser
+- Added Ctrl-Shift-Tab to switch to previous channel
+- Added server/port settings
+- Added setting to enable/disable stream status messages in chat
+
+Bugfixes:
+- Fixed FrankerFaceZ mod icon parsing to reflect recent changes
+- Fixed parsing error
+- Fixed userstats max length
+- Added scrolling to "Removed Streams.." list
+
+
+0.6 (2014-02-13)
+
+New features:
+- New more flexible notifications that replace the system tray notifications
+ (you can still switch back to them though)
+- Added chat logging to record messages and stream/chat infos to file
+- Added Spam Protection
+- Admin Dialog: Relative times, use own channel when no channel is joined,
+ last commercial run time, improved several channels support, dialog
+ not modal anymore, configurable commercial run delay, added help
+- Added message sound, load sound file names from sounds folder, improved
+ sound settings, changed volume values (you may need to adjust your volumes)
+- Check if connection was lost a bit faster depending on previous activity
+- Added new error dialog
+- Show important release information on first startup of new version
+
+Changes:
+- Changed shutdown process
+- Improved settings dialog (help, icons, components, restart required
+ warning)
+- Remove additional whitespace from incoming messages
+- Replace some special html character codes in incoming messages
+- Default userlist width setting, userlist width 0 now possible
+- Always output stream status on join (not only if it's new)
+- Improved help
+- Added setting to enable (and thus disable) open url prompts
+- Added Copy URL option to url prompt
+- Added setting to highlight own messages (always enabled before)
+- Added setting to change the tabs order (join order/alphabetical)
+- Added context menu item to clear the highlights dialog
+- Fixed bug in ViewerHistory when item was still hovered when channel
+ was changed
+- Added help window icon
+- Count number of mods on /mods-command response
+- Prevent auto-scrolling when search is active
+- Added speedrun.tv option for stream urls
+
+
+0.5.1 (2013-12-17)
+
+Changes:
+- FrankerFaceZ: Show custom mod icons (available in some channels)
+- FrankerFaceZ settings, Emoticons/Icon settings seperate
+- Prevent dialogs that can open automatically (error messages) from
+ stealing focus
+- Added chat buffer size setting
+- Added setting to enable/disable mod/unmod messages
+- Added some shortcuts
+- Added command to show working directory
+- Added color preset
+- Improved help
+- Improved viewer history (fixed times per channel)
+- Improved debug output
+- Added command/guide in case getting login data doesn't work
+
+Bugfixes:
+- Fixed error in Viewer history
+
+
+0.5 (2013-12-05)
+
+New features:
+- Get notified when streams you follow go online (requires
+ access,
+ which wasn't even in Chatty before, so you'll have to request new login data)
+- View a list of live streams (you followed or whose channel you are in)
+- FrankerFaceZ emoticons
+- Added search, allowing you to find text in the current chat window
+- Deleted messages (from timeouts/bans) now get shortened to a maximum length,
+ or you can use the previous behaviour or let the whole message be replaced with
+
+- Change the displayed time range in Viewer History
+- Automatically check if the login is valid, if it is suspected not to be
+- Clickable links in Channel Info Dialog (also turns #srl-abcd into a race link)
+- Cycle between tabs with Ctrl+TAB
+
+Changes:
+- Updated Help
+- Changed Settings Dialog Layout
+- Detect subscribers even when in more than one channel (may not work correctly
+ always, but it's a better guess than before)
+
+Bugfixes:
+- Changed color of inputbox cursor to foreground color
+- Possibly made emoticon image loading a bit more reliable, but it's hard to
+ tell what happens when the loading fails
+- Handle long URLs in the URL open dialog better
+
+
+0.4 (2013-11-16)
+
+New features:
+- Added version checker to inform you about new versions of Chatty
+- Added window icon
+- Added colors to viewer history to indicate stream status changes, hovering
+ displays stream title/game at that time (in addition to viewercount/time)
+- Stream information is now requested for all channels you have currently joined
+- Added tray notifications for highlighted messages and stream status changes
+- Added sound notifications for highlighted messages and stream status changes
+- Added some commandline parameters, settings and context menu entries
+
+Changes:
+- Nicks in JOIN/PART/MOD/UNMOD lines now clickable
+- Settings now saved in seperate files for general settings, login data and
+ history/favorites
+- Fixed tab colors, added indicator for new stream status
+- Added delay for global hotkey so it doesn't repeat as much if kept pressed
+- Updated and improved help
+- Added Mod/Unmod buttons to user dialog (only in your own channel)
+
+Bugfixes:
+- Fixed bug where a status change could reopen a tab that couldn't be closed
+- Improved error handling for API responses
+- Fixed bug where focus sometimes wouldn't be on inputbox when changing tabs or
+ clicking in channel
+
+
+0.3 (2013-09-19)
+
+New features:
+- Added Admin Dialog that let's you change the title/game of your stream
+ and run commercials (optional global hotkey for running commercials)
+- Added Channel Favorites/History that automatically saves channels you joined
+ and also allows you to add favorites (history can be deactivated in the
+ settings)
+- Added Highlight system that makes a message appear in another color if defined
+ keywords are found in it and/or it was send by a defined user (defaults to
+ always highlight your own name)
+- Added join dialog
+- Messages from user "twitchnotify" as info messages (when someone subscribed)
+- Added Warning when joining more than one channel
+- Added context menus for nicks/links/channel/tabs
+- Restore window position from last session
+- Better debugging and error handling
+- Automatically scroll down after 30s of inactivity when being scrolled up
+
+Changes:
+- User Info Dialog: Auto-update message history, show bans, show channel context
+- Lowered stream info (title, game, viewercount) update delay to 120s
+- Improved default user colors
+- Emoticons that contain only word characters match at word boundaries (to match
+ the new behaviour in Twitch Webchat)
+
+New settings:
+- Option for capitalized names
+- Option to show ban message (.. has been banned from talking), defaults to not
+ showing it
+- Color GUI settings (with default and dark preset)
+- And of course quite a few for the new features/bugfixes
+
+Bugfixes:
+- Fixed bug where channels would re-open without being
+ able to close them
+- Fixed bug where the userlist wasn't loaded correctly on join
+ when the channel was joined before in the same session
+- Disabled Direct3D Hardware Acceleration by default to possibly
+ fix Chatty appearing completely black under certain circumstances
+
+
+First published version was 0.2 so changelog starts from version 0.3.
diff --git a/help/0.8.1b/0_4_overview_top.png b/help/0.8.1b/0_4_overview_top.png
new file mode 100644
index 0000000..9b2625b
Binary files /dev/null and b/help/0.8.1b/0_4_overview_top.png differ
diff --git a/help/0.8.1b/followers.jpg b/help/0.8.1b/followers.jpg
new file mode 100644
index 0000000..e0ce6fe
Binary files /dev/null and b/help/0.8.1b/followers.jpg differ
diff --git a/help/0.8.1b/help-addressbook.html b/help/0.8.1b/help-addressbook.html
new file mode 100644
index 0000000..1bf8067
--- /dev/null
+++ b/help/0.8.1b/help-addressbook.html
@@ -0,0 +1,154 @@
+
+
+ Chatty - Addressbook
+
+
+
The addressbook allows you to add usernames and assign categories to
+ them, which can then be used in other places such as the Usercolor settings
+ or the Highlight settings.
+ Categories cannot contain spaces and are all made lowercase when added/loaded from file.
The addressbook dialog (<Main Menu> - Channels - Addressbook)
+ where all entries are listed and you can add/edit/remove entries.
+
From the user context menu (when you click on a user, then Addressbook)
+ where the entry for this user can be directly added/edited/removed. There
+ you can just select/unselect the categories this user should be in
+ (although only the categories that are already used in the addressbook
+ are listed, so if you want to add a completely
+ new category, you have to add it once by manually editing an entry).
In addition to the addressbook dialog and user context menu, there are also some commands to
+ edit the addressbook. All commands are prefixed with /ab
+ (e.g. /ab add <name>) or alternatively /users (e.g. /users add <name>):
+
+
add <name> - Adds a name
+
add <name> <categories> - Adds a name and directly assigns it the given categories, or adds the
+ categories to the name if it already exists (categories are comma-seperated, without spaces)
+
set <name> <categories> - Sets the categories for this name, adding it if necessary, replacing
+ any present categories for this name
+
remove <name> - Completely removes the given name
+
remove <name> <categories> - Removes the given categories from this name, but leaves
+ the name
+
change <name> <categoriesModification> - Prepend categories with +,
+ - or ! to add, remove or toggle the categories respectively. You can specify more than
+ one set of categories, for example: change test +a,b -c !d adds a and b, removes c and toggles d
+
get <name> - Shows the categories for this name
+
info - Shows number of entries and used categories
+
+
Categories are given as a comma-seperated list without spaces, e.g. cat1,cat2,cat3.
+
The following commands edit all entries at once, so they should be used with care:
+
+
renameCategory <currentName> <newName> - Renames a category, which means all occurences
+ of currentName are replaced with newName in all entries. This can also
+ be used to merge categories, if newName already exists.
+
removeCategory <name> - Removes the category with the given name from all entries
+
+
+
Command Examples
+
+
/ab add josh vip
+
Adds the category called vip to the user called josh
+
(Also adds the user to the addressbook in the first place, if not already there)
+
(josh's categories would now be: vip)
+
+
/ab set josh rainbow
+
Sets the categories of the user josh to rainbow, replacing
+ any previously associated categories
+
(josh's categories would now be: rainbow)
+
(Also makes josh kind of colorful in chat, try it out with your own name Kappa)
+
+
/ab add josh vip
+
Adds the category called vip to the user josh
+
(josh's categories would now be: rainbow,vip)
+
+
/ab remove josh vip
+
Removes the category called vip from the user josh,
+ keeping the other categories untouched
You can use this to let the moderators of your channel edit your addressbook.
+ Depending on what commands you allow them to use, this can be a powerful tool,
+ so make sure you keep an eye on what your moderators do.
+
+
The following settings affect the this feature (you have to change them
+ via setting commands):
+
+
+
abCommandsChannel
+
Set this to the channel you want this enabled in. You can reset the
+ setting to empty using the /clearSetting command to
+ disable the mod commands again.
+
/set abCommandsChannel #yourchannel
+
+
abCommands
+
A comma-seperated list of commands you want the mods to be able to
+ use. Commands can be anything that is
+ listed in the Commands section above. So for
+ example if you wanted to allow the add and set
+ commands, the setting value would be add,set (no spaces).
+
/set abCommands add,set
+
Default value for this is add,set,remove.
+
+
+
If you set the settings accordingly, then the mods will be able to use
+ e.g. !add name category to add name to your
+ Addressbook with the category category. Chatty will output
+ a message about the change, similiar to when you enter the command yourself.
+ It does not send a message to chat, so if you want your moderators to see an
+ actual response, you need to have Chatty on stream (which means the response
+ is also affected by stream delay of course).
This is a rather experimental feature, so it might not work reliably.
+
+
You can write Addressbook commands (one per line) to the addressbookImport.txt
+ file in the settings directory (enter /dir to find out what
+ your settings directory is). You can use any commands specified in the Commands section above, without
+ the /ab or /users prefix (since it's already
+ implied that they are Addressbook commands). For example:
To perform an import, enter the /abImport command and Chatty
+ will read the file and execute each command as if you would have entered
+ it in the input box. Information about the
+ command results is output in the debug window (Extra - Debug window)
+ and the debug log file.
+
+
You can also set the abAutoImport setting (/set abAutoImport on)
+ and the file will be read automatically within a few seconds when it is
+ detected to have been changed. You have to restart Chatty after changing
+ the abAutoImport value for it to take effect.
+ To make sure no data is lost, you should not
+ write to the file too often, or else it may already be overwritten once
+ changes are detected and the file contents are read and the commands performed.
+
+
It will also not be read automatically when you on start of Chatty,
+ so you should only apply changes while Chatty is running or
+ use the /abImport command to manually read the file once after
+ start. If you only change the file while Chatty is running, manually reading
+ the file should not be necessary.
Open the Admin Dialog via View - Channel Admin or by
+ right-clicking on the channel to open the context menu and choose
+ Channel Admin.
+
+
In the Admin Dialog you can change the title/game of your channel and
+ run commercials, if you have allowed the necessary access when getting your
+ login data. You need Editor access for changing game/title and
+ Commercial access for running commercials. See allow more access.
+
The Admin Dialog is always opened for the currently selected channel,
+ unless there is no channel open (which is the case just after you started Chatty),
+ in which case it will always be opened for your own channel, which is derived
+ from your configured account name.
The Status-Tab lets you view and change the title and game of your channel.
+ The information is loaded when you open the dialog and when you press the
+ reload-Button. If others may have changed the info in the meantime,
+ you may want to reload before trying to change it.
+
+
Select a game
+
When you select a game, another dialog will open where you should enter
+ part of the name of the game in the search field and hit Enter
+ or click the Search-Button to find the correct name, which
+ you can then select. You can also just use the name you entered yourself,
+ but you should usually use the search to make sure your stream appears in
+ the correct category on Twitch.
+
+
Use presets
+
There are also status presets, which allow you to add a combination of
+ title and game, so you can select it later. By pressing Fav
+ on the Status-Tab, you can add the current status to the favorites.
+ The status is also automatically added to the history every time you
+ press the Update button.
+
Press the Presets button to open a table with the favorites
+ and status history. You can filter the table by only showing entries for
+ the game currently have selected or only showing favorites.
+
History entries (the ones that are not favorites) are automatically
+ removed after some time, you can change when they are removed and
+ whether they should be added in the first place in the settings.
+
The Last Activity columns shows when this status was last
+ set using the Update button (or when it was added to the
+ favorites for the first time). The Usage column shows how
+ often it was set using the Update button.
If you are partnered with Twitch, you can run commercials on your channel
+ here (even if you are not partnered it may run a commercial). Click on the
+ appropriate button to try to run a commercial of the given length.
+
+
The Last run time shows when a commercial was last run
+ through Chatty (this session).
+
+
Schedule commercials
+
There are two different ways of scheduling a commercial, either running
+ a single commerical on a delay or repeating running a commercial on a delay.
+ Select either or both options and then press a Run commercial
+ button to schedule the commercial. Press the same button again to cancel the
+ scheduled commercial. Click a button of another length to change the length
+ of the commercial while keeping it on schedule. Scheduled commercials are
+ not completely exact, they may be run a few sceonds too late.
+
+
If you have Use delay selected, then the commercial will be
+ scheduled to run after the specified time. If you have Repeat selected,
+ then - after each commercial run through Chatty - another commercial will automatically be scheduled to run again with the same delay.
+ You don't need to have Use delay selected for Repeat
+ to work, they just both use the same time as delay.
+
+
The time for the delay will be interpreted as seconds by default, but you
+ can also specify minutes. Examples: 30 (30 seconds), 5m
+ (5 minutes), 120s (2 minutes).
+
+
Run commercials via global hotkey
+
If you have downloaded the appropriate version of Chatty (the one with
+ "hotkey" in the .zip filename, Windows only), you can define a global hotkey
+ to run 30s commercials on the channel you currently have open. The hotkey
+ can be defined on the Commercials tab in the Admin Dialog
+ (don't forget to press Set to actually set it).
+
+
If you have the Admin Dialog open on the Commercials tab,
+ then executing the hotkey will simulate a click on the 30s button, with all
+ the implications like being able to use a delay, running the commercial on
+ the channel that the Admin Dialog was opened on (instead of the currently
+ active channel) and so on.
+
+
+
diff --git a/help/0.8.1b/help-getting-started.html b/help/0.8.1b/help-getting-started.html
new file mode 100644
index 0000000..2bcd409
--- /dev/null
+++ b/help/0.8.1b/help-getting-started.html
@@ -0,0 +1,132 @@
+
+
+ Chatty Help - Getting Started
+
+
+
This is a short guide to help you with installing Chatty and getting familiar with some of it's features.
+
+
Download & Installation
+
You can download Chatty from it's Website.
+ The download simply consists of a .zip-file which you should
+ extract wherever you want to have Chatty. The extracted files include a
+ Chatty.jar which you should usually be able to double-click to
+ start the program (if Java is installed properly). (See the help
+ if Chatty won't start.)
+
+
Update Chatty
+
If you already have an older version of Chatty and want to update, then
+ just replace all the files with the new ones in the .zip.
+ Basicially just unzip the .zip into the same folder and overwrite
+ all files if asked (unless you have some custom icons or sounds that have the same name).
+ You can also unzip it into a new folder (just make sure you don't use the old version anymore).
+
+
Your settings are saved seperately in the settings directory
+ and are not lost when you upgrade to a new version. The new version should normally
+ automatically use the same settings without you needing to change anything.
+ If you are interested in what your settings directory is,
+ enter /openDir in Chatty. There is also a backup
+ folder in there with backups of the settings.
+
+
Please check out the Release Information for any changes in a new version that
+ may require your attention.
+
+
Note: If you downgrade to an older version of Chatty, some settings (that the older
+ version didn't have yet) may be lost. So make sure you don't run old versions of Chatty
+ without knowing what you are doing, if you have changed settings unique to newer versions.
+
+
Creating a login
+
If you are starting Chatty for the first time, you will have to request
+ login data from Twitch so Chatty can connect to chat for you and do other
+ stuff like show live streams you follow.
+
In the Connect-dialog, click on Create login..
+ and then Request login data and simply follow the instructions.
+ Once you successfully created the login, close the dialog until you get back
+ to the Connect-dialog. (There is a Guide on what to do
+ when getting login data fails.)
+
+
Join channels (and leave channels)
+
In the Connect-dialog enter the name of the channel you want
+ to join in the Channel: input box. The name of the channel
+ is the same as the name of the stream. You can enter more than one channel
+ name to join by seperating them with a comma. To connect simply press Enter
+ or click on Connect. After connecting, it will automatically join
+ the channels you specified.
+
+
Even after connecting you can join additional channels via Channels - Join Channel
+ or entering the command /join <channelname> in the inputbox
+ (e.g. /join joshimuz).
+
+
You can leave channels by right-clicking anywhere in the channel and
+ selecting Close Channel from the context menu or right-clicking
+ on the channel's tab (only available if there is more than one channel) and
+ selecting Close from the context menu.
+
+
Chatting and Moderating
+
Chatting is pretty straightfoward as you would expect from any chat program,
+ however the inputbox has a few useful features. Enter the beginning of a name
+ in chat and press TAB to auto-complete the name.
+ Press Up-Arrow key to go back to previous stuff you entered.
+
+
To moderate a chat, you can of course use the regular moderations commands
+ like /ban, /timeout and so on, but a much more
+ convenient method is to click on the name of a user you want to ban/timeout,
+ which opens the User-dialog, containing several moderation
+ buttons as well as the recent messages of that user, so you can quickly check
+ if you are actually timing out the correct user.
+
+
+
+
Information about the current stream
+
Chatty regulary requests information about the current stream, which is
+ displayed in the titlebar and the Channel Info-dialog.
+
+
+
+
You can open the Channel Info via the View-menu
+ or the channel context menu (right-click anywhere on the channel). The
+ Channel Info contains the current title/game but also a history
+ of the Viewercount and previous title/games (if you hover over points).
+
+
+
Get notified about streams you follow that go live (and join them)
+
Open the Live Channels-window via Channels - Live Channels
+ to open up a list of streams you follow that are currently live or streams
+ whose channel you have currently joined that are currently live.
+
+
(You need to have the required access with your login data to see streams
+ you follow.)
+
+
You can enable/disable showing streams you follow in the Settings - Notifications.
+ There you can also configure what kind of Tray Notification you want to have
+ pop up for stream status changes or highlighted messages.
+
+
To join channels directly out of the Live Channels-dialog
+ right-click on a stream to open the context menu and then select Join channel
+ to join the channel for that stream and if you want also open the stream in
+ your browser or Livestreamer.
+
+
More stuff you might want to try out..
+
+
Right-clicking, or whatever opens a context menu
+ in your OS. There are a lot of context menus in Chatty, e.g. for usernames
+ (as shown above), links, emoticons, anywhere else in the channel, tabs,
+ entries in favorites, the live streams dialog, the Channel Info dialog..
+
Configure Chatty to your needs. Open the Settings
+ from the Main-menu to get all kinds of settings to adjust
+ Chatty to your preference. Please make use of the Help link
+ in the bottom left corner of the Settings-dialog to get
+ help on the current page of settings you have selected.
+
Ask if you don't understand something. I tried to
+ make the help as comprehensive and easy to understand as possible, but
+ a lot of stuff is probably pretty confusing if you aren't as familiar with
+ the program as I am. So please ask about stuff and maybe also (if you can)
+ propose changes to the help that would make it easier to understand. There
+ are various ways to contact me.
If you want to run Chatty more than once at the same time, you may need
+ to know how it saves it's settings. By default the settings are saved
+ in your user-directory in the subfolder .chatty (where it is
+ exactly is system-dependant, enter /dir in Chatty to show it's location). When you run the program, it loads the settings
+ and when you exit the program, it saves them, overwriting the file with
+ no regard to possible changes (to the file) that may have occured in the meantime.
+
This means that when you run more than one instance on the same computer,
+ the last one you close always overwrites the settings.
+
+
Seperate settings
+
You can change the default settings directory by using the -cd
+ commandline paramter, which changes the settings directory to the current
+ working directory, meaning the settings are loaded and saved in the same
+ location you specified as working directory.
+
This means you can easily run more than one instance on the same computer
+ with completely different settings, just by using that commandline parameter
+ and specifying different working directories (e.g. in Windows in the shortcut
+ settings).
When you want to run several instances with different settings, but want
+ to use the same account, you run into problems. Everytime you request login
+ data (token), the old login is invalidated, so you have to share the login data
+ you already have between different instances.
+
+
You can do this by simply copying the login settings file
+ which contains the login data. Make sure you closed the Chatty instance
+ you requested the login data with at least once, so it's actually saved
+ to the file.
+
+
You could also try to play around with symbolic links
+ to point to a shared login file.
+
+
Using Chatty on different computers
+
If you want to run Chatty on different computers with the same account,
+ you run into the same problem as mentioned under Sharing login data:
+ You can't have more than one access token with the same account for the same
+ app at the same time.
+
To use Chatty on more than one computer with the same account, you'll
+ have to transfer the login data, either by copying the login
+ file or by entering the access token manually
+ (/get token displays the token,
+ /changetoken <token> changes it).
+
+
+
+
diff --git a/help/0.8.1b/help-guide2.html b/help/0.8.1b/help-guide2.html
new file mode 100644
index 0000000..c7e6b81
--- /dev/null
+++ b/help/0.8.1b/help-guide2.html
@@ -0,0 +1,111 @@
+
+
+ Chatty Help
+
+
+
Use this guide when the normal procedure of getting login data fails.
+
+
Can't listen to port
+
If you open the Get login data dialog and it says it can't
+ listen to the port, first check the following:
+
+
Make sure no other instance of Chatty is running that may already
+ have taken the port.
+
Check if no other program may already be listening to that port.
+
If the problem persists, reboot your PC and then try again.
+
+
If you can't fix this problem and there are no other error messages that
+ may indicate what is going wrong, then you can manually open the necessary
+ page (opening any of these links will invalidate any previous login
+ you requested for Chatty, so only do it if you really want to get a new one):
Since the webserver in Chatty won't run if you got any of the aforementioned
+ errors, your browser will tell you it can't load the page when you get to
+ http://127.0.0.1:61324. Read on in the next section, especially
+ Manually add the login into Chatty.
+
+
The browser says it can't open the page after you authorized Chatty
+
If you successfully opened the link, authorized Chatty on the Twitch.tv
+ page and got redirected, but the browser can't open the page, first check this:
+
+
If you followed the regular process until now, check if the
+ Get login data dialog is still open and it says Ready..
+ It needs to be open for this to work and will close automatically when it received
+ the necessary data.
+
+
If you can't get the page to load, you can manually add the login data into Chatty.
The information you need should be in the address bar of your browser (where you got the error that it couldn't connect to the page).
+ It should look something like this:
+ http://127.0.0.1:61324/token/#access_token=[longish mix of letters and numbers]&scope=chat_login+channel_editor+channel_commercial+user_read
+
+
The access_token (longish mix of letters and numbers)
+ is sort of a revokable password that lets Chatty
+ use some of the Twitch services on behalf of your account. Copy that from
+ the address bar, go to Chatty (close all dialogs if necessary) and paste
+ it into the following command (that you type into the input bar):
After entering the command, Chatty will finish the process by checking
+ the token and getting the username associated with it. If everything is ok,
+ it should say that you are now ready to connect.
+
If you want, you can check in Main - Login..
+ whether the token you entered has the correct access associated with it.
+
+
+
diff --git a/help/0.8.1b/help-guide_create_shortcut.html b/help/0.8.1b/help-guide_create_shortcut.html
new file mode 100644
index 0000000..3cdfecd
--- /dev/null
+++ b/help/0.8.1b/help-guide_create_shortcut.html
@@ -0,0 +1,42 @@
+
+
+ Chatty Help - Create Shortcut and add Icon
+
+
+
You can give the shortcut the Chatty icon, to replace the Java icon without changing it for all Java programs.
+
+
Create shortcut
+
Create a shortcut to Java to start Chatty:
+
First way
+
+
Right-click in the folder you want to create the shortcut in, choose New - Shortcut from the context menu. Enter javaw -jar "D:\Chatty\Chatty.jar" as location of the item.
+
Go to the next page and enter a name for the shortcut and finish creating the shorcut.
+
Right-click on the newly created shortcut and choose Properties from the context menu. Make sure that under Shortcut the Start in points to the folder that the Chatty.jar is in (otherwise some stuff might not work).
+
+
Second way
+
+
Right-click on the Chatty.jar and drag it to an open area in the folder, then let go to open the context menu, choose the option to create a shortcut.
+
Right-click on the newly created shortcut and choose Properties from the context menu. In the Target field, it should have the path to the Chatty.jar. Before that add: javaw -jar , so that in total it reads for example: javaw -jar "D:\Chatty\Chatty.jar"
+
+
+
Editing shortcut
+
Add launch options or icon:
+
+
Right-click on the newly created shortcut and choose Properties from the context menu, then go to the Shortcut tab.
+
Add any launch options you want to use with Chatty after the path to Chatty. For example: javaw -jar "D:\Chatty\Chatty.jar" -cd
+
Click Change Icon.. and then Browse.. to select an item to use for the Shortcut from your harddrive. (Download Chatty icon as .ico file, right-click and Save target as..)
+
+
Use shortcut
+
You can then start Chatty by using this shortcut or you can drag it to the taskbar to attach it to it.
+
+
+
diff --git a/help/0.8.1b/help-guide_folders.html b/help/0.8.1b/help-guide_folders.html
new file mode 100644
index 0000000..193c306
--- /dev/null
+++ b/help/0.8.1b/help-guide_folders.html
@@ -0,0 +1,135 @@
+
+
+ Chatty Help
+
+
+
The settings directory by default is in your user home directory in a
+ subfolder called .chatty. If you use the -cd
+ commandline parameter, then the settings directory is the current Working
+ Directory.
+
+
You can use commandline parameters by creating a shortcut and setting the
+ target to something like javaw.exe -jar "D:\Chatty\Chatty.jar" -cd.
+
Working Directory
+
This directory is associated with Chatty when you start it. This is usually
+ the directory the program is started from. If you created a shortcut to start
+ Chatty with, this may point to the Java-executable instead of Chatty itself,
+ which can lead to errors. In Windows, you can change the Working Directory
+ in the shortcut settings by changing what is defined under Run in.
+
JAR Location
+
This is where the Chatty.jar is located and is used for loading libraries
+ that Chatty uses.
+
+
Displaying Directories in Chatty
+
You can use the /dir command in Chatty to output the settings
+ directory and the /wdir command for the working directory
+ (/openDir and /openWdir to open them in the standard filebrowser).
+ You can also check the settings dialog for the directory where the logs
+ are saved in and the directory where the sounds are loaded from.
Chatty performs an automatic backup (enabled by default) everytime it is
+ started (if at least the number of days as defined in the settings have passed,
+ by default one). It copies the setting files (except login) to the backup folder
+ in the settings directory, increasing the numbering of the files with every
+ backup. It only makes as many backups as defined in the settings and then
+ starts over with the first number, rotating the files.
+
+
This is supposed to make recovery of settings easier in case they are not
+ read or written correctly and thus lost (which shouldn't usually
+ happen). In that case you can manually copy/rename the lost files from
+ a backup (just looks for the most recent one based on the change date
+ that looks fine).
+
+
If some settings are important to you this can help, but you
+ shouldn't rely on it. Always make your own backups, best on a
+ different device!
Some documentation of prior or current issues for reference.
+
+
+
Java Crash: Graphics Driver
+
+
Chatty just randomly closes, apparently the JRE completely crashes.
+
+
Crash report excerpt
+
+
+#
+# A fatal error has been detected by the Java Runtime Environment:
+#
+# EXCEPTION_ACCESS_VIOLATION (0xc0000005) at pc=0x000007f9c08f22bf, pid=272, tid=14464
+#
+# JRE version: Java(TM) SE Runtime Environment (7.0_45-b18) (build 1.7.0_45-b18)
+# Java VM: Java HotSpot(TM) 64-Bit Server VM (24.45-b08 mixed mode windows-amd64 compressed oops)
+# Problematic frame:
+# C [atig6txx.dll+0x122bf]
+
+[..]
+
+Stack: [0x000000000f5d0000,0x000000000f6d0000], sp=0x000000000f6c9bc0, free space=998k
+Native frames: (J=compiled Java code, j=interpreted, Vv=VM code, C=native code)
+C [atig6txx.dll+0x122bf]
+C 0x0000000000000000
+
+Java frames: (J=compiled Java code, j=interpreted, Vv=VM code)
+j sun.awt.Win32GraphicsDevice.getMaxConfigsImpl(I)I+0
+j sun.awt.Win32GraphicsDevice.getMaxConfigs(I)I+10
+j sun.awt.Win32GraphicsDevice.getConfigurations()[Ljava/awt/GraphicsConfiguration;+69
+j javax.swing.ToolTipManager.getDrawingGC(Ljava/awt/Point;)Ljava/awt/GraphicsConfiguration;+36
+
+[..]
+
+
+
Solution/Workaround
+
Seems to have to do with the graphics driver. Reinstalling/updating the graphics driver may
+help or using the following commandline parameter, which should disable the calls to the library
+that cause the error:
After some time, Chatty suddenly shows an error if using the Calibri font.
+
+
Excerpts
+
+
+java.lang.ArrayIndexOutOfBoundsException: 168
+ at sun.font.ExtendedTextSourceLabel.getCharX(ExtendedTextSourceLabel.java:353)
+ at java.awt.font.TextLine$3.computeFunction(TextLine.java:515)
+ at java.awt.font.TextLine.applyFunctionAtIndex(TextLine.java:651)
+ at java.awt.font.TextLine.getCharXPosition(TextLine.java:668)
+ at java.awt.font.TextLine.getCharLinePosition(TextLine.java:678)
+ at java.awt.font.TextLayout.buildCache(TextLayout.java:683)
+ at java.awt.font.TextLayout.ensureCache(TextLayout.java:655)
+ at java.awt.font.TextLayout.getAdvance(TextLayout.java:885)
+ at sun.font.FontDesignMetrics.charsWidth(FontDesignMetrics.java:510)
+ at javax.swing.text.Utilities.getTabbedTextOffset(Utilities.java:422)
+ at javax.swing.text.GlyphPainter1.getBoundedPosition(GlyphPainter1.java:213)
+ at javax.swing.text.GlyphView.getBreakWeight(GlyphView.java:722)
+ at javax.swing.text.ParagraphView.calculateMinorAxisRequirements(ParagraphView.java:732)
+ at javax.swing.text.BoxView.checkRequests(BoxView.java:935)
+ at javax.swing.text.BoxView.getMinimumSpan(BoxView.java:568)
+ at javax.swing.text.BoxView.calculateMinorAxisRequirements(BoxView.java:903)
+ at javax.swing.text.BoxView.checkRequests(BoxView.java:935)
+ at javax.swing.text.BoxView.setSpanOnAxis(BoxView.java:343)
+ at javax.swing.text.BoxView.layout(BoxView.java:708)
+ at javax.swing.text.BoxView.setSize(BoxView.java:397)
+ at javax.swing.plaf.basic.BasicTextUI$RootView.setSize(BasicTextUI.java:1714)
+ at javax.swing.plaf.basic.BasicTextUI.modelToView(BasicTextUI.java:1046)
+ at javax.swing.plaf.basic.BasicTextUI.modelToView(BasicTextUI.java:1022)
+ at javax.swing.text.JTextComponent.modelToView(JTextComponent.java:1428)
+ at chatty.gui.components.ChannelTextPane$ScrollManager.scrollDown(ChannelTextPane.java:1107)
+ at chatty.gui.components.ChannelTextPane$ScrollManager.access$200(ChannelTextPane.java:994)
+ at chatty.gui.components.ChannelTextPane.printInternal(ChannelTextPane.java:932)
+ at chatty.gui.components.ChannelTextPane.print(ChannelTextPane.java:906)
+ at chatty.gui.components.ChannelTextPane.printSpecials(ChannelTextPane.java:772)
+ at chatty.gui.components.ChannelTextPane.printMessage(ChannelTextPane.java:189)
+ at chatty.gui.components.Channel.printMessage(Channel.java:228)
+ at chatty.gui.MainGui$15.run(MainGui.java:1498)
+
+
+java.lang.ArrayIndexOutOfBoundsException: 0
+ at sun.font.ExtendedTextSourceLabel.createCharinfo(Unknown Source)
+ at sun.font.ExtendedTextSourceLabel.getCharinfo(Unknown Source)
+ at sun.font.ExtendedTextSourceLabel.getCharX(Unknown Source)
+ at java.awt.font.TextLine$3.computeFunction(Unknown Source)
+ at java.awt.font.TextLine.applyFunctionAtIndex(Unknown Source)
+ at java.awt.font.TextLine.getCharXPosition(Unknown Source)
+ at java.awt.font.TextLine.getCharLinePosition(Unknown Source)
+ at java.awt.font.TextLayout.buildCache(Unknown Source)
+ at java.awt.font.TextLayout.ensureCache(Unknown Source)
+ at java.awt.font.TextLayout.getAdvance(Unknown Source)
+ at sun.font.FontDesignMetrics.charsWidth(Unknown Source)
+ at javax.swing.text.Utilities.getTabbedTextWidth(Unknown Source)
+
+
+
Solution/Workaround
+
Hopefully this will be fixed in future Java updates, but for now just don't
+use a Calibri font.
Twitch Emoticons appear wrong when Chatty is displayed on a Retina display.
+Instead of the Emoticon images, the 404 image the Twitch CDN redirects to is
+shown.
+
+
Apparently in newer Java versions Toolkit.getImage() tries to find a higher
+resolution image by adding @2 to the file name, which the Twitch CDN actually
+responds to by redirecting to an error image, which is then displayed.
+
+
Solution/Workaround
+
Use Toolkit.createImage() and create an ImageIcon with the created image.
Livestreamer
+ is a commandline program that can be used to watch streams in a player like
+ VLC Player. It has to be downloaded and installed seperately from Chatty.
You can open the Livestreamer dialog that Chatty provides via
+ Extra - Livestreamer, where you can directly run Livestreamer
+ and change some settings.
+
+
Each time you open a stream via the dialog or a context menu, a tab is
+ added to the dialog where the output of the Livestreamer process is
+ redirected to. If you open a stream with the same stream name and quality you already
+ have open in a tab whose process isn't currently running, then that tab will
+ be reused.
+
+
The tab of a stream is automatically closed when you close the Video
+ Player opened by Livestreamer, if the dialog isn't currently open. Otherwise
+ you have to close it yourself by using the Close-button on the
+ top right, which turns into an End process-button as long as
+ the process is still running. The Retry-button can be used to
+ re-run the last command of that tab (for example when it couldn't find the
+ stream, but you want to retry now because you know it's come online).
The settings can be changed in the Livestreamer dialog.
+
+
Enable context menu entry: Adds Livestreamer to all
+ context menus that can be used to open streams (like User Context Menu,
+ Channel Context Menu or Live Streams Context Menu).
+
Show dialog when opening stream: Automatically open
+ the Livestreamer Dialog when you open a stream out of the context menu.
+
Context menu qualities: You can customize which
+ quality options appear in the context menu. The options you enter here
+ are directly given as a parameter to Livestreamer, except Select
+ which tells Chatty you want to select a quality in the dialog. Seperate
+ qualities by space or comma. Add a | (vertical bar) to add
+ a seperator to the menu.
+
+
+ Examples:
+
+
Best, High, Worst | Select
+
Source High Medium Low Mobile | Select
+
+
+
Base command or commandline options: This is used to
+ construct the command to run Livestreamer and is basicially the part
+ before the URL and the quality. This should point to the Livestreamer
+ program itself, including any commandline options you always want to have included. The default is just livestreamer, which
+ should usually be sufficient if the program is correctly included in
+ the systems PATH variable (or similiar), but it may also include the
+ full path to Livestreamer. Surround the path or any other parameter with quotes if it contains
+ spaces (e.g. "C:\My Programs\Livestreamer\livestreamer.exe").
+
+ Examples:
+
+
"C:\My Programs\Livestreamer\livestreamer.exe" --player "C:\Program
+ Files\MPC-HC\mpc-hc64.exe" (specify full path to Livestreamer
+ and use a different player)
+
/usr/local/bin/livestreamer (this might work on Linux/Mac
+ if it can't find Livestreamer without the full path)
+
+
+
+
Use Authorization (Twitch Oauth Token): Supplies to
+ Twitch Access Token that is used for Chatty to Livestreamer to authenticate
+ you when watching a stream via Livestreamer (probably only necessary to
+ be able to watch sub-only streams).
If you get an error like Error: java.io.IOException: Cannot run
+ program "<...>": CreateProcess error=2 [..], then
+ Chatty probably can't find Livestreamer on your system.
+
+
To solve this, first make sure that
+ you actually have Livestreamer installed. You need to install it on you own, it does
+ not come bundled with Chatty. If you are sure it is installed (and you maybe can
+ run it from the commandline just fine), you may have to tell Chatty the full
+ path to the Livestreamer executable for it to work by entering it in the
+ Base command or commandline options field. See the Settings section
+ above for examples and help on that.
If you want to use the /w (whisper) command and receive whispers in Chatty, read the
+ Help.
+
+
Full Changelog
+
+New features:
+- Added experimental Whisper support (this will probably not developed much
+ until Twitch moves Whispers to the new system)
+- Improved TAB Completion: Added predictive sorting for names which gives users
+ who recently talked/highlighted you a higher priority, added setting to
+ toggle completion to common prefix (disabled by default)
+- Added $first option for Custom Usericon restriction to show them in front of
+ the regular Usericons
+
+Changes:
+- Show long slowmode times as "> day" in the titlebar
+- Added "Open in online help" button in Help window
+- Allow global FFZ/BTTV to be added to the favorites as well
+- Added $globalmod and $anymod status identifiers for Usericons/Usercolors
+- Show indication of action message (/me) in User Info Dialog chat history and
+ log files (star in front of the message)
+- Updated help
+- Added timestamp option to "Log to file" settings (previously only changeable
+ with setting commands)
+- Highlight/Ignore: Allow non-standard channels in chan:/!chan: prefixes
+- Added Copy Stream Name to Channel Context Menu (Miscellaneous submenu)
+
+Bugfixes:
+- Fixed error in slowmode message parsing
+- Changed Ignore option config:info to only apply to info messages, not regular
+ chat messages
+- Fixed tab not showing new message if message was highlighted with
+ config:!notify option
+
Improved Emoticon Dialog: Shows all global emotes and a detail
+ view for emotes.
+
TAB Completion: Now supporting completion of emotes (Shift-TAB),
+ setting names (TAB when typing after a setting command)
+ and custom completion items which can be added in the settings.
+ Also added popup showing info during completion and changed behaviour
+ a bit accordingly.
+
Correctly capitalized names are now enabled by default, since support
+ for the new display name tag that Twitch Chat provides has been added.
+
Added ability to write the current stream time to a textfile, aiding
+ in making Stream Highlights
+ (either by entering a command or allowing your mods to run the command).
+
+
+
Full Changelog
+
+Core Changes:
+- Connection: Implemented IRCv3 tags/commands/membership support
+- Userlist: IRCv3 now supports optional joins/parts (correct userlist), which is
+ enabled by default in Chatty (doesn't mean joins/parts have to be shown)
+- Added experimental support for secured connections
+
+Emoticons:
+- Changed Emoticon parsing to use spaces as delimiter instead of word boundaries
+ (to match changes made to Twitch Chat)
+- Scaling: Added settings to scale emotes in chat and the Emotes Dialog
+- BTTV: Implemented BTTV Custom Channel Emotes, switched to new BTTV API
+- IRCv3: Implemented new Twitch Emotes API, including using IRCv3 tags
+- Emote Dialog: Added overview of all global emotes (Twitch and Other)
+- Detail View: Added Detail View that can be opened for an emote with different
+ scaling and a table of information about the emote
+- Context Menu: Added more entries and information
+- Added emote image caching, making loading of emotes a bit faster and hopefully
+ more reliable if the server can't be reached at the time of loading
+- Added feature to add custom emotes (locally), also allowing you to replace
+ other emotes
+- FFZ: Switched to new API (and showing more info about the emotes)
+
+TAB Completion:
+- Changed to work with @ in front (or any other non-word characters around it)
+- Added info popup to show completion information (how many items are found,
+ which item you are at while cycling through results)
+- Added completion for emotes (Shift-TAB)
+- Added completion for setting names (TAB when using after setting command)
+- Added completion for some commands (TAB after /)
+- Added support for custom completion items that you can add in the settings or
+ via the /customCompletion command
+
+StreamChat:
+- Added fitting context menu to stream chat dialog
+- Added setting to START inserting text a the top in Stream Chat
+ (but not insert text at the top in general), added streamChatResizable setting
+- Added commands /clearStreamChat, /testStreamChat, /setStreamChatSize,
+ /getStreamChatSize
+
+Other Enhancements:
+- Added bot badge (bot names from BTTV/FFZ APIs and local setting)
+- Added ability to record current stream time via commands to assist in creating
+ stream highlights
+- Added setting to clear chat when channel is cleared by a moderator
+- Hosting: Added info in the title which channel is being hosted, added warning
+ in chat when a channel is still being hosted when the stream is going live
+- Streamlined reconnection messages a bit
+- Output message if channel attempting to join doesn't exist on Twitch
+- Added correctly capitalized names from IRCv3 display-name tag, removed
+ commands to change capitalization of names locally
+- Added experimental showing of slowmode/submode status in the titlebar (only
+ shows correctly if mode toggled while you are already in the channel, until
+ chat sends that info on join as well)
+- Added feature to locally set custom names for any user which show up in chat
+ and the userlist
+- Highlighting: Added more prefix options
+- Ignore: Added prefix option to ignore info messages
+- Added Miscellaneous-menu to User Context menu and added entry Copy Name
+ (meaning copy to clipboard)
+- Added Miscellaneous-menu to Channel Context menu and added entry to join
+ currently hosted channel
+- Added /copy command which copies the given text to the clipboard
+- Added /color command which redirects to the Twitch Chat /color command
+- Added /livestreamer command to open streams/dialog via command
+- Added /appinfo command
+- Added /r9k and /r9koff commands
+- Added workaround for Twitch API sometimes returning stream information with
+ missing channel object (no title available), assuming previous title
+- Updated help
+
+Changes:
+- Files: Moved cache files to be saved in the /cache folder
+- Reduced Twitch API debug log spam a bit
+- Increased join delay a bit
+- Updated Settings Dialog layout to adjust to the dialog size better
+- Changed Twitch API version calls to use v3 by default
+- Changed Usericon image files starting with "http" to be interpreted as URL
+- Disabled auto request of mods list for the time being, since mod status for
+ messages should always work and mod status in the userlist should probably
+ work if the userlist works in the first place
+- Decreased Live Streams dialog scroll speed a bit
+
+Settings:
+- Highlighting: Added highlightIgnored setting whether to try to highlight
+ messages that have already been ignored (disabled by default)
+- Changed capitalizedNames (first letter only) setting to default to on (only
+ affects fresh settings)
+- Debugging: Added setting to log raw IRC traffic to file (disabled by default)
+- Added mainResizable setting to be able to turn off resizing of the main window
+- Added setting to ignore Stream Status Notifications for Stream Offline
+- Added some more support for different setting types to setting commands
+- Changed setting commands to support numeric lists
+- Changed Settings Dialog to only tell you to reconnect if you don't have to
+ also restart Chatty (required by a setting change)
+
+Bugfixes:
+- Fixed bug where channel would constantly be reopened when it failed to join
+ (especially happening on non-existing channels)
+- Fixed bug where reonnection timer would sometimes not be cancelled
+- Fixed synchronization that could lock up the GUI when performing API requests
+- Fixed username case-sensitivity issues for commands
+- Fixed error in stream status writer when stream doesn't have a game set
+- StreamChat: Fixed bug where stream chat wouldn't scroll down properly
+- Addressbook: Fixed remove commands issues with case-sensitivity
+- Run correct commercial length in Admin Dialog when using a hotkey
+- Fixed close channel hotkey to close active channel rather chan active tab
+- Possibly fixed some info messages from Twitch Chat not showing up
+- Changed "Mr. Freeman" to "Dr. Freeman"
+- Fixed rare error in tables (like Follower Dialog)
+- Fixed and enabled workaround for some combining characters causing performance
+ issues (replacing more than two combining characters in a row with ****)
+
You can now customize hotkeys (regular, application-wide and global
+ hotkeys) that you can set to perform certain predefined actions and
+ any command (Global Hotkeys Windows only).
+
Improved character display, allowing potentially more characters to
+ be displayed (depending on what fallback fonts are available).
+
+
+
Important Information
+
+
If you were using a global commercial hotkey before, you will have
+ to redefine it when changing to this version (in the Settings - Hotkeys).
+
+
+
Full Changelog
+
+New features:
+- Added customizable hotkeys feature allowing you to add/remove/change hotkeys
+ in the settings (Global Hotkeys Windows only)
+- Added Stream Chat dialog (only regular messages, optional message timeout to
+ make them disappear after some time, mainly for testing right now)
+- Added support for global mods
+- Added $chan parameter to Custom Commands
+- Log to file: Added setting to customize timestamp (via setting commands)
+
+Changes:
+- Changed inputbox font to prevent bug where fallback fonts wouldn't work
+ properly in JTextPane
+- Changed default for "Restore dialogs" setting to "Restore dialogs from last
+ session" (only if you start from fresh settings)
+- Backup: Increased setting backup count to 5 backups
+- Changed staff usermode symbol to & (text symbol, not the badge)
+- Added scaling to emotes if the image is too big, set maximum size to 100x50
+- Improved setting commands (added add/remove commands for String lists, save
+ default for lists/maps), improved help for setting commands
+- Added "set:" commandline parameter to set any setting that can be set with the
+ /set command
+- Changed to new BTTV emotes API
+- Improved URL parsing a bit
+- Updated help
+
+Bugfixes:
+- Fixed Simple Title menu setting not being updated correctly
+- Set foreground color of Viewer History based on the current foreground color
+ of the dialog, so it fits the LAF
+- Set Notification foreground color to black, in case a LAF uses another color
+ that doesn't go well with the yellow background (Notification colors should be
+ customizable eventually)
+
Timeout users (and more) using keyboard shortcuts. Use the
+ User Selection Mode
+ (toggle with Ctrl-Space, then W/S and E to open
+ User Dialog) and the new keyboard shortcuts in the User Dialog for
+ quicker access to Timeout/Ban Buttons and Custom Commands you added.
+New features:
+- User Dialog Buttons (Timeout/Custom Commands) now support shortcuts, Ban and
+ Unban buttons are not hardcoded anymore and have to be added to the setting
+ (setting is automatically changed if you switch from a version before 0.7.2)
+- Added User/Line Selection feature to select a User in chat via the keyboard
+ so e.g. timeouts are possible completely via the keyboard
+- Added feature to modify Addressbook entries via a file
+- Added color restriction for Usericons
+- Highlight/Ignore: Added prefixes ("start:", "status:", "!status:", "!cat:",
+ "chanCat:", "!chanCat")
+- Channel Info Dialog now allows to be resized a lot smaller, Viewercount info
+ now adjusting better to smaller sizes
+- Added setting to change Look&Feel (only Default and System for now)
+- Added setting to attach dialogs to main window, so they always stay in the
+ same relative position when the main window is moved
+- Added some keyboard shortcuts
+- Added some support for FFZ feature friday, added /ffzGlobal command to show
+ global FFZ emote codes
+
+Changes:
+- Added menu entry to open login configuration for easier access (no need to
+ disconnect from chat)
+- Improved login configuration dialog
+- When login was determined invalid by automatic check: Changed warning message,
+ don't remove automatically anymore but let user do it if necessary
+- Added Options submenu to View menu to allow more options with direct access
+- Added more options to Title/Game Presets dialog due to S'ome demand
+- Logging to file now enabled by default (only if you start from fresh settings)
+- MOD/UNMOD messages are now disabled by default (from fresh settings)
+- Custom Commands executed from the Channel Context Menu now include the name
+ of the channel as first parameter (without leading #)
+- Some small improvements of labels/info texts in Settings Dialog
+- Increased join delay, increased delay between failed join attempts
+- Ping connection more often if inactive to detect disconnect quicker and
+ possibly prevent disconnect in some cases
+- Improved URL detection (again)
+- Improved debug messages a bit
+- Improved error catching in some places
+- Added more tests
+- Updated help
+
+Bugfixes:
+- Fixed URLs that don't have a protocol prefix (e.g. http://) being opened
+ without a prefix, which resulted in the browser not opening correctly
+- Fixed error in FrankerFaceZ emote parsing
+- Fixed bug where "Close to tray" wouldn't work without "Minimize to tray" being
+ enabled as well
+- Fixed layout problem in Settings Dialog when log path was too long
+- Use usercolor corrected for readability for colored /me messages
+
You can now add your favorite Twitch Emotes to the new Favorites
+ page of the Emote Dialog. Right-click on the emote you want to add to
+ open the context-menu and click on Favorite, then open the
+ Emote Dialog (Extra - Emoticons or Ctrl+E) and
+ choose the Favorites page to view your favorites.
+
+
Important Information
+
+
The default location to write stream information to has been changed
+ to the exported subfolder of the settings directory (so
+ e.g. C:\Users\name\.chatty\exported\). If you are using
+ this feature e.g. by refering to the created textfiles in your
+ streaming software, you'll have to adjust the path to the textfile
+ there.
+
+
+
Full Changelog
+
+
+New features:
+- Added Emoticon Favorites, that are displayed in the Emote Dialog (you can only
+ add Twitch Emotes for now, not FFZ or BTTV)
+- Added support for correct capitalization of names in chat (experimental, you
+ have to enable it in the settings if you want to try it)
+- Show correctly capitalized stream names in Live Streams/Channel Info Dialog
+ (independent of the Correctly Capitalized Names setting)
+- Added minimize to tray/close to tray options
+- Added setting for auto scroll down timeout length
+- Added setting to change font size of dialogs (experimental, only Userinfo now)
+- Added setting to customize chat log file location
+- Added context menu to Follower/Subscriber Dialog to export list to file
+- Added support for FrankerFaceZ global event emotes
+
+Changes:
+- Changed tray icon to only show when needed
+- Set proper tooltip for tray icon
+- Added some more timestamp options
+- Changed stream status writer output to "exported" subfolder of settings folder
+- Changed stream status writer to ignore case of stream name
+- Channel Info: Added approx. last stream length as tooltip to "Offline" text
+- Changed Twitch badges to use images instead of alpha (shows new colors now)
+- Changed base colors for badges to new Twitch colors (affects FFZ Mod Icon and
+ Fallback Icons)
+- Allow for selection of text in chat by double-clicking (focus to inputbox now
+ only on single-click on chat)
+- Detect a few more URL formats to be made clickable
+- Improved debug logging a bit (memory usage)
+- Some small improvements to memory usage
+- Added some more characters to Font Selection Dialog, but also an input field
+ to enter your own text to test the font
+- Catch the error if hotkey library couldn't be found and output warning instead
+- Updated help
+
+Bugfixes:
+- Fixed info messages sometimes going to the wrong window if popouts are used
+- Fixed subscriber sorting in userlist (but overall sorting can still be screwed
+ up sometimes)
+- Fixed wrong channel being joined when joining channel out of user context menu
+ with "Capitalize Names (First Letter)" option being enabled (fixed implicitly
+ by changing some stuff around for supporting capitalized names)
+- Added workaround for Twitch emotes appearing wrong on Retina displays
+- Nothing to do with Chatty in particular (it's the same for every IRC client),
+ but the "xy just subscribed" message should now work for everyone again,
+ because Twitch fixed it :)
+
Added Emoticon Dialog showing your Subscriber and Turbo emotes as
+ well as channel specific emotes.
+
Followers and Subscribers lists
+ showing your most recent followers and subscribers (you probably
+ need to request new login data with the necessary access for the
+ subscriber list to work).
Just a reminder: If you don't care about a correct userlist or joins/parts,
+ you may want to switch to Twitch Client Version 3 (Settings - Advanced),
+ which has a few advantages.
+ More information..
+
+
Full Changelog
+
+New features:
+- Added Emoticon Dialog, showing emotes you paid for (Subscriber/Turbo) and
+ channel-specific emotes (FFZ/BTTV)
+- Added Followers/Subscribers lists, added new follower sound (works only if
+ Followers Dialog is open)
+- Livestreamer: Added setting to use auth (for sub-only streams), added setting
+ whether to open the Livestreamer Dialog when opening a stream from the menu
+- Added setting to write stream info to a file (e.g. for display on stream)
+- Automatically request moderator list once per channel, added /fixMods command
+ to temporarily fix mods status without showing the list of all moderators
+- Added /host and /unhost commands
+- Added shortcut Ctrl-W to close active tab/restore popout to tab
+- Admin Dialog: Added option to automatically repeat commercial on the set delay
+- Added stream uptime to Channel Info Dialog (how long ago a stream was started)
+
+Changes:
+- Changed message parsing to support "<name> is now hosting you" notification
+ (only works on Twitch Client Version 3 though, see Settings - Advanced)
+- Added setting to specify the timezone of the timestamp seperately from the
+ system timezone setting
+- Added kadgar.net to open live streams from the context menu
+- Added optional filter to remove combining characters used in some languages
+ that may cause an error in some cases
+- Livestreamer: Reuse open tabs if process stopped and opening stream with the
+ same stream/quality, re-enable quality selection buttons if process stopped,
+ improved labels and help
+- Added more timestamp options in the settings and changed to showing as example
+- Added gzip support to Twitch API requests
+- Added check to confirm status of stream going offline, which may or may not
+ prevent wrong offline notifications if the Twitch API returns false data
+- Added hint about entering Twitch Commands in invalid command message
+- Updated help
+
+Bugfixes:
+- Fixed error in message parsing
+- Fixed display error with ban messages
+- Fixed a possible bug with notifications
+- Now showing "<number> /host commands remaining this half hour." message
+
Changed Game Select Dialog to using just one single list for both
+ the Game Favorites and the search result (to use the available space
+ more efficiently).
+
+
+
Full Changelog
+
+New features:
+- Added support for some of the BetterTTV emotes
+- Added feature to ignore indiviual emotes, which makes them not turn into an
+ image (but their code will still show up)
+- Changed game select dialog to one single list for favorites/search as to not
+ waste so much space
+- Added setting to change the livestreamer command (so you can also e.g. set the
+ full path to Livestreamer if necessary)
+- Added option to combine ban messages of the same user within 10 seconds, for
+ example "<name> has been banned from talking (3)" means banned 3 times
+- Added "/ab change" command to add/remove/toggle categories in a single command
+- Added /uptime command
+- Added /openUrl and /openUrlPrompt commands (for use in custom commands)
+- Added ignore setting to not show ignored messages info (count/nick) in chat if
+ the ignored messages dialog is currently open
+
+Changes:
+- Live Streams window always on top of main window (seems a bit flickery though)
+- More Dialogs now closeable with ESC
+- Added Ctrl+J shortcut for opening Join Dialog
+- Save Channel Favorites sort order between sessions
+- Increased number of saved lines per user from 20 to 100
+- Reorganized Settings Dialog a bit (Usericons/Emoticons on seperate pages)
+- Added context menu to Race Id (blue link) in Race Viewer
+- Possibly improved debugging of emoticon loading errors a bit
+- Updated help
+
+Bugfixes:
+- Search dialogs (Ctrl+F) fixed for popouts
+- Fixed error on update notification
+- Improved API response parsing a little bit
+- Fixed context menus in Highlights/Ignored Messages dialogs
+
Ignore chat messages by keyword,
+ username, addressbook category and channel, then choose whether to
+ completely hide them, show how many were ignored every 30s (if any)
+ or show which users where ignored. Ignored messages also get added
+ to a seperate window so you can check them if you want to.
+
Improved Update Notification.
+
Livestreamer context menu
+ quality selection customizable.
+
Improved Emoticon Context Menu (right-click on any emoticon image),
+ now allowing you to insert the emote code into your chat message by clicking the menu entry
+ showing the emote code (and added some more information and options
+ for subscriber emotes).
+
+
Important Information
+
+
Addressbook categories are now all lowercase. If you have any
+ categories that only use case to differentiate between them, this might
+ be a problem for you. Otherwise it should make things a bit clearer and
+ easier.
+
+
+
Full Changelog
+
+New features:
+- Ignore messages (similiar to the Highlight system, match messages by keywords,
+ usernames, addressbook categories and channels)
+- Improved Emote Context Menu (now with channel name on subemotes and clicking
+ on emote code inserts it in the input box)
+- Improved subscriber detection on Twitch Client 1
+- Improved Update Notification to now also show in the Main Menubar (clicking
+ on it opens a window showing the changelog)
+- Livestreamer Context Menu quality selection now customizable
+- Added some commands (including /ffz to show FFZ emotes of the current channel,
+ some commands to open dialogs and stuff intended for use in Custom Commands)
+
+Changes:
+- Addressbook categories are now all made lowercase when added/loaded from file
+- Regular commands can now be also used in Context Menus/User Dialog settings
+- Improved error handling a bit (hopefully)
+- Removed Ignore Joins/Parts setting in favor of Twitch Client 3
+- Changed Twitch Client 1/3 setting to include small explanation
+- Added sort by viewercount in Live Streams Dialog
+- Added chan: and !chan: prefixes (Highlights and Ignore)
+- Updated help
+- Show how many Highlighted/Ignored messages are in the dialogs in the View-menu
+- Improved text settings editor (auto adjust size when typing, added help)
+- Changed Context Menu/User Dialog settings to allow more flexible formatting
+ (linebreaks allowed, / for command optional, | for seperator doesn't have to
+ be directly in front of a command, but still applies to the following one)
+- Moved to new FFZ server and updated parsing (recently added emotes should now
+ show up)
+
+Bugfixes:
+- Fixed horizontal scrolling sometimes happening in chat window
+- Fixed URL Context Menu stream detection to be case-insensitive
+- Fixed display of "<" in Notifications
+- Hopefully fixed possible display error
+
Reworked usericon (badges) system to be more flexible and allow for
+ Custom Usericons.
+
Added Custom Commands,
+ allowing you to define aliases for anything you could also enter into
+ the inputbox manually (and also add those custom commands to the User/Channel
+ Context Menus and the User Dialog).
+
+
+
Full Changelog
+
+New features:
+- Reworked usericon (badges) system, which also allows custom usericons,
+ either replacing the default ones or adding some of your own
+- Added Custom Commands, which allow you to define aliases for anything you
+ can enter into the inputbox (like chat messages, commands)
+- Added settings to add Custom Commands to the User/Channel Context Menus and
+ changed Timeout buttons setting to also add Custom Commands to User Dialog
+- Added option to always show the chat scrollbar, which can be useful for
+ streamers who always want to capture the same subregion of the window
+- Added /clearchat command which clears all text from the current chat window
+- Added settings for what to do when Chatty is started (show connect dialog
+ or connect immediately and autjoin channels etc.)
+
+Changes:
+- Only show the "<user> has been banned from talking" message for users that
+ are currently known in the channel (that have said something, have joined,
+ been modded, etc.)
+- Removed hardcoded /slap command, but added it as default to Custom Commands
+- Removed "Set color" entry from User Context Menu, but added /setcolor
+ command (so it can be readded using Custom Commands if necessary)
+- Updated help
+- Changed list settings editor (used for Highlights, Logging, Commands)
+- Reorganized Settings Dialog a bit
+- Updated /testNotification command to also allow for a channel parameter
+- Changed Highlight Notification to switch to the channel the highlight
+ originated in (similiar to Stream Status Notifications)
+- Regular commands now case-insensitive
+- Handle image URLs which may brake due to possible changes in the Twitch API
+- Added /echo command to just output text as info message (e.g. for testing)
+
+Bugfixes:
+- Fixed speedrun.tv Race Link in SRL Race List context menu
+- Made "Races with.." search case-insensitive
+- Fixed possible flickering of chat window when being scrolled up
+- Remove linebreaks from messages send to the server
+- Fixed some possible display bugs in Settings Dialog
+- Right-clicking on emotes now works on the whole emote
+
Added Livestreamer support, with a dialog (Extra-menu)
+ and optional context menu entry.
+
+
+
Full Changelog
+
+New features:
+- Added SpeedrunsLive (SRL) race viewer
+- Added automatic settings file backup (copies settings to the /backup folder
+ when you start Chatty, at most once per day)
+- Added Livestreamer support (start Livestreamer out of dialog/context menus)
+- Added feature for unique addressbook categories under some circumstances
+- Added "Simple Title" setting to have only "Chatty" as title (Extra menu)
+
+Changes:
+- Improved debug logging (added append to current file, max file size, rotate
+ between several files when max file size is reached)
+- Improved scrolling when window is made smaller
+- Added small delay between joins, automatically rejoin if join failed, added
+ "Joining #channel.." message (which indicates a JOIN was send to the server)
+- Some smaller improvements
+- Added commands to open the current settings/working directory
+- Updated help
+
+Bugfixes:
+- Possibly maybe fixed bug with default userlist width, but it can still be a
+ bit finicky
+- Fixed bug in Channel Favorites dialog when table is empty
+- Fixed /myemotes command
+- Fixed bug when joining channel out of popout
+
Right-click on a tab to not only Close but also
+ Popout the channel.
+
Using the commercial hotkey now will simulate a click on the
+ 30s button if the Admin Dialog is open on the
+ Commercials tab.
+
+
+
Full Changelog
+
+New features:
+- Popout channels into their own window to be able to view them side-by-side
+- Added context menu and improved sorting to Channel Favorites dialog
+- Added check whether window restore position is actually on a screen (if not
+ then open on default position)
+- Added Highlight prefix to cutomize color for individual highlight items
+ (also added ordering buttons that can be necessary for this feature)
+- Added navigation buttons with page history to Help window
+- Added command to manually refresh emoticons (and badges if you rejoin)
+- Added command to show a list of your subemote codes (better emote
+ integration possibly maybe soon)
+- Added option to show action messages (/me) colored like in webchat
+
+Changes:
+- Commercials hotkey now simulates a click on the 30s button if the
+ Admin Dialog is open on the Commercials tab (so you can also use a delay)
+- Added more information to the emote context menu (unfortunately you have
+ to right-click on the left side of the emoticon to open it)
+- Changed default access options to all selected (you can still deselect them if
+ you don't need them and you think it's safer not having them on the token)
+- Decreased scrolling step a bit
+- Improved scroll detection for scrolled up timeout
+- Improved main window title change responsiveness
+- Some small improvements
+- Reorganized and updated help
+
+Bugfixes:
+- Fixed some possible errors by adding some checks
+- Fixed bug when adding a usercolor (not correctly enabled Done button)
+- Fixed bug canceling the list item edit dialog (highlights/logging)
+
The port setting has changed. If you have changed the port setting
+ to another value before, it will be reverted to the new default with
+ this update.
+
With the introduction of group chat, Twitch apparently removed the
+ "xy just subscribed" messages from the chat version Chatty uses. There
+ was also a new version introduced that still has those messages and is
+ generally better (association of bans/info messages/subscribers to
+ channels), but it lacks joins/parts, which means no joins/parts can be
+ shown and the userlist will only contain those people who have said
+ something.
+
+ If you don't care about showing joins/parts and you don't care about
+ a correct/complete userlist, then it may be beneficial for you to
+ enable the Chat Client Version 3 option in the Settings
+ Dialog under Advanced. More information..
+
+
Full Changelog
+
+New features:
+- Admin Dialog: Select previously used or favorited stream status (title/game)
+ from the presets dialog for your title changing convenience
+- Optional new chat version that has no joins/parts but has better channel
+ association for bans/timeouts/subscribers and "xy just subscribed" message
+- Added /slap command due to S'ome demand
+- Improved connecting to chat (automatically trying different servers/ports)
+- Added more shortcuts and stuff
+- Added option to rejoin currently open channels when connecting
+
+Changes:
+- Moved Ignore joins/parts option to settings dialog
+- Some small improvements
+- Updated help
+
+Bugfixes:
+- Hopefully fixed synchronization error
+- Fixed error when editing game favorites
+- Fixed error when no stream title is set
+
+New features:
+- Added Addressbook to associate name with categories, that can be referenced
+ from usercolor settings and highlight settings
+- Added usercolor settings to locally assign custom usercolors
+- Option to restore dialog positions/reopen dialogs on start
+
+Changes:
+- Improved setting for timeout buttons/added to GUI, improved timeout messages
+- Highlight: Default username now matching on word bounds, added word bounds
+ matching prefixes, added highlight next messages
+- Reorganized settings dialog to accomondate new settings/features
+- Updated help
+- Parse /mods response to make users mods
+- Improved Named Colors panel in color chooser
+- Added Ctrl-Shift-Tab to switch to previous channel
+- Added server/port settings
+- Added setting to enable/disable stream status messages in chat
+
+Bugfixes:
+- Fixed FrankerFaceZ mod icon parsing to reflect recent changes
+- Fixed parsing error
+- Fixed userstats max length
+- Added scrolling to "Removed Streams.." list
+
The sound volume values have been changed, you should readjust the
+ volumes when you use this feature.
+
Chatlog is disabled by default, enable it in the settings if you
+ want to use it.
+
+
Full Changelog
+
+New features:
+- New more flexible notifications that replace the system tray notifications
+ (you can still switch back to them though)
+- Added chat logging to record messages and stream/chat infos to file
+- Added Spam Protection
+- Admin Dialog: Relative times, use own channel when no channel is joined,
+ last commercial run time, improved several channels support, dialog
+ not modal anymore, configurable commercial run delay, added help
+- Added message sound, load sound file names from sounds folder, improved
+ sound settings, changed volume values (you may need to adjust your volumes)
+- Check if connection was lost a bit faster depending on previous activity
+- Added new error dialog
+- Show important release information on first startup of new version
+
+Changes:
+- Changed shutdown process
+- Improved settings dialog (help, icons, components, restart required
+ warning)
+- Remove additional whitespace from incoming messages
+- Replace some special html character codes in incoming messages
+- Default userlist width setting, userlist width 0 now possible
+- Always output stream status on join (not only if it's new)
+- Improved help
+- Added setting to enable (and thus disable) open url prompts
+- Added Copy URL option to url prompt
+- Added setting to highlight own messages (always enabled before)
+- Added setting to change the tabs order (join order/alphabetical)
+- Added context menu item to clear the highlights dialog
+- Fixed bug in ViewerHistory when item was still hovered when channel
+ was changed
+- Added help window icon
+- Count number of mods on /mods-command response
+- Prevent auto-scrolling when search is active
+- Added speedrun.tv option for stream urls
+
Changes:
+- FrankerFaceZ: Show custom mod icons (available in some channels)
+- FrankerFaceZ settings, Emoticons/Icon settings seperate
+- Prevent dialogs that can open automatically (error messages) from
+ stealing focus
+- Added chat buffer size setting
+- Added setting to enable/disable mod/unmod messages
+- Added some shortcuts
+- Added command to show working directory
+- Added color preset
+- Improved help
+- Improved viewer history (fixed times per channel)
+- Improved debug output
+- Added command/guide in case getting login data doesn't work
+
+Bugfixes:
+- Fixed error in Viewer history
+
With Version 0.5, Chatty can notify you about streams you follow and
+ show a list of them. You have to request
+ new login data containing <Read user info> access to
+ be able to use that. Go to
+ <Main - Connect - Configure login..>, remove the
+ login and request it again.
+
You can enable/disable this feature under
+ <Main - Settings - Notifications> if you have the
+ necessary access.
+
+
Full Changelog
+
+New features:
+- Get notified when streams you follow go online (requires
+ <Read user info> access, which wasn't even in Chatty before, so you'll
+ have to request new login data)
+- View a list of live streams (you followed or whose channel you are in)
+- FrankerFaceZ emoticons
+- Added search, allowing you to find text in the current chat window
+- Deleted messages (from timeouts/bans) now get shortened to a maximum length,
+ or you can use the previous behaviour or let the whole message be replaced
+ with <message deleted>
+- Change the displayed time range in Viewer History
+- Automatically check if the login is valid, if it is suspected not to be
+- Clickable links in Channel Info Dialog (also turns #srl-abcd into a race link)
+- Cycle between tabs with Ctrl+TAB
+
+Changes:
+- Updated Help
+- Changed Settings Dialog Layout
+- Detect subscribers even when in more than one channel (may not work correctly
+ always, but it's a better guess than before)
+
+Bugfixes:
+- Changed color of inputbox cursor to foreground color
+- Possibly made emoticon image loading a bit more reliable, but it's hard to
+ tell what happens when the loading fails
+- Handle long URLs in the URL open dialog better
+
+New features:
+- Added version checker to inform you about new versions of Chatty
+- Added window icon
+- Added colors to viewer history to indicate stream status changes, hovering
+ displays stream title/game at that time (in addition to viewercount/time)
+- Stream information is now requested for all channels you have currently joined
+- Added tray notifications for highlighted messages and stream status changes
+- Added sound notifications for highlighted messages and stream status changes
+- Added some commandline parameters, settings and context menu entries
+
+Changes:
+- Nicks in JOIN/PART/MOD/UNMOD lines now clickable
+- Settings now saved in seperate files for general settings, login data and
+ history/favorites
+- Fixed tab colors, added indicator for new stream status
+- Added delay for global hotkey so it doesn't repeat as much if kept pressed
+- Updated and improved help
+- Added Mod/Unmod buttons to user dialog (only in your own channel)
+
+Bugfixes:
+- Fixed bug where a status change could reopen a tab that couldn't be closed
+- Improved error handling for API responses
+- Fixed bug where focus sometimes wouldn't be on inputbox when changing tabs or
+ clicking in channel
+
+New features:
+- Added Admin Dialog that let's you change the title/game of your stream
+ and run commercials (optional global hotkey for running commercials)
+- Added Channel Favorites/History that automatically saves channels you joined
+ and also allows you to add favorites (history can be deactivated in the
+ settings)
+- Added Highlight system that makes a message appear in another color if defined
+ keywords are found in it and/or it was send by a defined user (defaults to
+ always highlight your own name)
+- Added join dialog
+- Messages from user "twitchnotify" as info messages (when someone subscribed)
+- Added Warning when joining more than one channel
+- Added context menus for nicks/links/channel/tabs
+- Restore window position from last session
+- Better debugging and error handling
+- Automatically scroll down after 30s of inactivity when being scrolled up
+
+Changes:
+- User Info Dialog: Auto-update message history, show bans, show channel context
+- Lowered stream info (title, game, viewercount) update delay to 120s
+- Improved default user colors
+- Emoticons that contain only word characters match at word boundaries (to match
+ the new behaviour in Twitch Webchat)
+
+New settings:
+- Option for capitalized names
+- Option to show ban message (.. has been banned from talking), defaults to not
+ showing it
+- Color GUI settings (with default and dark preset)
+- And of course quite a few for the new features/bugfixes
+
+Bugfixes:
+- Fixed bug where channels would re-open without being
+ able to close them
+- Fixed bug where the userlist wasn't loaded correctly on join
+ when the channel was joined before in the same session
+- Disabled Direct3D Hardware Acceleration by default to possibly
+ fix Chatty appearing completely black under certain circumstances
+
+
+
First published version was 0.2 so changelog starts from version 0.3.
There are a couple of commands that allow you to change settings from
+ the chat inputbox. (You should probably roughly know what you're doing
+ before using these.)
The following are settings that can be changed using the setting commands.
+ A lot of those - but not all - can also be changed in the Settings Dialog,
+ which is more convient in some cases. This does not show all settings.
Settings with a slightly darker background color
+ are settings that are not available in the Settings Dialog and can only be
+ changed via commands (and sometimes also commandline options).
The font for the chat input box (should only be set to
+ Java logical fonts like Dialog or
+ Monospaced, otherwise fallback fonts in
+ chat may not work correctly*)
+
+
+
dialogFontSize
+
Integer
+
Font size or -1 to keep default
+
-1
+
Setting to customize the font size of dialogs, currently
+ experimentel and only for User Info Dialog.
+
+
+
+
* If a character isn't contained in the chat font you have
+ currently configured, Java will try to find it in the fallback
+ fonts. While still not all characters will be displayed this way, it
+ should work a lot better. You can also add your own fallback fonts
+ to improve the situation further. However, setting the input box
+ font to your chat font somehow breaks the fallback font mechanism,
+ resulting in less characters being able to be displayed (like in
+ versions before 0.7.3).
Default server to connect to, which can be changed in
+ the Settings Dialog and is saved between sessions
+
+
+
portDefault
+
String
+
One or more ports, seperated by comma
+
6667,80
+
Default port to connect to, which can be changed in the
+ Settings Dialog and is saved between sessions
+
+
+
server
+
String
+
The server address, host or IP
+
empty
+
If set, overrides the defaultServer, can be
+ set by commandline options, not saved in between sessions
+
+
+
port
+
String
+
One or more ports, seperated by comma
+
empty
+
If set, overrides the defaultPort, can be
+ set by commandline options, not saved in between sessions
+
+
+
username
+
String
+
Your username
+
empty
+
Public part of the Login data
+ to login into chat
+
+
+
token
+
String
+
OAuth token
+
empty
+
Secret part of the Login data
+ to authorize with Twitch, don't show this to anyone. You
+ shouldn't change this directly, but use the /changetoken
+ command instead when manually setting the token.
+
+
+
spamProtection
+
String
+
messages/seconds, e.g. 10/20
+
18/30
+
How many messages Chatty allows you to send to the server
+ in the given time, to prevent a ban from chat
+
+
+
membershipEnabled
+
Boolean
+
true
+
Refers to the twitch.tv/membership IRCv3 CAP, which
+ enables sending a userlist and joins/parts, allowing for a
+ correct userlist in Chatty and showing of joins/parts in chat
+ (if separately enabled of course)
Forwards messages from the given channels to
+ Stream Chat.
+
+
+
streamChatMessageTimeout
+
Integer
+
Number of seconds, negative to disable
+
-1
+
How long messages are displayed before they disappear
+ from Stream Chat.
+
+
+
streamChatBottom
+
Boolean
+
true
+
Start inserting messages at the bottom. Messages are
+ always inserted below previous messages, but disabling this setting
+ will make them start at the top. Requires a
+ restart of Chatty after changing to take any effect.
+
+
+
streamChatResizable
+
Boolean
+
true
+
Whether the Stream Chat dialog is resizable by dragging
+ the edges.
Allows moderators in the given channel to run the
+ !addStreamHighlight command.
+
+
+
streamHighlightChannelRespond
+
Boolean
+
false
+
If this is enabled, Chatty sends a message to chat when
+ a moderator uses the !addStreamHighlight command. Otherwise
+ the response to the command is only shown locally.
+
+
+
streamHighlightCommand
+
String
+
The command to use for moderators
+
!addstreamhighlight
+
Change this to define the command that can be used by
+ mods to add stream highlights in the channel defined with
+ the streamHighlightChannel setting.
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.
Change font and font size by clicking on Select font.
+
+
Startup
+
You can select what will happen when you start Chatty:
+
+
Do nothing - Just do nothing special
+
Open connect dialog - Open dialog to connect
+
Connect and join specified channels - Connect
+ immediately and join the channels specified in the field below. You can
+ define several channels by seperating them with a comma.
+
Connect and join previously open channels - Connect
+ immediately and join the channels you had open when you closed Chatty.
+
Connect and join favorited channels - Connect
+ immediately and join the channels that are favorited in the Channel
+ Favorites/History dialog.
This allows you to define how timeouts or bans are displayed in Chatty.
+
+
There are three options for deleted messages:
+
Delete Message completely replaces the message with
+ <message deleted>.
+
Strike through will keep the whole message displayed, but
+ crossed out.
+
Strike through, shorten is same as the previous one, but
+ it will also shorten the message to the defined number of characters, so long
+ spam messages don't take as much space, but can mostly still be identified what
+ they were about. Shortened messages are indicated by the points at the end
+ that are not crossed out (e.g. Deleted spam message Long copy pas..).
+
+
Show ban messages: In addition to handling the deleted
+ message, Chatty can also show a message like
+ <name> has been banned from talking once the timeout
+ or ban is issued.
+
Combine ban messages: Chatty can combine ban messages,
+ which means if several bans/timeouts are issued for the same user within 10
+ seconds, only one message is shown for them, with the number of bans shown
+ after the message, e.g. <name> has been banned from talking (3).
+ Ban messages are not combined if a new message from the banned user was
+ received in the meantime.
+
+
+
+
Other
+
+
Timestamp: Whether to show a timestamp in front of
+ chat messages and what format it should have. If you want a different
+ format from the ones provided here, you can use the command
+ /set timestamp <format>. The format can be anything
+ specified by the Java
+ SimpleDateFormat
+ class.
+
Show mod/unmod messages: Whether to show the MOD/UNMOD
+ messages as they come in from Twitch Chat (which are used to show the
+ moderator badge). These messages can be sometimes
+ be kind of broken (on Twitch's side) and can show some or all mods in the channel
+ as being modded/unmodded.
+
Show joins/parts (TC1 only): Show joins/parts, which
+ only works on TC1 (more information). Joins/parts
+ are always kind of delayed, so don't take them too seriously.
+
Show stream status in chat outputs the stream status
+ (title and game) in the chat window on join and when it changes
+ (when the stream goes offline or online or changes the title or game).
+
/me messages colored: Show action messages colored
+ like in webchat.
+
Filter combining characters: Replaces certain ranges of
+ Unicode characters. Those characters are used in some
+ languages to combine characters, but can apparently cause errors in some
+ cases. The filter applies to the main chat window and the recent messages
+ in the User Info Dialog (but not e.g. the chatlog written to file).
+
+
Off - Do nothing
+
Lenient - Replaces at least 3 characters in a row with stars (****), which preserves some legitimate use
+
Strict - Replaces any number of characters in a row with stars (****), use this if you have performance
+ problems when someone posts these kind of characters
Names in Twitch Chat are send all-lowercase by default, however there is
+ an IRCv3 tag send with each message with the display name which Chatty
+ can use to show correct capitalization. You have the following settings:
+
+
Capitalized Names (First Letter) simply makes the
+ first letter of names uppercase. This will be correct for many names,
+ but by far not for all (names might have capital letters in the middle
+ or be all-lowercase). You can enable this if you simply prefer it this
+ way.
+
Correctly Capitalized Names uses the capitalization
+ send in the IRCv3 tag with each message and should be what the user
+ configured. In very rare cases the display nick may differ more than the
+ capitalization. This is enabled by default.
+
+
+
The previous function that requested correctly capitalized names from the
+ Twitch API has been removed. This also means that the associated commands
+ (/refreshCase, /setCase and /getCase)
+ have been removed as well. If you want to customize the capitalization of someone else's
+ name locally, you can now use the Custom Names feature.
+ The names in the userlist will not be correctly capitalized until Chatty has
+ received a message from that user during this session.
Show emoticons: Shows emoticons as images instead
+ of just the text
+
Enable BetterTTV Emotes: Shows some of the BetterTTV emotes.
+ Requires a restart to take effect when you change it.
+
Enable FrankerFaceZ (FFZ): Downloads FrankerFaceZ
+ emotes and Mod Icons (where available). Requires a restart to take
+ effect when you change it.
+
Enable FFZ Mod Icon: Show the FFZ Mod Icon instead of the regular
+ Mod Icon (where available). Requires FrankerFaceZ setting to be enabled.
+
Scale: 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).
+
+
+
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.
Show Usericons: Shows badges as images instead of
+ just text
+
Enable Custom Usericons: Use the custom icons
+ defined in the table below
+
Enable Bot Badge: Enables showing of the bot badge
+ for known bots. Chatty shows a single bot badge for all known bots. The
+ list of bot names comes from different sources: The botNames
+ setting, the BTTV API and the FFZ API.
+
+
BTTV: Use botnames from the BTTV API
+
FFZ: Use botnames from the FFZ API
+
+
+
+
+
Custom Usericons
+
By adding entries to the table you can either replace the default icons (Mod, Turbo, Subscriber, ..)
+ or add additional icons for certain users or addressbook categories. The order
+ of the entries can matter, they are matched from the top, so if more than one
+ icon matches that is supposed to replace a default icon, then the first one
+ is used. If more than one Addon icon matches, then all are used
+ (unless you use the $stop restriction, see section Restriction below).
+
+
You have the following options when you add/edit an item:
+
+
Type
+
The type determines whether a default icon will be replaced
+ (if you choose Moderator, Subscriber, Turbo, ..) or if
+ it should be an additional icon added after the default ones (Addon).
+ Currently, you can have as many Addon-Icons as you want and they are
+ all displayed at once (if they match the requirements of course).
+
+
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 for Addon
+ icons:
+
+
$stop means if this icon matches (and is thus used),
+ it stops searching for further Addon icons. 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 Addon icons.
+
$first puts this Addon icon before
+ the regular icons. The $stop restriction only
+ applies to one group of Addon icons separately
+ (before or after the regular icons).
+
+
+
Examples: $cat:streamer $first, lotsofs
+
+
Channel
+
This is another requirement that also has to be met in order for the
+ icon to be displayed. You can entere 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 file to use for the icon. Must be a .png and
+ should usually be about 18x18 pixels (because that is the size of the
+ default icons). The image files are looked for in the /img
+ subfolder of the working directory (similiar to the /sounds
+ folder). You can click on Image Folder to show information
+ about it and rescan it to update the list of images in the dropdown menu.
+
You can add the special Image File name $ffz which will
+ make it use a FrankerFaceZ icon for that, if available (this only really
+ applies if you use the TypeModerator and want to
+ replace the moderator icon in all channels execept the ones that have a
+ FFZ Mod Icon).
+
You should also be able to specify the full path to an image, if you
+ don't want to use the dedicated image folder. A filename starting with
+ http is interpreted as URL.
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):
+
+
$mod - Moderators
+
$sub - Subscribers
+
$turbo - Turbo Users
+
$admin - Admins
+
$staff - Staff members
+
$all - All users, this can be used to specify a default
+ color (should be put at the very end of the list)
#<color code> - A Html color code, e.g. #0000FF for 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:Blue for 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 $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.
Enable Highlight: Determines whether highlighting
+ is enabled at all.
+
Highlight own name: Makes messages that contain your
+ own name (case-insensitive) highlighted, even if you didn't add it to the list manually.
+
Highlight follow-up: After a highlighted message,
+ also highlight the following messages of the same user for a certain time.
+
Check own text for highlights: Highlights your own messages if
+ they match the criteria, which can be particularly useful to test whether your terms
+ are being matched correctly. This does not mean that all your own messages
+ are automatically highlighted, they still have to match one of the items
+ added to the list. To match all your own messages you can use the user:
+ prefix with your own name.
+
Check ignored messages: Only checks ignored messages
+ for highlights if this is enabled.
+
+
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.
+
+
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.
+
+
cs: makes it case-sensitive, so cs:test
+ matches test but not Test.
+
w: matches at word boundaries, e.g. w:anna
+ will match anna or Anna: but not
+ Hannah or annah. (Is actually just a
+ shortcut for a special regex, so special regex characters will work.)
+
wcs: is the same as w:, but case-sensitive.
+
start: to match at the start, so start:!bet will
+ match messages starting with !bet.
+
re: to use a regular expression, e.g. re:(?i).*\bGTA ?[V5]\b.*
+ to match GTA5, GTA 5, GTA V, gta5, .. (as a word) anywhere in the message. Note
+ that the regex always tries to match the entire message, so you have to
+ add the appropriate wildcards to match parts anywhere in the message.
+
+
+
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.
+
+
user: to specifiy one exact username (case-insensitive)
+ which should highlight only if this user send the message, doesn't
+ search in the message itself.
+
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-seperated
+ 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):
+
+
m Moderator
+
s Subscriber
+
a Admin
+
f Staff
+
b Broadcaster
+
t Turbo User
+
g Global Moderator
+
r Bot as in Robot (depending on what the FFZ/BTTV APIs provides (if
+ enabled) and values in the botNames setting)
+
M User with any kind of moderator/special powers
+ (so Broadcaster/Moderator/Global Moderator/Admin/Staff combined)
+
+ For example: status:st matches
+ 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:stM matches all 'normal' users that have no
+ badge by default (NOT a Subscriber, Turbo User or any kind of Moderator).
+
color: to specify a color other than the default one
+ for displaying this highlight. If you have items with a custom
+ color defined, which match something that might also be matched
+ by other items (with another color or custom color)
+ then the order of items is important so it displays the desired color.
+ Items on the top are matched first, so move items up that should take
+ precedence. For example test and
+ color:blue test2. If test is on the top
+ it will never get to the blue one, because test will
+ always match when test2 would match as well.
+
config: to specify one or more options (seperated
+ by comma) that changes the behaviour):
+
+
silent - Disable sounds for this item
+
!notify - Disable notifications for this item
+
info - This item applies to info messages instead
+ of regular user messages (works only for Ignoring messages at the
+ moment)
+
+
+
+
Examples
+
+
word1 word2
+
Matches e.g. word1 word2, Word1 word2 anywhere in the message
+
Does NOT match only word1 or only word2 anywhere in the message
+
(Each item represents one word or phrase to match as a whole)
+
+
w:anna
+
Matches e.g. Anna?, Anna :D, Anna,
+
Does NOT match Wanna?, Hannah, annah
+
(Match on word boundaries to prevent undesired matches)
+
+
user:joshimuz cs:Hello
+
Matches Hello anywhere in the message, if the message was sent
+ by the user named joshimuz
+
Does NOT match hello
+
(Combine a Meta Prefix (user-specific highlighting) and a Text Matching Prefix (case-sensitive))
+
+
cs:Hello user:joshimuz
+
Matches Hello user:joshimuz anywhere in the message
+
Does NOT match Hello, does NOT matter who send the message
+
(Anything after a Text Matching Prefix is interpreted as text to match, Meta Prefixes must be placed
+ in front of the text)
+
+
cs:abc re:\w+
+
Matches abc re:\w+ anywhere in the message
+
Does NOT match abc test, but also NOT Abc re:\w+
+
(Can't combine Text Matching Prefixes)
+
+
re:abc \w+
+
Matches e.g. abc test
+
Does NOT match aabc test
+
(All Text Matching prefixes can also be replaced by regex)
+
+
re:.*abc \w+.*
+
Matches e.g. abc test anywhere in the message
+
(Regex has to match the whole message, so you need to add wildcards to match anywhere in the message)
+
+
color:yellow wcs:S
+
Matches e.g. S:, Hello S! and makes the message
+ display in yellow color
+
Does NOT match s:, Hello s!, SSSS, ssss
+
(Define a custom color for this item and match case-sensitive on word boundaries)
+
+
chan:lotsofs,joshimuz cs:Hello
+
Highlight messages that contain Hello, but only if in
+ the channel #lotsofs or #joshimuz
+
(Restrict matching to one or more channels)
+
+
status:s chanCat:vip start:!test
+
Match any message starting with !test send by
+ subscribers of the channel, but only if the channel is in the
+ Addressbook category vip (e.g.
+ /ab add #joshimuz vip, notice the leading #)
+
(Restrict matching by user status, channel category and start of message)
Ignores chat messages, either because they match the specified text or -
+ using prefix - other properties like which user wrote the message. 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:
+
+
user:name
+
Ignores the user with the name name in all channels
+
+
user:name chan:tirean,gocnak
+
Ignores the user with the name name in channels #tirean and #gocnak
+
+
config:info subscribed to
+
Ignores the x has subscribed to y info messages that
+ you get when someone subscribes in the channel that is being hosted
+
+
cat:ignore !chan:lotsofs,joshimuz
+
Ignores users in the addressbook category ignore in all channels,
+ except #lotsofs and #joshimuz
+
+
chan:joshimuz re:!bet.*
+
Ignores messages starting with !bet, but only in #joshimuz
+
+
!status:smb chanCat:subonly
+
Ignores any message send by users that are not a subscriber, moderator
+ or broadcaster of the channel, but only if the channel is in the Addressbook
+ category subonly (e.g. /ab add #joshimuz subonly,
+ notice the leading #)
+
+
+
General Options
+
+
Enable Ignore: Enable/disable the Ignore System
+ altogether
+
Ignore own messages: Also ignore own messages (if
+ they match), can be useful for testing
+
What should happen with ignored messages:
+
+
Hide: Don't show ignored messages in chat
+ at all (they still get added to the Ignored dialog)
+
Show count: Shows the number of ignored messages
+ in chat every 30s (if there were any), so you know that messages
+ were ignored
+
Show names: Shows the name of the sender of
+ any ignored messages, in a list similiar to MOD/UNMOD or JOIN/PART
+ messages
+
+
+
Only show if ignored messages dialog is not open:
+ Only show what is configured for "What should happen with ignored messages"
+ when the ignored messages dialog isn't currently open.
You can enable or disable all sounds here. Sounds are searched in the
+ displayed folder, which is the current working directory. Any valid sound
+ files in the folder should be selectable as a sound to be played. If you
+ added or removed files, you may have to use Rescan folder to
+ make the files show up in the list. You can open the folder in your standard
+ file browser from here to add files to it more quickly.
+
+
Sound Types Settings
+
You can specify requirements, soundfile, volume and delay for
+ different types of events:
+
+
When a message is highlighted
+
When a stream changes status (online/offline/changed title/changed game)
+
When any message in received in any open channel
+
When someone joins/leaves any open channel
+
When a new follower is detected (this only works if the Follower
+ Dialog is currently open)
+
+
You can set a delay (seconds) so that the same sound won't be played twice during
+ the set number of seconds. So if e.g. 3 highlighted messages come in within
+ 10 seconds and the delay is set to 15 seconds, only one sound will be played.
+
+
Each sound has different options for when the sound should be played. See
+ the Notification Settings for help on the options.
You can show notifications for two kinds of things:
+
+
Highlights - When a message in chat is highlighted
+
Stream Status - When a stream changes status, e.g.
+ offline -> online or changed title
+
+
+
For both these you can select separately if and when they are shown:
+
+
Off - Never show
+
When channel/app not active - Only when the channel
+ isn't the currently selected tab AND when the program doesn't have focus
+
When channel or app not active - Only when the channel
+ isn't the currently selected tab OR when the program doesn't have focus
+
When app not active - Only when the program doesn't
+ have focus
+
When channel not active - Only when the channel
+ isn't the currently selected tab
+
When channel active - Only when the channel IS the
+ currently selected tab
+
Always - No requirements, always show it
+
+
+
In addition, the option Don't notify about "Stream offline" allows you
+ to never show when a stream changes status to offline, so you will only be
+ notified about streams going live or changing title/game.
+
+
Notification Type / Options
+
Select here whether to use the Chatty Notifications or the default
+ System Tray Notifications. This settings DOES NOT enable or
+ disable notifications altogether, just switch between the types.
+
If you have Chatty Notifications selected, you can change some
+ more options:
+
+
Position: In which corner the the notification appears on the screen
+
Screen: On which screen the notification appears (auto means
+ it's on the same screen as the Chatty window)
+
Display Time: How long the notification will be displayed
+ by default. This can vary a bit depending on the situation.
+
No User Activity: This is a tricky one. If you enable
+ this, then the notification will not be closed after the defined Display Time
+ if no activity was detected in the last few seconds. This can be useful
+ to still see notifications from a few minutes ago if you were away from
+ the computer.
+ The time defines
+ when the notification will be closed no
+ matter what, so older notifications won't stay there forever if you are
+ away from the computer for a bit longer.
+
Activity is tracked through two methods:
+ The first method is tracking the system-wide mouse movements, which is
+ done through an API that may not always return accurate information
+ (e.g. if you are in a game) and it only checks the position every few
+ seconds (only the last location is saved at any time for comparison).
+ The second method detects activity only inside of Chatty, by tracking
+ button presses and mouse actions (e.g. if you type a message, open a
+ dialog etc.).
+
+
+
Followed Streams
+
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.
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:
+
+
always - Log all channels without exception (default)
+
blacklist - Log all channels, except the ones on
+ the blacklist
+
whitelist - Log no channels, except the ones on the
+ whitelist
+
off - Log no channels whatsoever
+
+
+
Messages Types
+
Normal chat messages are always logged, however you can log additional
+ information:
+
+
Chat Info refers to general chat releated info messages
+ like connecting/disconnecting/trying to timeout someone/stream title..
+
Bans/Timeouts refers to bans/timeouts in chat, which
+ will be logged like this: [12:32:25] BAN: name, name2
+
Mod/Unmod refers to when someone in chat is modded/
+ unmodded, which will be logged like this: [12:32:25] MOD: name1, name2
+
Joins/Parts refers to when someone joins/parts the
+ channel, which will be logged like this: [12:32:25] JOIN: name1, name2
+
System Info means any info messages that are related
+ more to Chatty than chat itself, like info about new versions, if you use
+ settings commands..
+
Viewerstats are stats about the viewercount which
+ are logged in a semi-regular interval to give some idea about the viewercount
+ during that time. It 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, e.g.
+ [21:06:21] Viewerstats (21:03-21:06): avg:28.612 min:28.432 max:28.887 [3/28.519-87+455_]).
+
Viewercount will log the viewercount as it is updated,
+ like this: [15:23:58] VIEWERS: 12521
Open dialogs in default location: Always
+ open dialogs in their default location (centered on the main
+ window) when you open them.
+
Keep location during session: Puts dialogs
+ at the same position when you reopen them during the same
+ session (so they are put on the default location when you open
+ them the first time after starting Chatty).
+
Restore dialogs from last session: Puts
+ dialogs at the same position they were at when you closed Chatty
+ last session and also keeps the position during the session.
+
Reopen dialogs from last session: Reopens
+ any dialogs that were open when you closed Chatty last session
+ and also puts them at the same position they were before.
+
+
+
Attach dialogs position to main window: If enabled,
+ moves the dialogs like Channel Info or Admin Dialog along with the
+ main window, so they always keep the same relative position. You can
+ still move the dialogs by themselves of course.
+
+
+
Other
+
+
Open URL Prompt: Enable this to be asked
+ when opening a URL. Even if this is disabled, you may still asked on
+ some occasions, but not for URLs in chat.
+
Always show chat scrollbar: Always show the vertical
+ scrollbar in the chat window (there should never be a horizontal one),
+ even if no scrolling is necessary. This can be useful for using window
+ capture for streaming, because you can always keep the same subregion.
+
Minimize to tray: When minimizing the main Chatty
+ window, it will be minimized to tray.
+
Close to tray: Closing the main Chatty window will
+ not actually exit the program, but instead minimize it to tray. You can
+ actually close the program via Main - Exit or the tray icon
+ context menu.
+
Tab Order: Whether to show tabs in the order they
+ were opened or alphabetically.
+
Default Userlist Width: The default width of the
+ userlist in pixels.
+
+
+
+
Popout
+
+
Restore location/size: When you close a popout
+ window then it's location/size is saved and used for the next popout
+ window that is opened. Each saved location/size is only used once, if
+ there is none left then the default attributes are used. This is also
+ saved between sessions (attributes of popouts that are open when you
+ close Chatty are saved as well).
+
Close popout when only channel: When you have a
+ channel popout window open and close the last channel in the main window,
+ then the popout window will automatically be closed and the channel
+ moved to the main window. Disable this if the popout shouldn't be closed
+ automatically.
Custom commands allow you to specify aliases for anything you could also
+ enter directly into the inputbox (like chat messages or regular commands),
+ with the exception of other custom commands, which is a limitation
+ implemented to prevent infinite loops. Custom commands you add should be in
+ the following format:
+
+
/<commandName> <what the command should do>
+
+
Everything until the first space is the name of the comand, and everything
+ after the first space is the text of the command. For example:
+
+
/hello Hello World!
+
+
If you added that to the custom commands and enter /hello
+ in the inputbox, then it would send Hello World!, just as
+ if you would have written it yourself and pressed Enter.
+
+
Custom Command Parameters
+
You can also specify parameters in the command text, which will be replaced
+ when you execute the custom command. For example:
+
/permit !permit $$1
+
When you enter /permit name, then it will replace $$1
+ with the first word after the command, which in this case would be
+ name, making the actually send text !permit name.
+
+
This is the syntax for specifying parameters (word in this context means
+ anything seperated by a space):
+
+
$1, $2, $3
+
First word, second word, third word etc.
+
+
$1-
+
First word, and all the words after it
+
Equivalently $2-, $3- etc.
+
+
$$1
+
First word, but required, meaning the command result will only be
+ send if all the required commands are actually there
+
Equivalently $$2, $$3- is also possible
+
+
\$1-
+
Escape any special character (like $) by prepending a backslash
+ \, which means this won't be interpreted as a parameter
+ and not be replaced
+
If you actually want to use \, you can escape the
+ backslash itself, for example \\$1- will be replaced
+ (leaving one backslash in front of the replaced parameter)
In a context other than entering the command in the inputbox, there are
+ some predefined parameters. For example if you add a command as a context
+ menu entry (see next section), then clicking that entry will execute the
+ command while automatically adding an appropriate parameter.
+
+
So you can for example add just /Permit to the menu, but
+ the custom command /permit !permit $$1 will actually be
+ executed as !permit <name of the user>.
+
+
+
Context
+
Parameters
+
+
+
All
+
$chan - the currently active channel (without leading #)
+
+
+
User Context Menu
+
$1 - name of the user
+
+
+
User Dialog
+
$1 - name of the user
+
+
+
Channel Context menu
+
$1 - name of the currently active channel (without leading #)
You can add custom commands and regular commands to the User Context Menu (when you right-click
+ on a user in chat), the Channel Context Menu (when you right-click anywhere on the chat
+ that is not otherwise linked) and customize User Dialog Buttons (Custom Commands
+ and Timeout Buttons).
+
Commands can be added in the following format:
+
/<commandName1>, /<commandName2>
+
For example:
+
/Slap, /Permit
+
Which means the command with the name slap will be added
+ first, then permit after that. You can use spaces,
+ linebreaks and/or commas as seperators between commands.
+
+
This is the syntax for specifying commands in the Context Menus/User Dialog:
+
+
/Slap /Permit or Slap, Permit or Slap Permit
+
Commands can be specified with or without forward slash /, then the name
+ (without parameters) and space, linebreak or comma to seperate to the next command.
+
Custom Commands in the User Dialog require the / in front.
+
//Slap
+
Prepending two forward slashes // will put the command
+ in the special submenu More.. (for Context Menus) or
+ in a second line of buttons (for the User Dialog).
+
| Slap or |//Slap
+
Adding | (vertical bar) will add a seperator before the
+ menu item for the next command.
+ The | doesn't have to be directly in front of the command,
+ it simply applies to the following command.
+
Does not work for custom buttons in the User Dialog.
+
/Set_color is displayed as Set color
+
Underscores in command names are replaced with a space for display
+ in a Context Menu or on a button.
+
+
+
In addition, you can define for the User Dialog Buttons:
+
+
5, 2m, 10m, 24h
+
In addition to Custom Commands you can also specify Timeout Buttons
+ in the User Dialog. Times are added just like Custom Commands
+ (seperated by comma/space/linebreak). However they
+ can only be added to the first row of buttons. They are interpreted as
+ seconds by default, unless you add a suffix: s - seconds,
+ m - minutes, h - hours, d - days.
+
120s, 120 is displayed as 120s and 2m
+
Both definitions create a button with a 120 seconds timeout, however
+ if you use a suffix, then the definition is used as button label
+ directly, otherwise the label is automatically created based on the
+ time.
+
/Ban[B], /Unban[U], 2s[P]
+
You can add keyboard shortcuts to buttons, that can be used while the
+ dialog is open and focused. Add a single button in brackets (uppercase).
+ Everything that is understood by
+ getKeyStroke()
+ can be used. No spaces are allowed, however a plus (+) can
+ be used instead (which will be replaced with a space automatically).
+
/Slap[NUMPAD1|Np1], /Permit[NUMPAD2|]
+
Adding a vertical bar (|) after the shortcut will use
+ the text after it up to the closing bracket as label for the shortcut on the button (no
+ spaces are allowed). If you don't specify any text, then no label is
+ used for that shortcut.
+
nokeylabels
+
If that text appears anywhere in the definition, then no labels will
+ be displayed on the buttons for the shortcuts, unless they are
+ explicitly defined.
Scroll down after [..] 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 accidently scrolling up from hiding
+ new messages.
+
Chat buffer size: How many lines of text are kept
+ for each channel in chat to scroll back to.
+
Inform me about new versions: Checks for new
+ versions every few days and outputs a message about it.
+
+
Write Stream Status
+
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
+ (enter /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:
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
+
+
Example which will write two files (if joined to #joshimuz):
If the stream is online, it writes the title and viewercount to title.txt
+ and the game to game.txt.
+ If the stream is offline it writes "Stream offline" to title.txt and empties
+ game.txt.
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.
+
+
Connecting
+
+
Server: The default server to connect to
+
Port: The default port(s) to connect to (can be
+ a list of ports, e.g. 6667,80)
+
+
The values of these settings are used when connecting, unless the commandline
+ parameters -server and/or -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 /get server
+ and /get port.
The Twitch Client Version setting has been removed since Twitch Chat was
+ switched over to IRCv3 tags and commands. It optionally also contains joins/parts/userlist.
If this setting is enabled, the IRCv3 capability that enables joins/parts is send
+ on connect. This doesn't mean you have to show joins/parts in
+ chat, it just means joins/parts are received in the background to maintain the userlist.
You can add hotkeys for certain actions. In general, there
+ are the following types of hotkeys:
+
+
Regular hotkeys, which will only trigger if the main Chatty
+ window has focus (or a popout window).
+
Application-wide hotkeys, which will trigger anywhere in
+ Chatty.
+
Global hotkeys, which are supposed to trigger everywhere
+ on your computer (Windows only, Hotkey version required). However some hotkeys may
+ not work, so just try it out.
+
+
+
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:
+
+
Action: The action to perform when the
+ hotkey is pressed. If you select Custom Command,
+ you have to enter the command to perform in the field below
+ (just the name of the command, see Commands).
+
Hotkey: The key or key combination that
+ has to be pressed to perform the action, click into the field
+ and press the key or key combination you want to use.
+
+
If the hotkey shows as being already used you may
+ still add it, but having more than one action defined
+ for the same hotkey will not trigger all the actions
+ when the hotkey is pressed, but a random one,
+ so it doesn't really make a lot of sense.
+ Adding it anyway can be sensible if you're currently
+ changing several hotkeys and will change the other
+ hotkey afterwards, so each key combination is only used
+ once.
+
+
+
Type:
Regular: Regular hotkey, which will only
+ trigger if the main window or a popout is focused.
+
Application: Application-wide hotkey,
+ which will trigger if any Chatty component is focused.
+
Global: Global hotkey, which will
+ trigger anywhere on your computer (only works with the hotkey
+ version of Chatty and if it loaded properly, Windows only).
+
+
Delay: The delay between performed actions,
+ in 1/10th of a second,
+ if this is 0 then there will be no delay required, otherwise
+ specifying a delay of e.g. 50 will 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.
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.
+
+
TAB Completion
+
+
Show popup:
+ If enabled, shows a small window with information about the
+ current completion if there is more than one matching result.
+ It shows at which result of how many you are when cycling
+ through results as well as a limited overview of which results
+ there actually are.
+
Max Items Shown: How many items
+ (e.g. names that match what you entered) to show
+ in the popup at once. You can set this to 0 to not show any
+ items.
+
Complete to common prefix:
+ Pressing TAB only completes up to the common prefix for
+ all found matches, giving you the opportunity to add
+ more characters and then press TAB again to refine the
+ results or just press TAB again to start cycling through
+ the results.
+
+ With this
+ setting disabled, it immediately completes the first found
+ result, allowing you to directly cycle through by pressing TAB repeatedly.
+
Sorting: Changes how the matching usernames
+ are sorted for completion (only applies to usernames,
+ not for other stuff like emotes or setting names which
+ are always alphabetical).
+
+
Predictive: Gives names of users that were recently
+ active in chat higher priority, with users who send
+ a message that was highlighted the highest. This way
+ people you talk to probably appear under the first
+ few results.
Custom Completion allows you to add terms and their completion,
+ allowing you to not only complete names in chat (TAB) or emotes
+ (Shift-TAB) but also custom stuff you added to the list by prepending the term with a
+ point and using Shift-TAB.
+
+
Example: Add chatty as Key and
+ http://chatty.github.io as Value
+ and then in the inputbox type .chatty (notice the dot in front) and press
+ Shift-TAB to complete it to the URL.
+
+
Custom Completion items can only have one completion, so you
+ can't have .chatty complete to several things
+ as it could be the case with a nickname.
+
+
Besides the Settings Dialog, you can also use the
+ /customCompletion command to modify custom
+ completion items:
+
+
+
/customCompletion add <item> <value> - Add an item
+
/customCompletion set <item> <value> - Change an item that already exists
+
/customCompletion remove <item> - Remove an item
+
+
+
Remember that you can also use TAB Completion for commands. Kappab
+
+
+
diff --git a/help/0.8.1b/help-short_guides.html b/help/0.8.1b/help-short_guides.html
new file mode 100644
index 0000000..57e752a
--- /dev/null
+++ b/help/0.8.1b/help-short_guides.html
@@ -0,0 +1,141 @@
+
+
+ Chatty Help - Short Guides
+
+
+
Go to Main - Settings - Ignore and make sure Enable Ignore
+ is ticked. Then add to the list (press the Plus-Button):
+
!status:smbaf chanCat:subonly
+
The !status:smbaf prefix matches on messages send by users that
+ don't have any of the status levels defined, in this case users
+ that are neither a subscriber (s), moderator (m), broadcaster (b),
+ admin (a) or staff (f). So basicially this only matches on normal users.
+
The second requirement for a match is the chanCat:subonly
+ prefix, which refers to the channel category subonly, which
+ means the channel the message was send in needs to have that Addressbook category.
+ This is used to be able to easily toggle subonly-mode for a channel, and
+ of course to prevent it being enabled in all channels you join in the
+ first place.
+
+
Create Custom Command to modify Addressbook
+
To make use of the Ignore Entry defined in the previous section, you need
+ to add the subonly category to the channel you want to have
+ it enabled for. To do this, you could open the Addressbook Dialog
+ (Channels - Addressbook) and add the channel with the
+ category there (channels need a leading # in this case, so e.g. #joshimuz).
This toggles the subonly category for the given channel, so
+ when the category is there, it removes the category, and when the category is not there,
+ it adds the category.
+
To do this a bit more conveniently, you can add it as a custom command. Go
+ to Main - Settings - Commands and add the following to the
+ list:
+
/Toggle_Subonly /ab change #$$1 !subonly
+
If you enter /Toggle_Subonly joshimuz, this will automatically
+ run the Addressbook as mentioned above ($$1 means this is
+ being replaced with the first word after the command).
+
+
To make this more convenient (entering the command with the correct channel
+ could be a bit of a hassle), add the Custom Command to the Channel Context Menu
+ (on the same page in the settings). Just click on Edit and add
+ the command name (without any parameters):
+
/Toggle_Subonly
+
Now if you right-click on a channel, the context menu that opens should
+ have an entry Toggle Subonly, which you can
+ use to turn your own local subonly mode for the current channel on and off.
Open the <View - Channel Info> to see your current
+ stream title/game, a graph of your viewercount and how long your current
+ stream already is going.
+
Open the <Extra - Followers/Subscribers> dialog
+ to view your 100 most recent Followers/Subscribers and some stats based
+ on that.
+
+
+
Manage your stream
+
+
Open the <View - Channel Admin> dialog to change
+ the title/game of your stream and run commercials:
+
+
Presets/History for title/game combinations
+
Favorite games you play often
+
Run commercials on a delay and/or timer
+
Run commercials while playing a game via a global hotkey
+ (Windows only)
+
+
+
+
+
Capture chat for on-stream chat
+
+
Customize chat colors, for example change to black background to be
+ able to make the background transparent in your streaming program.
+
If you capture Chatty with your streaming program, make sure to
+ enable the setting Settings - Window - Always show chat scrollbar, so you can always capture the same
+ region, independant of how many messages are in the chat window.
+
Change the font so it shows up nicely on stream.
+
If you want to have all text in bold - not just the names - you can
+ set the font by command like this: /set font Arial Bold.
+
You can clear the chat window by using the /clearchat
+ command (e.g. if you changed some settings before starting the stream
+ you don't want to show).
Sometimes there are channels that run on a special set of event chat
+ servers, so they are seperated from the channels you see when you join
+ irc.twitch.tv. This only applies to webchat (at the moment
+ at least), so often the chat you get connecting to irc.twitch.tv
+ is called "mobile chat", because the mobile apps apparently also don't
+ support event chat.
What you have to do in Chatty to be able to get the
+ event chat instead of the "normal chat" that is only used by IRC and
+ mobile users, is connect to a different server. Since Chatty can only
+ connect to one server at a time, you either have to only join channels
+ that are on the event chat servers, or run two seperate instances of
+ Chatty at the same time.
+
+
There are different ways of connecting to a different server:
+
+
The /server <host>[:port] command connects to the given server and
+ port manually.
+
The -server and -port commandline options
+ allow you to specify a different server when you start Chatty.
+
The Server and Port settings in the
+ Settings Dialog under Advanced allows you to set
+ fixed settings for the server to connect to. This especially makes sense
+ if you are using seperate settings for different instances of Chatty.
SpeedRunsLive is a platform
+ dedicated to speedrunning and racing (live speedruns against other players).
+ Chatty has an integrated race viewer, which lists all the current races.
Open the race list via SRL - Race List, which shows the
+ current races. Right-click on a race to open a contextmenu with several
+ options, double-click on a race to open the Race Info dialog.
+
+
Notice that the race list isn't automatically updated, unless you have
+ a Race Info dialog open (which is automatically updated in a regular
+ interval). If you want actual real-time information on races, joining
+ the SRL IRC is a good option. The integration in Chatty is mainly supposed
+ to make opening/joining race related stuff easier and to give a quick and
+ easy overview of who is in a race you are watching (without having to open
+ a website).
Use SRL - Races with.. to find races that the stream of
+ the currently active channel you have joined is part of. This will basicially
+ take the stream you have clicked on, search through all the current races
+ and list all the races that have an entrant that has that stream set. If
+ there is only one matching race, and you currently don't have the Race Info
+ dialog open, then it is immediately opened. Otherwise the matching races are
+ listed for you to select.
Sometimes users aren't correctly sorted in the userlist
+
Windows: Dragging the upper edge to maximize the window vertically
+ doesn't resize the contents of the window. This may be a Java Bug
+ that I cannot fix. Workaround: Try double-clicking the upper edge
+ instead of dragging it.
+
+
+
Errors / Crashes
+
+
Using the Calibri font can cause random errors, due to a bug in
+ Java.
+ (More information)
+
Java can crash due to a bug with the graphics driver.
+ (Forum Posts)
If you experience a laggy interface, this can have several reasons. For
+ one some chat channels are very busy and depending on your computer, this
+ may not be easy to handle. Managing the userlist can cost a lot of
+ performance in large channels because of having to react to hundreds of
+ users joining or leaving at once. It can help to temporarily
+ ignore joins/parts in this case.
+
+
You may also want to check if Irc logging is enabled in the Debug Window
+ (Extra - Debug window - Checkbox: Irc log), which should
+ be disabled by default, but can lower performance if checked.
First of all, you only need Global Hotkey support when you want to use
+ global hotkeys (which you can define in the settings). If you don't, you
+ can just ignore any related messages or download the version of Chatty
+ without Hotkey support. Global hotkeys currently only work on Windows.
+
+
If you want to use global hotkeys and you get a message related to them
+ not working, check the following sections. If you don't get a message,
+ but the global hotkeys you defined just don't work, make sure you
+ actually have global hotkeys enabled in the settings.
+
+
Wrong version of Chatty
+
If you try to add a global hotkey and it tells you that you have the
+ wrong version of Chatty, you probably don't have the version supporting
+ global hotkeys. Download the version that contains hotkey
+ in the .zip filename and try that instead.
+
+
Could not load library (jintellitype-1.3.8.jar)
+
Chatty requires the jintellitype-1.3.8.jar to be in the
+ lib subfolder of where the Chatty.jar is
+ located.
+
+
Could not load JIntellitype.dll
+
If you get this error, you started Chatty with Hotkey support, but it
+ couldn't load the library (.dll) necessary to register hotkeys. This can
+ mean that:
+
+
+
You have the wrong version for your version
+ of Java (32bit or 64bit Java need different versions of the .dll)
+
The JIntellitype.dll isn't stored where the program can
+ find it
+
+
+ Find out if you have the 64bit or 32bit version of Java (e.g. by
+ entering java -version on the commandline to check if there
+ is 64bit in the response), then check if you downloaded the matching
+ version of Chatty.
+
+
Enter /wdir in Chatty to find out what your working directory
+ is and make sure the JIntellitype.dll is in there. If you
+ are starting Chatty via a shortcut, remember that the directory
+ specified in the Run in field determines your working
+ directory (on Windows at least, but global hotkeys are currently Windows only
+ anyway).
If a user is timed out in one channel, Chatty may show the timeouts in
+ other channels as well. This is because there is no channel associated with
+ timeouts or bans in Twitch Chat, so the program has to guess in which
+ channel the timeout occured. See also: Joining more than one channel.
If you repeatedly get disconnected because of possibly invalid login
+ data, please open the Connect Dialog and choose Configure login.. - Verify login.
+ This will send a request to Twitch to check if the access token is valid.
+ If the login data is valid, then Twitch may just have temporary problems
+ and you should try again later. The same goes for when the check itself
+ fails because it can't reach the Twitch API.
+
If the login data isn't valid, you can just remove the login and request
+ new login data. Also see the section about login
+ for more information about invalid logins.
If Java encounters a character that is not contained in the chat font
+ you currently have configured, it will try to find it in the fallback
+ fonts. While still not all characters will be displayed this way, it
+ should work a lot better. If you want to be able to display even more
+ characters, you can add your own fallback fonts into the Java fallback
+ font directory: <JRE_INSTALL_DIR>/jre/lib/fonts/fallback
+
+
On Windows, the JRE would usually be located in
+ C:\Program Files\Java\ or
+ C:\Program Files (x86)\Java\.
+
+
Note: If you set the inputFont
+ setting to something else
+ besides a Java logical font, then the font fallback mechanism may break.
+ This was the case before version 0.7.3.
You need to have at least Java 7 JRE (Java Runtime Environment) installed to run Chatty.
+
If you try to start Chatty by double-clicking the Chatty.jar,
+ first make sure that .jar files are associated with Java,
+ and not some other program like WinRAR. The icon of the Chatty.jar
+ should have a Java icon (coffee cup). If you right-click the Chatty.jar
+ you can select the program to open it with under Open with.
+
+
If you are sure that the Chatty.jar is actually started with
+ Java, but no program window appears, it may be that an error occured before
+ the window (GUI) could be created.
+
+
Check Association of .jar with Java (Windows)
+
Open a commandline window and enter assoc .jar which should output
+ .jar=jarfile and enter ftype jarfile which should
+ output something like "C:\Program Files\Java\jre7\bin\javaw.exe" -jar "%1" %*
+ (see also
+ Could not find the main class. Program will exit.)
+
+
Run from commandline
+
Running Chatty from the commandline has the advantage of being able to
+ get messages from before the GUI is established. Open a commandline where
+ the Chatty.jar is located (Win7/8: Hold Shift while Right-Clicking to open
+ the context menu, click Open command window here) and enter
+ java -jar Chatty.jar.
+
+
Error: Java is not recognized as an internal or external command (Windows)
+
If you experience this when entering java -jar Chatty.jar
+ in the commandline, then it probably can't find Java because it's not in the
+ PATH environment variable (that defines where to look
+ for programs of which only the filename has been entered, not the whole path).
+
You can enter PATH in a commandline window to check what is
+ in it. It should show a list of semicolon-seperated directories, one of which
+ should point to Java.
+
+
Find errors in debug.log
+
See next section. Of course you'll have to navigate to the folder
+ manually.
If you experience any problems or errors, then there may be helpful
+ information for debugging in the debug log, which is located in the settings
+ directory <user_dir>/.chatty/ (e.g.
+ C:\Users\<username>\.chatty\, if you
+ have Chatty running you can enter /openDir to open it or
+ /dir to output the path).
+
In that folder, there are two kinds of debug files:
+
+
The debug.log which is overwritten everytime you start
+ Chatty. It may also have a number at the end (like debug.log.1)
+ if Java couldn't open the usual debug.log.
+
Several files (debug0.log, debug1.log, ..), whereas
+ one of them is written to at a time, and then switched to the next when
+ a certain filesize is reached, rotating between a certain number of files.
+ Those files are not overwritten when Chatty is started, but instead new data is appended.
+
+
So to find possibly relevant data:
+
+
If you haven't started Chatty again after the error occured, check
+ the debug.log first.
+
Otherwise check if one of the debug0.log, debug1.log, ..
+ files could contain the necessary information, based on the last
+ modification dates.
+
+
Even if the error is already some time back, it may still
+ be in there, depending on how much data has been added in the meantime.
+
+
+
+
+ If you found a bug or have a suggestion..
+ [back to menu]
+
When in a channel, Chatty shows some information about that channel
+ in the titlebar, e.g.: [40|59] - GTA:SA Speedruns (Grand Theft Auto: San Andreas)
+
The first number is the number of people in the chat, the second is the
+ viewercount, followed by the current stream title and game. Anything other
+ than the number of people in the chat is requested from the Twitch API about
+ every two minutes.
All command names are case-insensitive. Something like <parameter>
+ represents a required parameter which must be entered for the command to
+ work properly (you don't enter the surrounding < >,
+ they are just there to show it's a parameter). Equivalently [parameter]
+ represents an optional parameter.
+
Chat commands:
+
+
/me <message> - Send an action message (* nickname says something) to the channel
+
/to <nick> [time] - Timeout the user with the given nickname for "time" seconds (time is optional)
+
/timeout, /ban, /unban,
+ /slow, /slowoff,
+ /subscribers, /subscribersoff,
+ /clear, /mods, /host,
+ /unhost, /color
+ just like in normal Twitch Chat
+
/join <channel> - Joins the given channel
+
/part or /close - Leaves the current channel
+
/reconnect - Disconnects and reconnects
+
/fixMods - Temporarily fixes the list of mods (like
+ /mods but without showing the list of mods in chat)
+
+
Info commands:
+
+
/connection - Show info about the current connection
+
/uptime - Shows how long Chatty has been running
+
/appinfo - Shows Chatty uptime and current memory stats
+
/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
+
/openWdir - Opens the current working directory in your file browser
+
/testNotification [channel] - Display a test notification (optionally with channel,
+ which means right-clicking on the notification will join that channel)
+
/myemotes - Show your subscriber emote codes (only works if you
+ have joined any channel before, this is only a quick info, better emote
+ integration maybe to be implemented later)
+
/ffz, /ffzGlobal - Shows the FFZ channel emote codes for the current channel/global FFZ emotes
+
/releaseinfo - Opens the help with the release information
+
+
+
Other commands:
+
+
/clearchat - Clears the current chat window of all text
+
/setcolor <name> - Opens the usercolor settings
+ for the given name
+
/echo <text> - Outputs the given text as a info message
/settings, /livestreams, /channeladmin,
+ /channelinfo, /search, /openFollowers,
+ /openSubscribers - Opens the according dialog
+
/insert <text> - Inserts the given text into the input box at
+ the current caret position (can be useful for Custom Commands put
+ in a menu)
+
/insertword <text> - Same as /insert,
+ but adds spaces so it's seperated from text before and after (if present)
+
/openUrl <url> - Opens the given url
+
/openUrlPrompt <url> - Open the given url after
+ showing a prompt for confirmation
+
+
+
Advanced commands (not recommended for use unless you know what you do):
+
+
/server <host>[:port] - Connect to a custom server
+
/raw <command> - Send a raw command to the server
+
/refresh <emoticons/badges/ffz/ffzglobal/bttvemotes>
+ - Refresh the Twitch emoticons or badges (current channel) list or
+ refresh FrankerFaceZ channel emoticons (current channel) or global emoticons.
+ This downloads the lists from the Internet, so don't use this
+ unless you need to (it's basicially like pressing reload in your
+ browser, just only for some stuff).
+
/changetoken <token> - Checks if the given token
+ is valid and sets it as new token if it is
The login data consists of a username (or account name) and most importantly an access token, which is sort of a
+ revokable password that can also have different types of access associated with it, the ones usable for Chatty being:
+
+
+
Chat access
+
Required to connect to chat (required for Chatty).
+
+
Read user info
+
Required to request the streams you follow, so you can get notified
+ when they start streaming.
+
+
Editor access
+
Allows you to change the title/game of your stream and streams you
+ are an editor in via the Admin Dialog.
+
+
Run commercials
+
Allows you to run comercials on your stream
+ via the Admin Dialog (if you are partnered).
+
+
Show subscribers
+
Required to view the list of your subscribers
+ via the Subscribers Dialog (if you have a sub button).
+
+
+
Once requested from Twitch, the login data is stored locally on your computer
+ along with the other settings of Chatty. Since Twitch gives out the access token
+ per application, any access token for the same account requested with Chatty
+ will be invalidated when you request a new access token.
+
If getting login data fails, read this guide.
+ If your login was determined invalid, read down below.
To allow Chatty more access than it already has (e.g. if you haven't selected
+ editor access before, but you want it now),
+ you need to request a new access token.
+ Just go to <Main - Login..>, delete the login
+ and request it again with the necessary access.
+
+
Allow less access
+
To allow Chatty less access than it already has (e.g. you don't want it
+ to have editor access anymore) you need to first revoke access
+ completely in your Twitch Account
+ Settings, then
+ authorize access again. What will not work is just requesting a new
+ token without selecting the now unwanted access. Twitch will always
+ respond with a token that has at least as much access as the previous
+ one.
The access token is saved in the login file in the settings
+ directory and can thus be accessed
+ by anyone having access to your computer.
+ It allows anyone who obtains it to chat in your name and access the other
+ things listed above (if you allowed it when getting the token). If you think
+ the token may have been compromised, please immediately delete it and
+ request a new one (which will invalidate any previously issued)
+ or go to your Twitch Settings subsection
+ Connections
+ and revoke the accesss there.
If your login is determined invalid (either by checking it manually or
+ when Chatty performed an automatic check), this can mean one of two things:
+
+
Twitch returned false data and your login is actually still valid
+ (which rarely happens, but it is possible).
+
Your login is actually invalid:
+
+
You have requested new login data for the same Twitch Account from
+ another instance of Chatty, for example on another Computer, which
+ has automatically invalidated the previously requested login data
+ (access token).
+
You have just requested login data and something went wrong, or it
+ wasn't loaded properly from the settings.
+
The token was invalidated for some other reason.
+
+
+
+
+
What happens when your login is no longer valid:
+
+
You can't connect to chat anymore. If you are already connected and
+ stay connected, this doesn't matter.
+
Your followed streams are no longer requested, so you may not be
+ informed about streams starting anymore (if you had that enabled in the
+ first place).
+
Other features that require authentication won't work properly anymore, like
+ the Admin Dialog.
+
+
+
How to proceed:
+
+
If it is known or reasonable to assume that Twitch is currently derping,
+ then you can manually try to verify the login at a later time.
+
Go to <Main - Login..> to open the Login configuration
+ and click on [Verify login].
+
+
Request new login data.
+
Go to <Main - Login..> to open the Login configuration
+ (unless you are already there), [Remove login] and create
+ a new login.
There are a few special symbols that are used for users in chat. These
+ are displayed in the userlist and - if usericons are disabled - also in chat.
+
+
~ The Streamer
+
@ Moderators
+
* Global Moderators
+
! Admins
+
& Staff
+
+ Turbo users
+
% Subscribers
+
^ Bots as recognized by local setting, FFZ API and BTTV API
+
+
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.
When you type in the inputbox, you can TAB-complete different types of
+ things:
+
+
Nicknames of who is currently in the userlist (using TAB)
+
Chatty setting names when you use a setting command (using TAB)
+
Some comands after / (using TAB, e.g. /sub then TAB to complete to /subscribers)
+
Emoticon names (using Shift-TAB, e.g. Datsh then TAB to complete to DatSheffy)
+
Custom completion
+ that is prepended with a dot and for which items can be added in the
+ settings (using Shift-TAB)
+
+
+
How it works
+
There are a couple of settings
+ that change the behaviour of the TAB Completion.
+
+
+
Enter the beginning of an item (name, setting, emote).
+
Press TAB for a nickname/setting/command or Shift-TAB
+ to enter the completion mode, which will:
+
+
Complete to the full item (e.g. full name) if there is only
+ one item matching what you entered
+
For more than one match, depending on the Complete to common prefix setting:
+
+
Complete to the common prefix of all found items that match
+ what you entered, allowing you to enter more characters
+ to refine the search and then press TAB or
+ Shift-TAB again to enter a new completion
+
Complete to the full item of the first match
+
If enabled, it will also show a popup with information
+ about the completion, which doesn't show if there is only
+ one match
+
+
+
+
+
You can then either:
+
+
Press TAB repeatedly to cycle forwards through the found
+ matches or Shift-TAB to cycle backwards
+
Press ESC to cancel the completion mode and go
+ back to the text when you started the completion
+
Continue typing/editing the text to exit the completion
+ while keeping what you already completed
+
+
+
+
+
The found matches are all ordered alphabetically, except for nickcompletion
+ for which you can choose different types of sorting. By default nicknames use
+ predictive sorting, which means users who recently wrote a message or highlighted
+ you have a higher priority, increasing the chance that the users you want to
+ address appear as the first few matches.
+
+
Example: Nick Completion
+
+
Enter z in the editbox
+
Press TAB to complete as a nickname
+
+
On default settings, this may complete to ze_tt
+ with two other results
+
+
+
Cycle through to zMASKm by:
+
+
Pressing TAB, which cycles fowards to zMASKm
+
Or press Shift-TAB to cycle backwards to zeblover
+ and Shift-TAB again to cycle to zMASKm
+
+
+
+
+
Example: Emote Completion
+
+
Enter dat in the editbox
+
Press Shift-TAB to complete as an emote
+
+
On default settings, this may complete to DatHass with two other results
+
+
+
Cycle through to DatSheffy by:
+
+
Pressing TAB, which cycles fowards to DatSaunce
+ and TAB again to cycle to DatSheffy
+
Or press Shift-TAB to cycle backwards
+ to DatSheffy
Chatty provdes an input history for the chat input box that allows you to
+ call up lines you entered previously, to make it easier to e.g. repeat
+ commands with similiar parameters, repeat messages you send to chat or just
+ look up what you wrote before. You can even save messages to the history
+ that you haven't send yet to be able to send them later.
+
+
How lines are saved in the history:
+
+
Send a message or enter a command
+
Press Down-Arrow after entering/editing a message
+ (which saves it to the history, but also clears the input box)
+
Identical lines already in the history are removed (or you
+ can think of it being moved to the latest position)
+
+
+
Using the history:
+
+
You can navigate backwards and forwards through the history by
+ pressing Up-Arrow and Down-Arrow.
+
Pressing Up-Arrow when you already entered some
+ text replaces that with the latest history item.
+
Pressing Down-Arrow when you already entered some
+ text clears the input box and but also saves what you entered to
+ the history (as mentioned above).
+
When you navigated to a history item and edited it:
+
+
Pressing Up-Arrow will move to the previous
+ history item, allowing you to then press Down-Arrow
+ again to go back to the unedited history item
+
Pressing Down-Arrow will act as if you
+ entered a completely new line and add the edited item
+ to the history and clear the input box
If enabled, the history automatically saves channels you join and when
+ you last joined them. By default channels expire from the history after
+ 30 days of not joining them (can be changed).
+
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.
The highlight system allows you to add words or phrases that make chat
+ messages appear in another color and appear in a seperate window, which you can
+ open under View - Highlights (you can clear the highlights window
+ in it's context menu).
The ignore system works very similiar to the highlight system, just that
+ it hides messages instead of highlighting them. They however also get
+ added to a seperated window, which you can open under View - Ignored
+ (you can clear the messagess in the window in it's context menu).
The color of a user is displayed in the User Info Dialog. Color Names
+ are used where possible, HTML Color Codes are displayed in the Tooltip.
+ Colors with asterisk (*) are default colors (the user hasn't set one
+ or hasn't said anything during this session yet). A color in parentheses
+ means it's the original color, while the other color is the corrected one
+ that is actually displayed.
+
Corrected Colors
+
Chatty attempts to make colors more readable automatically by changing
+ them to increase contrast. This doesn't work very well though, although it
+ should work for extreme cases like white on white or black on black.
+
+
Custom Colors
+
You can also specify custom colors for certain users or types of users
+ in the settings. Custom colors are indicated by two asterisks (**) in the
+ User Info Dialog.
Chatty supports the default Twitch Emoticons (Normal/Turbo/Subscriber),
+ which should work the same as in normal Twitch Chat. It however also
+ supports FrankerFaceZ, a custom
+ set of emotes that is normally made available in normal Twitch Chat by use of browser
+ extensions. It also supports BetterTTV emotes.
+
+
You can enable/disable Emoticons in general (displaying the icons instead
+ of the text) in the settings under Emoticons. You can also
+ ignore specific emotes in the same place in the settings.
+
+
In chat you can right-click on an emoticon to show some info about it.
+ Click on the emote code (e.g. FrankerZ) in the context menu
+ to insert the emote in the inputbox. If it is a subscriber emote, you
+ also have some more options.
+
+
Emote Dialog
+
Use Extra - Emoticons or press Ctrl-E to open
+ the Emote Dialog, which has various pages:
+
+
The Favorites page lists emotes you have added to the favorites
+ via the Emote Context Menu (right-click on an emote in the dialog or chat and
+ choose Favorite, emotes that already are favorited can be
+ removed from favorites the same way).
+
The My Emotes page lists the emotes you paid for (Subemotes/Turbo).
+
The Channel page lists the emotes that are specific to the current channel
+ (FFZ and BTTV, if there are any). It also includes
+ the subscriber emotes of the current channel (if it has any), whether you
+ can use them or not (but it displays a message if you are not subscribed).
+
The Twitch page shows all free global Twitch emotes
+
The Other page shows all global FZZ/BTTV emotes
+
+
+
Click on an emote to insert it into the current channel inputbox. Double-click
+ on an emote to also close the Emote Dialog in the process, or press ESC or
+ Ctrl-E to close it. Right-click on an emote to show a context menu
+ with some more information/options.
+
+
Right-click on an emote and choose Show Details to open the
+ Detail View in the Emote Dialog, which shows the emote in different sizes
+ and some information about it. Clicking on an emote in chat also opens the
+ Detail View.
+
+
Note that you need to have joined at least one channel for your subemotes/turbo emotes
+ to show up, because only then does Twitch Chat send that information to the client.
You can add your own local emotes by creating a file called emotes.txt
+ in the settings directory (enter /dir in Chatty to find the
+ settings directory, /openDir to directly open it). The
+ file can have one emote on each line, for example:
This can be used to replace existing emotes, since custom emotes are
+ checked first and thus take precedence. This is not intended to replace
+ FFZ or BTTV emotes, just to help configure emotes to your personal
+ preference. For example you could also add an image for you own name to
+ have it highlighted in chat in a different way.
+
+
Syntax
+
+
The syntax per line is (you can use as many spaces or TABs as seperators as you want):
+
+
[settings] <code> [settings] <image> [settings]
+
+
Settings can be in any of the shown places, but are always optional. Available settings are:
+
+
+
+
set:<setid> to specify a
+ Twitch emote set. This will only affect messages you write yourself.
+
id:<emoteid> to specify a Twitch emote id to
+ replace. This will only affect incoming messages.
+
chan:<channel> to restrict the emote to the
+ given channel.
+
size:<width>x<height> to specify the
+ size of the emote (you can omit this if you want to use the image
+ size).
+
+
+
Required:
+
+
The code can be prefixed with re:
+ to specify a regular expression. Otherwise it is interpreted as plain text.
+
The image file is relative to the settings directory (where you created
+ the emotes.txt in), so just put them in the same directory.
+ You should also be able to use URLs to load the image from the internet.
+
+
+
Lines starting with # are ignored and can be used for comments.
+
+
The emotes.txt file is loaded when you start Chatty, so if you edit the file
+ while Chatty is running, you have to use the /reloadCustomEmotes
+ command for it to take effect.
+ Emote images may be cached, so if you change the image, you MAY have to
+ clear the cache (/clearemotecache CUSTOM).
With this feature, you can select a user in chat with keyboard shortcuts
+ (if the window is active). So you can e.g. timeout a user with your keyboard
+ alone.
+
+
Press Ctrl-Space (can be changed in the settings) to enter
+ this mode. If there are any user
+ messages in chat, then the newest message will get another background color
+ which shows that it is selected. In that mode, the focus is on the textpane,
+ which enables more shortcuts:
+
+
W to move up a user
+
S to move down a user
+
A to move up twice
+
D to move down twice
+
Q to quit out of the mode
+
E to open the User Dialog for the currently selected user
+
+
+
When you move up and down, it actually switches to the next user instead
+ of to the next line. So if the same user send 10 messages in a row, it will
+ jump to the first message of the next user above it.
+
+
In addition to the currently selected message, it will also highlight all
+ other messages by the same user. You can also hold Ctrl and
+ click on a username in chat to highlight all that users messages (and enter
+ User Selection Mode).
+
+
You can also click and hold in an empty area of the textpane, which puts
+ and holds the focus there, so you can just use the shortcuts in the list
+ above to enter the User Selection Mode and switch between messages. However
+ if you let go of the mouse key, it will immediately leave the mode again.
+
+
Using Global Hotkeys
+
You can also configure global hotkeys with some User Selection actions.
+ However, if the focus is not on the chat, then the usual shortcuts won't
+ work, so you'll have to define additional global hotkeys to e.g. timeout the
+ currently selected user. See the hotkey settings for what actions are
+ available.
Stream Chat is a seperate dialog, opened via the /openStreamChat
+ command or the Extra menu, that can have chat messages from one or several
+ channels redirected to it (only regular chat messages, so no JOINS/PARTS, info messages
+ and so on). It also can have a message timeout set, so messages will
+ disappear after a certain amount of seconds.
+
+
The idea is to capture Stream Chat to display chat on stream and
+ messages will only be displayed if the chat has been recently active. So
+ this doesn't really make a lot of sense for busier channels, unless you
+ simply prefer to only have regular messages or to have a seperate dialog
+ for the capture.
+
+
Getting started
+
You need to add the channel which messages are redirected to the
+ Stream Chat dialog before anything will appear. The setting you are required
+ to change is streamChatChannels,
+ which is a list setting giving you different ways of editing it:
+
+
/set streamChatChannels #<channel> - To set
+ the channel to only this one
+
/add streamChatChannels #<channel> - To add
+ a channel in addition to the ones already set
+
/remove streamChatChannels #<channel> - To remove
+ a channel from the list
+
+
Check out other settings that are also edited with setting commands.
+
In addition, make sure you have Settings - Window - Restore dialogs
+ set to at least Restore dialogs from last session in order
+ to keep the position/size of the Stream Chat dialog between sessions.
+
+
Commands
+
+
/openStreamChat - Opens the Stream Chat dialog
+
/setStreamChatSize <width>x<height> - Set the exact size of the Stream Chat dialog in pixels
+
/getStreamChatSize - Shows the size of the Stream Chat dialog in pixels
+
/clearStreamChat - Removes all messages
+
/streamChatTest [message] - Adds a test message to the Stream Chat dialog, if you don't specify a message
+ a default one is used
You can give people in chat custom names that will appear in chat and
+ in the userlist instead of the regular Twitch username and in the User Info
+ Dialog in addition to the regular Twitch username. In other places (like
+ the User Context Menu or auto-completion) the regular Twitch username is
+ used.
+
+
The following commands are used to set custom names:
+
+
/setname <name> <custom name> - to set a custom name
It is recommended that you read and understand this whole section
+ before enabling this feature.
+
Chatty implements the new /w command that Twitch Chat provides, allowing
+ you to send private messages in chat to other users. However, it is disabled
+ by default, since it has a few problems:
+
+
Twitch is currently testing Whispering on the Group Chat servers but
+ is planning to move it to a whole different system soon, which means
+ in the current state it is not really encouraged to be used by
+ third-party applications. It is unclear what the new system will be
+ and whether it will be possible to implement it in Chatty. Also, due
+ to these circumstances, not too much development time will be put
+ into the Whisper feature in Chatty at this time.
+
Whispering currently runs on the Group Chat servers, so Chatty can't
+ just use irc.twitch.tv to connect as for regular chat.
+ Since there is no easy official way to get the server data
+ automatically, you have enter the IP and port yourself if you want
+ to use this feature.
+
+
Getting started
+
You have to change a few settings in order to use this feature
+ (all under Main - Settings - Advanced):
+
+
Whisper Enabled: Connect to the given Group Chat server to send and receive
+ whispers.
+
Server: The Group Chat server IP to connect to. You can check:
+
+
Twitchstatus.com (unofficial site) at the bottom of the page,
+ "Group Chat" tab
+
Get an IP from the Twitch API using this guide
+ (you will need a token and be member of a Group Chat, you won't need to get a channelname)
+
+
Port: The port for the Group Chat server you
+ are using (you should get it along with the IP).
+
+ All these three settings require a restart of Chatty to take full effect,
+ although it may have some effect without a restart.
+
+
Once properly enabled and connected, [W] will be shown in the titlebar and
+ the /connection command will show the Whisper connection.
+ The connection is attempted once you connect to regular chat.
+
+
+
Optional settings:
+
+
Whitelist: If enabled, only users that have the
+ Addressbook category whisper will be able to send
+ whispers to you. Messages from other users are completely ignored.
+ Alternatively you can also blacklist users by adding them to the
+ blockwhisper category (which makes most sense with the Whitelist setting
+ disabled).
+
Display: Changes where the whispers are displayed.
+
+
Active Chat - Show in the chat window you are currently having
+ active in Chatty.
+
One Window - Show all whispers in one separate window.
+ In that window you will be able to respond to whispers by
+ just typing <name> <message> instead
+ of having to use the /w command. To be sure you
+ actually provide the user to send it to you can only whisper
+ to users that have already whispered to you (so e.g.
+ Hey how are you? :) wont't be send to the user
+ named Hey). The tab for collecting all whispers
+ is named $[whisper].
+
Per User - Open an extra tab for every
+ user that whispers to you. You can respond to whispers by
+ just typing the message in the tab for that user. The tab
+ will be named $<username>.
+
+
+
+
+
+
Usage
+
+
When you receive a whisper, it will be displayed depending on the Display setting and
+ will be indicated by the nickname being marked like this: -[name]-
+
When you send a whisper via /w <name> <message>,
+ then this will be indicated in chat by the nickname being marked like this: >>[name]
+
In both cases the name is the name of the person you are talking with, not your own name.
+
When you click on the name, you will be able to see your conversation,
+ with your own messages marked with a asterisk in front (*), which is usually
+ used to mark action messages (/me).
+
+
+
If you get a lot of errors like Whisper feature: Disconnected there
+ may be a temporary problem, you may have entered the server/port wrong or
+ the feature is not working as it is implemented in Chatty anymore (in which
+ case you should disable the feature).
The Channel Info Dialog shows the current stream status of the active
+ stream. The data is requested from the Twitch API in a semi-regular interval,
+ so it can take some time to update.
+
+
Online Time
+
If the stream is online, the Online: 1h 30m
+ shows how long ago the stream was started. That time comes directly from the
+ Twitch API, so it is able to show the correct online time, even if you started
+ Chatty after the stream started.
+
+
If there is a time in parentheses
+ (like 1h 30m (2h)), then that time denotes how long the stream
+ was online, but including small offline periods (PICNICs) of at most 10 minutes,
+ which means that this time is more of a guess of what might be expected as
+ stream online time and also depends on when Chatty got the data (if you join
+ the channel after a PICNIC, then it won't include the time before, because it
+ never received the data for it).
+
+
History Graph
+
The History is a graph that shows the development of the viewers
+ of the currently active channel and also indicates stream status changes
+ (online/offline/title/game) by different colors.
+
Hover over points to display the stream status and viewercount
+ at that time. Right-click for a context-menu.
+
+
+
+
+
There are two ways to change which time range is being displayed:
+
+
Time Range means only the last x hours
+ are being displayed. For example if the whole data spans 10 hours
+ you can choose to only display the last 2 hours. This will display
+ the maximum range after the actual range
+ (even if the actual range isn't as long as the
+ maximum range):
+ 15:32 - 19:14 (2h)
+ You can change this via the context menu.
+
+
Fixed Start/End means that either
+ the beginning of the displayed data is fixed or both the
+ beginning and end of the data are fixed, meaning that the
+ displayed graph will never change. The times that show the
+ actual range indicate whether they are fixed:
+ |15:58| - 19:14 or |15:58| - |18:20|
+ Double-click on a point to set it as a fixed start, then
+ double-click on another point to set it as a fixed end.
+ Double-click anywhere else to clear fixed start/end.
+ This setting is channel-specific and isn't saved when you
+ close Chatty.
+
+
+
+
+
+
+
+
+
+
+
The History is recorded while you have the channel open in Chatty
+ as well as for all followed channels, if you have that feature
+ enabled.
+
The shown data usually fits to the available vertical space
+ (so if the min/max viewercounts were 341/403 then only this
+ range is shown). If you choose Toggle Vertical in
+ the context-menu, you can switch between the shown range
+ (min/max) and the full range (0-max).
Chatty can show Notifications when the status of a stream changes.
+ There is also a Live Streams window (Channels - Live Channels)
+ that shows the currently live streams. Both these features always include channels you have
+ joined and - if enabled - channels you have followed. Streams that are
+ no longer online, or whose channels you have left and you don't follow,
+ are added to a list that you can open in the Live Streams window context
+ menu (Removed streams..).
+
+
Notifications
+
Chatty Notifications are little info boxes that can be shown for stream
+ status changes and highlighted messages. When you left-click on a notification
+ it is closed immediately, right-clicking closes it as well and in addition
+ also joins the associated channel.
Chatty can request a list of streams you follow on a regular basis, so
+ you have both an overview of currently live streams as well as be
+ informed about status changes (offline -> online, title change, game change).
+ This is always available for streams whose channels you have joined in chat,
+ but with this feature enabled, this works for all streams you follow even
+ without joining their channel.
+
This feature requires Read user info access, so Chatty can
+ request your followed streams. Read the section about login
+ to learn more about login data and access.
+
You can enable/disable this feature in the Settings under Notifications.
You can open a list of the Followers of a channel by joining that channel
+ and then opening the Followers Dialog via Extra - Followers.
+ It always opens on the currently active channel, or if you are in no channel
+ at all, your own channel.
+
+
You can open a list of your Subscribers by opening the Subscribers Dialog
+ via Extra - Subscribers. It always opens on your own channel,
+ because you can only display the Subscribers of your own channel. If you don't
+ have any Subscribers, it will simply show an empty list (and an error). You
+ also need to have selected the necessary access when
+ requesting login data.
+
+
You can save the current list to a file by right-clicking on the dialog
+ (not the list) and selecting the format.
+
+
Usage
+
Both the Followers and Subscribers Dialog otherwise work in pretty much
+ the same way. Data is only requested as long as you have the dialog open. It
+ is requested in a semi-regular interval and then displays that data in the
+ list (and some stats).
+
If followers/following is mentioned below, then the same applies for
+ subscribers/subscribing in the appropriate dialog.
+
+
+
+
At the top it shows some stats:
+
+
Total: The total number of followers (not to be confused
+ with the followers shown in the list, which are the most recent 100).
+ After the total number, it shows the change compared
+ to the last update, e.g. Total: 3.190 (+2),
+ which will stay there until the next update.
+
Week/Day/Hour: These are some stats based
+ on the current list shown below. It shows how many followers
+ there are in the list that followed in the last 7 days (Week), 24 hours (Day) and
+ 60 minutes (Hour). (So Day does NOT mean Today
+ as in since 0:00.)
+ If it says 99+ it means that there are more than
+ 99 followers in that timespan, but Chatty can't determine whether
+ it's 100 or more than 100, because the list only contains the
+ 100 most recent followers.
+
+
+
There are different background colors for some entries:
+
+
New entries (meaning entries
+ that appeared first in the last update)
+
Entries of the last 15 minutes
+
Entries of the last hour
+
+
+
The time has different colors for older entries:
+
+
Entries older than a day
+
Entries older than a week
+
+
At the bottom, it shows approximately how long ago data was last received,
+ or a short error message if an error occured.
+
+
+
+
+
+
About New Followers/Refollows
+
Everything that determines whether a follower is new or a refollow is
+ saved per session. So if you restart Chatty, it assumes that all followers
+ except from the first request are new. So if you start Chatty, open the
+ Followers Dialog on your channel, it will load the followers for the first
+ time and show none of them as new. Now if it updates a minute later, and there
+ are users it hasn't seen as having followed before, then it assumes these
+ users as new followers.
+
+
Now a user of course might have been a follower for a year, then unfollow
+ and follow again. Chances are that Chatty won't notice that and assume a new
+ follower. What it however does is that it only shows each user as new follower
+ once per session. So if someone follows and Chatty shows that user as a new follower,
+ then that user unfollows and follows again, Chatty will notice that the first
+ and the second follow time are different, and will show this user as a refollow
+ (the name slightly grey).
+
+
So this basicially just prevents the same user from e.g. making a sound
+ go off (if you have that enabled) several times just by refollowing several
+ times. At most that will happen once per session. Other than that
+ the data is mostly shown just as it comes in from Twitch. It will still
+ show refollows on the top of the list.
Chatty can help you with creating Highlights of your stream by recording
+ the stream time (how long the stream has been online) using a command or
+ hotkey. When you add a Stream Highlight in Chatty, it is written to a file
+ which you can then view later.
+
+
The following commands are available:
+
+
/addStreamHighlight [comment] - Adds a highlight at
+ the current time, with a comment if you want to.
+
/openStreamHighlights - Opens the file where the stream
+ highlights are stored in your default text editor.
+
+
+
You can also add a hotkey to add stream highlights, so you can also do it
+ yourself while streaming out of a game (given that global hotkeys work in
+ the game).
+
+
Allow your moderators to add highlights
+
You can also let your moderators add stream highlights
+ (!addStreamHighlight [comment]), but you first have to
+ change some settings:
+
+
+
/set streamHighlightChannel #<yourchannelname> to
+ allow moderators in the given channel to run the command
+
/set streamHighlightChannelRespond 1 to send a response to
+ chat when the mod command is used (otherwise the message is just shown locally)
+
/set streamHighlightCommand !highlight to set !highlight
+ as mod command
Both the ignore joins/parts and Twitch Client Version 3 option have
+ been removed. You can now disable the Correct Userlist
+ setting to not get any joins/parts if you think it could improve performance.
There are a few options you can launch Chatty with, that will override
+ settings loaded from the settings file:
+
+
+
-server <host/ip>
+
Specify a different server to connect to
+
+
-port <port>
+
Specify a different port to use for connecting
+
+
-user <username>
+
Your username
+
+
-password [password]
+
Login with password instead of access token, optionally
+ also the actual password to use. Twitch doesn't allow
+ password login anymore.
+
+
-token [token]
+
Login with the given token
+
+
-connect
+
Connect immediately when starting Chatty
+
+
-channel <channel>
+
The channel to join
+
+
-ds
+
Don't save settings on exit (settings are everything that is
+ saved between sessions like login data, always on top, ..)
+
+
-cd
+
Use current working directory (usually the directory you
+ start Chatty from) for saving/loading settings and other files.
+ This can be useful to make Chatty more portable or use several
+ different setting files on the same computer.
+
+
-set:<settingName> <setting value>
+
Change any setting that can be edited via the /set
+ command (see Setting Commands).
Settings are loaded from files when Chatty is started and saved into files
+ once it is closed. By default these files are saved in a subfolder
+ .chatty of your user directory. You can also use the
+ -cd commandline parameter to use the current working
+ directory instead. You can find out which folder is used by entering the
+ /dir command.
+
Since Version 0.4 of Chatty, the settings are no longer saved in a single
+ settings-file, but instead several files:
+
+
login: Contains the login data, including the access
+ token, which should be kept confidential.
+
favoritesAndHistory: Contains channel history and
+ favorites, as well as game favorites.
+
settings: The main file, which contains all customizations
+ made to Chatty that should not be confidential or private.
+
statusPresets: Contains status (title/game) presets
+ from the Admin Dialog.
If you are referring to a specific version of Chatty, please provide the
+ actual version number, which you can find on the top of the main help page in Chatty
+ (this one if you are reading this in Chatty, otherwise go to Chatty and open
+ Help - About/Help or press F1).
This application (except for the parts mentioned in the previous paragraph)
+ is released under the MIT License.
+
+
+Copyright (c) 2014 tduva
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.
The addressbook allows you to add usernames and assign categories to
+ them, which can then be used in other places such as the Usercolor settings
+ or the Highlight settings.
+ Categories cannot contain spaces and are all made lowercase when added/loaded from file.
The addressbook dialog (<Main Menu> - Channels - Addressbook)
+ where all entries are listed and you can add/edit/remove entries.
+
From the user context menu (when you click on a user, then Addressbook)
+ where the entry for this user can be directly added/edited/removed. There
+ you can just select/unselect the categories this user should be in
+ (although only the categories that are already used in the addressbook
+ are listed, so if you want to add a completely
+ new category, you have to add it once by manually editing an entry).
In addition to the addressbook dialog and user context menu, there are also some commands to
+ edit the addressbook. All commands are prefixed with /ab
+ (e.g. /ab add <name>) or alternatively /users (e.g. /users add <name>):
+
+
add <name> - Adds a name
+
add <name> <categories> - Adds a name and directly assigns it the given categories, or adds the
+ categories to the name if it already exists (categories are comma-seperated, without spaces)
+
set <name> <categories> - Sets the categories for this name, adding it if necessary, replacing
+ any present categories for this name
+
remove <name> - Completely removes the given name
+
remove <name> <categories> - Removes the given categories from this name, but leaves
+ the name
+
change <name> <categoriesModification> - Prepend categories with +,
+ - or ! to add, remove or toggle the categories respectively. You can specify more than
+ one set of categories, for example: change test +a,b -c !d adds a and b, removes c and toggles d
+
get <name> - Shows the categories for this name
+
info - Shows number of entries and used categories
+
+
Categories are given as a comma-seperated list without spaces, e.g. cat1,cat2,cat3.
+
The following commands edit all entries at once, so they should be used with care:
+
+
renameCategory <currentName> <newName> - Renames a category, which means all occurences
+ of currentName are replaced with newName in all entries. This can also
+ be used to merge categories, if newName already exists.
+
removeCategory <name> - Removes the category with the given name from all entries
+
+
+
Command Examples
+
+
/ab add josh vip
+
Adds the category called vip to the user called josh
+
(Also adds the user to the addressbook in the first place, if not already there)
+
(josh's categories would now be: vip)
+
+
/ab set josh rainbow
+
Sets the categories of the user josh to rainbow, replacing
+ any previously associated categories
+
(josh's categories would now be: rainbow)
+
(Also makes josh kind of colorful in chat, try it out with your own name Kappa)
+
+
/ab add josh vip
+
Adds the category called vip to the user josh
+
(josh's categories would now be: rainbow,vip)
+
+
/ab remove josh vip
+
Removes the category called vip from the user josh,
+ keeping the other categories untouched
You can use this to let the moderators of your channel edit your addressbook.
+ Depending on what commands you allow them to use, this can be a powerful tool,
+ so make sure you keep an eye on what your moderators do.
+
+
The following settings affect the this feature (you have to change them
+ via setting commands):
+
+
+
abCommandsChannel
+
Set this to the channel you want this enabled in. You can reset the
+ setting to empty using the /clearSetting command to
+ disable the mod commands again.
+
/set abCommandsChannel #yourchannel
+
+
abCommands
+
A comma-seperated list of commands you want the mods to be able to
+ use. Commands can be anything that is
+ listed in the Commands section above. So for
+ example if you wanted to allow the add and set
+ commands, the setting value would be add,set (no spaces).
+
/set abCommands add,set
+
Default value for this is add,set,remove.
+
+
+
If you set the settings accordingly, then the mods will be able to use
+ e.g. !add name category to add name to your
+ Addressbook with the category category. Chatty will output
+ a message about the change, similiar to when you enter the command yourself.
+ It does not send a message to chat, so if you want your moderators to see an
+ actual response, you need to have Chatty on stream (which means the response
+ is also affected by stream delay of course).
This is a rather experimental feature, so it might not work reliably.
+
+
You can write Addressbook commands (one per line) to the addressbookImport.txt
+ file in the settings directory (enter /dir to find out what
+ your settings directory is). You can use any commands specified in the Commands section above, without
+ the /ab or /users prefix (since it's already
+ implied that they are Addressbook commands). For example:
To perform an import, enter the /abImport command and Chatty
+ will read the file and execute each command as if you would have entered
+ it in the input box. Information about the
+ command results is output in the debug window (Extra - Debug window)
+ and the debug log file.
+
+
You can also set the abAutoImport setting (/set abAutoImport on)
+ and the file will be read automatically within a few seconds when it is
+ detected to have been changed. You have to restart Chatty after changing
+ the abAutoImport value for it to take effect.
+ To make sure no data is lost, you should not
+ write to the file too often, or else it may already be overwritten once
+ changes are detected and the file contents are read and the commands performed.
+
+
It will also not be read automatically when you on start of Chatty,
+ so you should only apply changes while Chatty is running or
+ use the /abImport command to manually read the file once after
+ start. If you only change the file while Chatty is running, manually reading
+ the file should not be necessary.
Open the Admin Dialog via View - Channel Admin or by
+ right-clicking on the channel to open the context menu and choose
+ Channel Admin.
+
+
In the Admin Dialog you can change the title/game of your channel and
+ run commercials, if you have allowed the necessary access when getting your
+ login data. You need Editor access for changing game/title and
+ Commercial access for running commercials. See allow more access.
+
The Admin Dialog is always opened for the currently selected channel,
+ unless there is no channel open (which is the case just after you started Chatty),
+ in which case it will always be opened for your own channel, which is derived
+ from your configured account name.
The Status-Tab lets you view and change the title and game of your channel.
+ The information is loaded when you open the dialog and when you press the
+ reload-Button. If others may have changed the info in the meantime,
+ you may want to reload before trying to change it.
+
+
Select a game
+
When you select a game, another dialog will open where you should enter
+ part of the name of the game in the search field and hit Enter
+ or click the Search-Button to find the correct name, which
+ you can then select. You can also just use the name you entered yourself,
+ but you should usually use the search to make sure your stream appears in
+ the correct category on Twitch.
+
+
Use presets
+
There are also status presets, which allow you to add a combination of
+ title and game, so you can select it later. By pressing Fav
+ on the Status-Tab, you can add the current status to the favorites.
+ The status is also automatically added to the history every time you
+ press the Update button.
+
Press the Presets button to open a table with the favorites
+ and status history. You can filter the table by only showing entries for
+ the game currently have selected or only showing favorites.
+
History entries (the ones that are not favorites) are automatically
+ removed after some time, you can change when they are removed and
+ whether they should be added in the first place in the settings.
+
The Last Activity columns shows when this status was last
+ set using the Update button (or when it was added to the
+ favorites for the first time). The Usage column shows how
+ often it was set using the Update button.
If you are partnered with Twitch, you can run commercials on your channel
+ here (even if you are not partnered it may run a commercial). Click on the
+ appropriate button to try to run a commercial of the given length.
+
+
The Last run time shows when a commercial was last run
+ through Chatty (this session).
+
+
Schedule commercials
+
There are two different ways of scheduling a commercial, either running
+ a single commerical on a delay or repeating running a commercial on a delay.
+ Select either or both options and then press a Run commercial
+ button to schedule the commercial. Press the same button again to cancel the
+ scheduled commercial. Click a button of another length to change the length
+ of the commercial while keeping it on schedule. Scheduled commercials are
+ not completely exact, they may be run a few sceonds too late.
+
+
If you have Use delay selected, then the commercial will be
+ scheduled to run after the specified time. If you have Repeat selected,
+ then - after each commercial run through Chatty - another commercial will automatically be scheduled to run again with the same delay.
+ You don't need to have Use delay selected for Repeat
+ to work, they just both use the same time as delay.
+
+
The time for the delay will be interpreted as seconds by default, but you
+ can also specify minutes. Examples: 30 (30 seconds), 5m
+ (5 minutes), 120s (2 minutes).
+
+
Run commercials via global hotkey
+
If you have downloaded the appropriate version of Chatty (the one with
+ "hotkey" in the .zip filename, Windows only), you can define a global hotkey
+ to run 30s commercials on the channel you currently have open. The hotkey
+ can be defined on the Commercials tab in the Admin Dialog
+ (don't forget to press Set to actually set it).
+
+
If you have the Admin Dialog open on the Commercials tab,
+ then executing the hotkey will simulate a click on the 30s button, with all
+ the implications like being able to use a delay, running the commercial on
+ the channel that the Admin Dialog was opened on (instead of the currently
+ active channel) and so on.
+
+
+
diff --git a/help/help-getting-started.html b/help/help-getting-started.html
new file mode 100644
index 0000000..2bcd409
--- /dev/null
+++ b/help/help-getting-started.html
@@ -0,0 +1,132 @@
+
+
+ Chatty Help - Getting Started
+
+
+
This is a short guide to help you with installing Chatty and getting familiar with some of it's features.
+
+
Download & Installation
+
You can download Chatty from it's Website.
+ The download simply consists of a .zip-file which you should
+ extract wherever you want to have Chatty. The extracted files include a
+ Chatty.jar which you should usually be able to double-click to
+ start the program (if Java is installed properly). (See the help
+ if Chatty won't start.)
+
+
Update Chatty
+
If you already have an older version of Chatty and want to update, then
+ just replace all the files with the new ones in the .zip.
+ Basicially just unzip the .zip into the same folder and overwrite
+ all files if asked (unless you have some custom icons or sounds that have the same name).
+ You can also unzip it into a new folder (just make sure you don't use the old version anymore).
+
+
Your settings are saved seperately in the settings directory
+ and are not lost when you upgrade to a new version. The new version should normally
+ automatically use the same settings without you needing to change anything.
+ If you are interested in what your settings directory is,
+ enter /openDir in Chatty. There is also a backup
+ folder in there with backups of the settings.
+
+
Please check out the Release Information for any changes in a new version that
+ may require your attention.
+
+
Note: If you downgrade to an older version of Chatty, some settings (that the older
+ version didn't have yet) may be lost. So make sure you don't run old versions of Chatty
+ without knowing what you are doing, if you have changed settings unique to newer versions.
+
+
Creating a login
+
If you are starting Chatty for the first time, you will have to request
+ login data from Twitch so Chatty can connect to chat for you and do other
+ stuff like show live streams you follow.
+
In the Connect-dialog, click on Create login..
+ and then Request login data and simply follow the instructions.
+ Once you successfully created the login, close the dialog until you get back
+ to the Connect-dialog. (There is a Guide on what to do
+ when getting login data fails.)
+
+
Join channels (and leave channels)
+
In the Connect-dialog enter the name of the channel you want
+ to join in the Channel: input box. The name of the channel
+ is the same as the name of the stream. You can enter more than one channel
+ name to join by seperating them with a comma. To connect simply press Enter
+ or click on Connect. After connecting, it will automatically join
+ the channels you specified.
+
+
Even after connecting you can join additional channels via Channels - Join Channel
+ or entering the command /join <channelname> in the inputbox
+ (e.g. /join joshimuz).
+
+
You can leave channels by right-clicking anywhere in the channel and
+ selecting Close Channel from the context menu or right-clicking
+ on the channel's tab (only available if there is more than one channel) and
+ selecting Close from the context menu.
+
+
Chatting and Moderating
+
Chatting is pretty straightfoward as you would expect from any chat program,
+ however the inputbox has a few useful features. Enter the beginning of a name
+ in chat and press TAB to auto-complete the name.
+ Press Up-Arrow key to go back to previous stuff you entered.
+
+
To moderate a chat, you can of course use the regular moderations commands
+ like /ban, /timeout and so on, but a much more
+ convenient method is to click on the name of a user you want to ban/timeout,
+ which opens the User-dialog, containing several moderation
+ buttons as well as the recent messages of that user, so you can quickly check
+ if you are actually timing out the correct user.
+
+
+
+
Information about the current stream
+
Chatty regulary requests information about the current stream, which is
+ displayed in the titlebar and the Channel Info-dialog.
+
+
+
+
You can open the Channel Info via the View-menu
+ or the channel context menu (right-click anywhere on the channel). The
+ Channel Info contains the current title/game but also a history
+ of the Viewercount and previous title/games (if you hover over points).
+
+
+
Get notified about streams you follow that go live (and join them)
+
Open the Live Channels-window via Channels - Live Channels
+ to open up a list of streams you follow that are currently live or streams
+ whose channel you have currently joined that are currently live.
+
+
(You need to have the required access with your login data to see streams
+ you follow.)
+
+
You can enable/disable showing streams you follow in the Settings - Notifications.
+ There you can also configure what kind of Tray Notification you want to have
+ pop up for stream status changes or highlighted messages.
+
+
To join channels directly out of the Live Channels-dialog
+ right-click on a stream to open the context menu and then select Join channel
+ to join the channel for that stream and if you want also open the stream in
+ your browser or Livestreamer.
+
+
More stuff you might want to try out..
+
+
Right-clicking, or whatever opens a context menu
+ in your OS. There are a lot of context menus in Chatty, e.g. for usernames
+ (as shown above), links, emoticons, anywhere else in the channel, tabs,
+ entries in favorites, the live streams dialog, the Channel Info dialog..
+
Configure Chatty to your needs. Open the Settings
+ from the Main-menu to get all kinds of settings to adjust
+ Chatty to your preference. Please make use of the Help link
+ in the bottom left corner of the Settings-dialog to get
+ help on the current page of settings you have selected.
+
Ask if you don't understand something. I tried to
+ make the help as comprehensive and easy to understand as possible, but
+ a lot of stuff is probably pretty confusing if you aren't as familiar with
+ the program as I am. So please ask about stuff and maybe also (if you can)
+ propose changes to the help that would make it easier to understand. There
+ are various ways to contact me.
If you want to run Chatty more than once at the same time, you may need
+ to know how it saves it's settings. By default the settings are saved
+ in your user-directory in the subfolder .chatty (where it is
+ exactly is system-dependant, enter /dir in Chatty to show it's location). When you run the program, it loads the settings
+ and when you exit the program, it saves them, overwriting the file with
+ no regard to possible changes (to the file) that may have occured in the meantime.
+
This means that when you run more than one instance on the same computer,
+ the last one you close always overwrites the settings.
+
+
Seperate settings
+
You can change the default settings directory by using the -cd
+ commandline paramter, which changes the settings directory to the current
+ working directory, meaning the settings are loaded and saved in the same
+ location you specified as working directory.
+
This means you can easily run more than one instance on the same computer
+ with completely different settings, just by using that commandline parameter
+ and specifying different working directories (e.g. in Windows in the shortcut
+ settings).
When you want to run several instances with different settings, but want
+ to use the same account, you run into problems. Everytime you request login
+ data (token), the old login is invalidated, so you have to share the login data
+ you already have between different instances.
+
+
You can do this by simply copying the login settings file
+ which contains the login data. Make sure you closed the Chatty instance
+ you requested the login data with at least once, so it's actually saved
+ to the file.
+
+
You could also try to play around with symbolic links
+ to point to a shared login file.
+
+
Using Chatty on different computers
+
If you want to run Chatty on different computers with the same account,
+ you run into the same problem as mentioned under Sharing login data:
+ You can't have more than one access token with the same account for the same
+ app at the same time.
+
To use Chatty on more than one computer with the same account, you'll
+ have to transfer the login data, either by copying the login
+ file or by entering the access token manually
+ (/get token displays the token,
+ /changetoken <token> changes it).
+
+
+
+
diff --git a/help/help-guide2.html b/help/help-guide2.html
new file mode 100644
index 0000000..c7e6b81
--- /dev/null
+++ b/help/help-guide2.html
@@ -0,0 +1,111 @@
+
+
+ Chatty Help
+
+
+
Use this guide when the normal procedure of getting login data fails.
+
+
Can't listen to port
+
If you open the Get login data dialog and it says it can't
+ listen to the port, first check the following:
+
+
Make sure no other instance of Chatty is running that may already
+ have taken the port.
+
Check if no other program may already be listening to that port.
+
If the problem persists, reboot your PC and then try again.
+
+
If you can't fix this problem and there are no other error messages that
+ may indicate what is going wrong, then you can manually open the necessary
+ page (opening any of these links will invalidate any previous login
+ you requested for Chatty, so only do it if you really want to get a new one):
Since the webserver in Chatty won't run if you got any of the aforementioned
+ errors, your browser will tell you it can't load the page when you get to
+ http://127.0.0.1:61324. Read on in the next section, especially
+ Manually add the login into Chatty.
+
+
The browser says it can't open the page after you authorized Chatty
+
If you successfully opened the link, authorized Chatty on the Twitch.tv
+ page and got redirected, but the browser can't open the page, first check this:
+
+
If you followed the regular process until now, check if the
+ Get login data dialog is still open and it says Ready..
+ It needs to be open for this to work and will close automatically when it received
+ the necessary data.
+
+
If you can't get the page to load, you can manually add the login data into Chatty.
The information you need should be in the address bar of your browser (where you got the error that it couldn't connect to the page).
+ It should look something like this:
+ http://127.0.0.1:61324/token/#access_token=[longish mix of letters and numbers]&scope=chat_login+channel_editor+channel_commercial+user_read
+
+
The access_token (longish mix of letters and numbers)
+ is sort of a revokable password that lets Chatty
+ use some of the Twitch services on behalf of your account. Copy that from
+ the address bar, go to Chatty (close all dialogs if necessary) and paste
+ it into the following command (that you type into the input bar):
After entering the command, Chatty will finish the process by checking
+ the token and getting the username associated with it. If everything is ok,
+ it should say that you are now ready to connect.
+
If you want, you can check in Main - Login..
+ whether the token you entered has the correct access associated with it.
+
+
+
diff --git a/help/help-guide_create_shortcut.html b/help/help-guide_create_shortcut.html
new file mode 100644
index 0000000..3cdfecd
--- /dev/null
+++ b/help/help-guide_create_shortcut.html
@@ -0,0 +1,42 @@
+
+
+ Chatty Help - Create Shortcut and add Icon
+
+
+
You can give the shortcut the Chatty icon, to replace the Java icon without changing it for all Java programs.
+
+
Create shortcut
+
Create a shortcut to Java to start Chatty:
+
First way
+
+
Right-click in the folder you want to create the shortcut in, choose New - Shortcut from the context menu. Enter javaw -jar "D:\Chatty\Chatty.jar" as location of the item.
+
Go to the next page and enter a name for the shortcut and finish creating the shorcut.
+
Right-click on the newly created shortcut and choose Properties from the context menu. Make sure that under Shortcut the Start in points to the folder that the Chatty.jar is in (otherwise some stuff might not work).
+
+
Second way
+
+
Right-click on the Chatty.jar and drag it to an open area in the folder, then let go to open the context menu, choose the option to create a shortcut.
+
Right-click on the newly created shortcut and choose Properties from the context menu. In the Target field, it should have the path to the Chatty.jar. Before that add: javaw -jar , so that in total it reads for example: javaw -jar "D:\Chatty\Chatty.jar"
+
+
+
Editing shortcut
+
Add launch options or icon:
+
+
Right-click on the newly created shortcut and choose Properties from the context menu, then go to the Shortcut tab.
+
Add any launch options you want to use with Chatty after the path to Chatty. For example: javaw -jar "D:\Chatty\Chatty.jar" -cd
+
Click Change Icon.. and then Browse.. to select an item to use for the Shortcut from your harddrive. (Download Chatty icon as .ico file, right-click and Save target as..)
+
+
Use shortcut
+
You can then start Chatty by using this shortcut or you can drag it to the taskbar to attach it to it.
+
+
+
diff --git a/help/help-guide_folders.html b/help/help-guide_folders.html
new file mode 100644
index 0000000..193c306
--- /dev/null
+++ b/help/help-guide_folders.html
@@ -0,0 +1,135 @@
+
+
+ Chatty Help
+
+
+
The settings directory by default is in your user home directory in a
+ subfolder called .chatty. If you use the -cd
+ commandline parameter, then the settings directory is the current Working
+ Directory.
+
+
You can use commandline parameters by creating a shortcut and setting the
+ target to something like javaw.exe -jar "D:\Chatty\Chatty.jar" -cd.
+
Working Directory
+
This directory is associated with Chatty when you start it. This is usually
+ the directory the program is started from. If you created a shortcut to start
+ Chatty with, this may point to the Java-executable instead of Chatty itself,
+ which can lead to errors. In Windows, you can change the Working Directory
+ in the shortcut settings by changing what is defined under Run in.
+
JAR Location
+
This is where the Chatty.jar is located and is used for loading libraries
+ that Chatty uses.
+
+
Displaying Directories in Chatty
+
You can use the /dir command in Chatty to output the settings
+ directory and the /wdir command for the working directory
+ (/openDir and /openWdir to open them in the standard filebrowser).
+ You can also check the settings dialog for the directory where the logs
+ are saved in and the directory where the sounds are loaded from.
Chatty performs an automatic backup (enabled by default) everytime it is
+ started (if at least the number of days as defined in the settings have passed,
+ by default one). It copies the setting files (except login) to the backup folder
+ in the settings directory, increasing the numbering of the files with every
+ backup. It only makes as many backups as defined in the settings and then
+ starts over with the first number, rotating the files.
+
+
This is supposed to make recovery of settings easier in case they are not
+ read or written correctly and thus lost (which shouldn't usually
+ happen). In that case you can manually copy/rename the lost files from
+ a backup (just looks for the most recent one based on the change date
+ that looks fine).
+
+
If some settings are important to you this can help, but you
+ shouldn't rely on it. Always make your own backups, best on a
+ different device!
In general they should be 18x18 and in the .png format.
+
+
Put images in the correct folder
+
In Chatty, enter the command /wdir to see what your current working directory is (/openWdir to open it). Now in that directory, put the images
+ in the subfolder /img. So for example: C:\Chatty\img\
+
+
Configure Usericons in Chatty
+
Go to Main - Settings - Usericons and check Enable Custom Usericons. Then press the + button and in the dialog that opens,
+ select Turbo as Type to replace the turbo icon (or select other types to replace the other icons). Select the correct image file and your are done (if the image files are not there, click on Image Folder and make sure
+ your files are in that folder, rescan if necessary).
Some documentation of prior or current issues for reference.
+
+
+
Java Crash: Graphics Driver
+
+
Chatty just randomly closes, apparently the JRE completely crashes.
+
+
Crash report excerpt
+
+
+#
+# A fatal error has been detected by the Java Runtime Environment:
+#
+# EXCEPTION_ACCESS_VIOLATION (0xc0000005) at pc=0x000007f9c08f22bf, pid=272, tid=14464
+#
+# JRE version: Java(TM) SE Runtime Environment (7.0_45-b18) (build 1.7.0_45-b18)
+# Java VM: Java HotSpot(TM) 64-Bit Server VM (24.45-b08 mixed mode windows-amd64 compressed oops)
+# Problematic frame:
+# C [atig6txx.dll+0x122bf]
+
+[..]
+
+Stack: [0x000000000f5d0000,0x000000000f6d0000], sp=0x000000000f6c9bc0, free space=998k
+Native frames: (J=compiled Java code, j=interpreted, Vv=VM code, C=native code)
+C [atig6txx.dll+0x122bf]
+C 0x0000000000000000
+
+Java frames: (J=compiled Java code, j=interpreted, Vv=VM code)
+j sun.awt.Win32GraphicsDevice.getMaxConfigsImpl(I)I+0
+j sun.awt.Win32GraphicsDevice.getMaxConfigs(I)I+10
+j sun.awt.Win32GraphicsDevice.getConfigurations()[Ljava/awt/GraphicsConfiguration;+69
+j javax.swing.ToolTipManager.getDrawingGC(Ljava/awt/Point;)Ljava/awt/GraphicsConfiguration;+36
+
+[..]
+
+
+
Solution/Workaround
+
Seems to have to do with the graphics driver. Reinstalling/updating the graphics driver may
+help or using the following commandline parameter, which should disable the calls to the library
+that cause the error:
After some time, Chatty suddenly shows an error if using the Calibri font.
+
+
Excerpts
+
+
+java.lang.ArrayIndexOutOfBoundsException: 168
+ at sun.font.ExtendedTextSourceLabel.getCharX(ExtendedTextSourceLabel.java:353)
+ at java.awt.font.TextLine$3.computeFunction(TextLine.java:515)
+ at java.awt.font.TextLine.applyFunctionAtIndex(TextLine.java:651)
+ at java.awt.font.TextLine.getCharXPosition(TextLine.java:668)
+ at java.awt.font.TextLine.getCharLinePosition(TextLine.java:678)
+ at java.awt.font.TextLayout.buildCache(TextLayout.java:683)
+ at java.awt.font.TextLayout.ensureCache(TextLayout.java:655)
+ at java.awt.font.TextLayout.getAdvance(TextLayout.java:885)
+ at sun.font.FontDesignMetrics.charsWidth(FontDesignMetrics.java:510)
+ at javax.swing.text.Utilities.getTabbedTextOffset(Utilities.java:422)
+ at javax.swing.text.GlyphPainter1.getBoundedPosition(GlyphPainter1.java:213)
+ at javax.swing.text.GlyphView.getBreakWeight(GlyphView.java:722)
+ at javax.swing.text.ParagraphView.calculateMinorAxisRequirements(ParagraphView.java:732)
+ at javax.swing.text.BoxView.checkRequests(BoxView.java:935)
+ at javax.swing.text.BoxView.getMinimumSpan(BoxView.java:568)
+ at javax.swing.text.BoxView.calculateMinorAxisRequirements(BoxView.java:903)
+ at javax.swing.text.BoxView.checkRequests(BoxView.java:935)
+ at javax.swing.text.BoxView.setSpanOnAxis(BoxView.java:343)
+ at javax.swing.text.BoxView.layout(BoxView.java:708)
+ at javax.swing.text.BoxView.setSize(BoxView.java:397)
+ at javax.swing.plaf.basic.BasicTextUI$RootView.setSize(BasicTextUI.java:1714)
+ at javax.swing.plaf.basic.BasicTextUI.modelToView(BasicTextUI.java:1046)
+ at javax.swing.plaf.basic.BasicTextUI.modelToView(BasicTextUI.java:1022)
+ at javax.swing.text.JTextComponent.modelToView(JTextComponent.java:1428)
+ at chatty.gui.components.ChannelTextPane$ScrollManager.scrollDown(ChannelTextPane.java:1107)
+ at chatty.gui.components.ChannelTextPane$ScrollManager.access$200(ChannelTextPane.java:994)
+ at chatty.gui.components.ChannelTextPane.printInternal(ChannelTextPane.java:932)
+ at chatty.gui.components.ChannelTextPane.print(ChannelTextPane.java:906)
+ at chatty.gui.components.ChannelTextPane.printSpecials(ChannelTextPane.java:772)
+ at chatty.gui.components.ChannelTextPane.printMessage(ChannelTextPane.java:189)
+ at chatty.gui.components.Channel.printMessage(Channel.java:228)
+ at chatty.gui.MainGui$15.run(MainGui.java:1498)
+
+
+java.lang.ArrayIndexOutOfBoundsException: 0
+ at sun.font.ExtendedTextSourceLabel.createCharinfo(Unknown Source)
+ at sun.font.ExtendedTextSourceLabel.getCharinfo(Unknown Source)
+ at sun.font.ExtendedTextSourceLabel.getCharX(Unknown Source)
+ at java.awt.font.TextLine$3.computeFunction(Unknown Source)
+ at java.awt.font.TextLine.applyFunctionAtIndex(Unknown Source)
+ at java.awt.font.TextLine.getCharXPosition(Unknown Source)
+ at java.awt.font.TextLine.getCharLinePosition(Unknown Source)
+ at java.awt.font.TextLayout.buildCache(Unknown Source)
+ at java.awt.font.TextLayout.ensureCache(Unknown Source)
+ at java.awt.font.TextLayout.getAdvance(Unknown Source)
+ at sun.font.FontDesignMetrics.charsWidth(Unknown Source)
+ at javax.swing.text.Utilities.getTabbedTextWidth(Unknown Source)
+
+
+
Solution/Workaround
+
Hopefully this will be fixed in future Java updates, but for now just don't
+use a Calibri font.
Twitch Emoticons appear wrong when Chatty is displayed on a Retina display.
+Instead of the Emoticon images, the 404 image the Twitch CDN redirects to is
+shown.
+
+
Apparently in newer Java versions Toolkit.getImage() tries to find a higher
+resolution image by adding @2 to the file name, which the Twitch CDN actually
+responds to by redirecting to an error image, which is then displayed.
+
+
Solution/Workaround
+
Use Toolkit.createImage() and create an ImageIcon with the created image.
Livestreamer
+ is a commandline program that can be used to watch streams in a player like
+ VLC Player. It has to be downloaded and installed seperately from Chatty.
You can open the Livestreamer dialog that Chatty provides via
+ Extra - Livestreamer, where you can directly run Livestreamer
+ and change some settings.
+
+
Each time you open a stream via the dialog or a context menu, a tab is
+ added to the dialog where the output of the Livestreamer process is
+ redirected to. If you open a stream with the same stream name and quality you already
+ have open in a tab whose process isn't currently running, then that tab will
+ be reused.
+
+
The tab of a stream is automatically closed when you close the Video
+ Player opened by Livestreamer, if the dialog isn't currently open. Otherwise
+ you have to close it yourself by using the Close-button on the
+ top right, which turns into an End process-button as long as
+ the process is still running. The Retry-button can be used to
+ re-run the last command of that tab (for example when it couldn't find the
+ stream, but you want to retry now because you know it's come online).
The settings can be changed in the Livestreamer dialog.
+
+
Enable context menu entry: Adds Livestreamer to all
+ context menus that can be used to open streams (like User Context Menu,
+ Channel Context Menu or Live Streams Context Menu).
+
Show dialog when opening stream: Automatically open
+ the Livestreamer Dialog when you open a stream out of the context menu.
+
Context menu qualities: You can customize which
+ quality options appear in the context menu. The options you enter here
+ are directly given as a parameter to Livestreamer, except Select
+ which tells Chatty you want to select a quality in the dialog. Seperate
+ qualities by space or comma. Add a | (vertical bar) to add
+ a seperator to the menu.
+
+
+ Examples:
+
+
Best, High, Worst | Select
+
Source High Medium Low Mobile | Select
+
+
+
Base command or commandline options: This is used to
+ construct the command to run Livestreamer and is basicially the part
+ before the URL and the quality. This should point to the Livestreamer
+ program itself, including any commandline options you always want to have included. The default is just livestreamer, which
+ should usually be sufficient if the program is correctly included in
+ the systems PATH variable (or similiar), but it may also include the
+ full path to Livestreamer. Surround the path or any other parameter with quotes if it contains
+ spaces (e.g. "C:\My Programs\Livestreamer\livestreamer.exe").
+
+ Examples:
+
+
"C:\My Programs\Livestreamer\livestreamer.exe" --player "C:\Program
+ Files\MPC-HC\mpc-hc64.exe" (specify full path to Livestreamer
+ and use a different player)
+
/usr/local/bin/livestreamer (this might work on Linux/Mac
+ if it can't find Livestreamer without the full path)
+
+
+
+
Use Authorization (Twitch Oauth Token): Supplies to
+ Twitch Access Token that is used for Chatty to Livestreamer to authenticate
+ you when watching a stream via Livestreamer (probably only necessary to
+ be able to watch sub-only streams).
If you get an error like Error: java.io.IOException: Cannot run
+ program "<...>": CreateProcess error=2 [..], then
+ Chatty probably can't find Livestreamer on your system.
+
+
To solve this, first make sure that
+ you actually have Livestreamer installed. You need to install it on you own, it does
+ not come bundled with Chatty. If you are sure it is installed (and you maybe can
+ run it from the commandline just fine), you may have to tell Chatty the full
+ path to the Livestreamer executable for it to work by entering it in the
+ Base command or commandline options field. See the Settings section
+ above for examples and help on that.
If you want to use the /w (whisper) command and receive whispers in Chatty, read the
+ Help.
+
+
Full Changelog
+
+New features:
+- Added experimental Whisper support (this will probably not developed much
+ until Twitch moves Whispers to the new system)
+- Improved TAB Completion: Added predictive sorting for names which gives users
+ who recently talked/highlighted you a higher priority, added setting to
+ toggle completion to common prefix (disabled by default)
+- Added $first option for Custom Usericon restriction to show them in front of
+ the regular Usericons
+
+Changes:
+- Show long slowmode times as "> day" in the titlebar
+- Added "Open in online help" button in Help window
+- Allow global FFZ/BTTV to be added to the favorites as well
+- Added $globalmod and $anymod status identifiers for Usericons/Usercolors
+- Show indication of action message (/me) in User Info Dialog chat history and
+ log files (star in front of the message)
+- Updated help
+- Added timestamp option to "Log to file" settings (previously only changeable
+ with setting commands)
+- Highlight/Ignore: Allow non-standard channels in chan:/!chan: prefixes
+- Added Copy Stream Name to Channel Context Menu (Miscellaneous submenu)
+
+Bugfixes:
+- Fixed error in slowmode message parsing
+- Changed Ignore option config:info to only apply to info messages, not regular
+ chat messages
+- Fixed tab not showing new message if message was highlighted with
+ config:!notify option
+
Improved Emoticon Dialog: Shows all global emotes and a detail
+ view for emotes.
+
TAB Completion: Now supporting completion of emotes (Shift-TAB),
+ setting names (TAB when typing after a setting command)
+ and custom completion items which can be added in the settings.
+ Also added popup showing info during completion and changed behaviour
+ a bit accordingly.
+
Correctly capitalized names are now enabled by default, since support
+ for the new display name tag that Twitch Chat provides has been added.
+
Added ability to write the current stream time to a textfile, aiding
+ in making Stream Highlights
+ (either by entering a command or allowing your mods to run the command).
+
+
+
Full Changelog
+
+Core Changes:
+- Connection: Implemented IRCv3 tags/commands/membership support
+- Userlist: IRCv3 now supports optional joins/parts (correct userlist), which is
+ enabled by default in Chatty (doesn't mean joins/parts have to be shown)
+- Added experimental support for secured connections
+
+Emoticons:
+- Changed Emoticon parsing to use spaces as delimiter instead of word boundaries
+ (to match changes made to Twitch Chat)
+- Scaling: Added settings to scale emotes in chat and the Emotes Dialog
+- BTTV: Implemented BTTV Custom Channel Emotes, switched to new BTTV API
+- IRCv3: Implemented new Twitch Emotes API, including using IRCv3 tags
+- Emote Dialog: Added overview of all global emotes (Twitch and Other)
+- Detail View: Added Detail View that can be opened for an emote with different
+ scaling and a table of information about the emote
+- Context Menu: Added more entries and information
+- Added emote image caching, making loading of emotes a bit faster and hopefully
+ more reliable if the server can't be reached at the time of loading
+- Added feature to add custom emotes (locally), also allowing you to replace
+ other emotes
+- FFZ: Switched to new API (and showing more info about the emotes)
+
+TAB Completion:
+- Changed to work with @ in front (or any other non-word characters around it)
+- Added info popup to show completion information (how many items are found,
+ which item you are at while cycling through results)
+- Added completion for emotes (Shift-TAB)
+- Added completion for setting names (TAB when using after setting command)
+- Added completion for some commands (TAB after /)
+- Added support for custom completion items that you can add in the settings or
+ via the /customCompletion command
+
+StreamChat:
+- Added fitting context menu to stream chat dialog
+- Added setting to START inserting text a the top in Stream Chat
+ (but not insert text at the top in general), added streamChatResizable setting
+- Added commands /clearStreamChat, /testStreamChat, /setStreamChatSize,
+ /getStreamChatSize
+
+Other Enhancements:
+- Added bot badge (bot names from BTTV/FFZ APIs and local setting)
+- Added ability to record current stream time via commands to assist in creating
+ stream highlights
+- Added setting to clear chat when channel is cleared by a moderator
+- Hosting: Added info in the title which channel is being hosted, added warning
+ in chat when a channel is still being hosted when the stream is going live
+- Streamlined reconnection messages a bit
+- Output message if channel attempting to join doesn't exist on Twitch
+- Added correctly capitalized names from IRCv3 display-name tag, removed
+ commands to change capitalization of names locally
+- Added experimental showing of slowmode/submode status in the titlebar (only
+ shows correctly if mode toggled while you are already in the channel, until
+ chat sends that info on join as well)
+- Added feature to locally set custom names for any user which show up in chat
+ and the userlist
+- Highlighting: Added more prefix options
+- Ignore: Added prefix option to ignore info messages
+- Added Miscellaneous-menu to User Context menu and added entry Copy Name
+ (meaning copy to clipboard)
+- Added Miscellaneous-menu to Channel Context menu and added entry to join
+ currently hosted channel
+- Added /copy command which copies the given text to the clipboard
+- Added /color command which redirects to the Twitch Chat /color command
+- Added /livestreamer command to open streams/dialog via command
+- Added /appinfo command
+- Added /r9k and /r9koff commands
+- Added workaround for Twitch API sometimes returning stream information with
+ missing channel object (no title available), assuming previous title
+- Updated help
+
+Changes:
+- Files: Moved cache files to be saved in the /cache folder
+- Reduced Twitch API debug log spam a bit
+- Increased join delay a bit
+- Updated Settings Dialog layout to adjust to the dialog size better
+- Changed Twitch API version calls to use v3 by default
+- Changed Usericon image files starting with "http" to be interpreted as URL
+- Disabled auto request of mods list for the time being, since mod status for
+ messages should always work and mod status in the userlist should probably
+ work if the userlist works in the first place
+- Decreased Live Streams dialog scroll speed a bit
+
+Settings:
+- Highlighting: Added highlightIgnored setting whether to try to highlight
+ messages that have already been ignored (disabled by default)
+- Changed capitalizedNames (first letter only) setting to default to on (only
+ affects fresh settings)
+- Debugging: Added setting to log raw IRC traffic to file (disabled by default)
+- Added mainResizable setting to be able to turn off resizing of the main window
+- Added setting to ignore Stream Status Notifications for Stream Offline
+- Added some more support for different setting types to setting commands
+- Changed setting commands to support numeric lists
+- Changed Settings Dialog to only tell you to reconnect if you don't have to
+ also restart Chatty (required by a setting change)
+
+Bugfixes:
+- Fixed bug where channel would constantly be reopened when it failed to join
+ (especially happening on non-existing channels)
+- Fixed bug where reonnection timer would sometimes not be cancelled
+- Fixed synchronization that could lock up the GUI when performing API requests
+- Fixed username case-sensitivity issues for commands
+- Fixed error in stream status writer when stream doesn't have a game set
+- StreamChat: Fixed bug where stream chat wouldn't scroll down properly
+- Addressbook: Fixed remove commands issues with case-sensitivity
+- Run correct commercial length in Admin Dialog when using a hotkey
+- Fixed close channel hotkey to close active channel rather chan active tab
+- Possibly fixed some info messages from Twitch Chat not showing up
+- Changed "Mr. Freeman" to "Dr. Freeman"
+- Fixed rare error in tables (like Follower Dialog)
+- Fixed and enabled workaround for some combining characters causing performance
+ issues (replacing more than two combining characters in a row with ****)
+
You can now customize hotkeys (regular, application-wide and global
+ hotkeys) that you can set to perform certain predefined actions and
+ any command (Global Hotkeys Windows only).
+
Improved character display, allowing potentially more characters to
+ be displayed (depending on what fallback fonts are available).
+
+
+
Important Information
+
+
If you were using a global commercial hotkey before, you will have
+ to redefine it when changing to this version (in the Settings - Hotkeys).
+
+
+
Full Changelog
+
+New features:
+- Added customizable hotkeys feature allowing you to add/remove/change hotkeys
+ in the settings (Global Hotkeys Windows only)
+- Added Stream Chat dialog (only regular messages, optional message timeout to
+ make them disappear after some time, mainly for testing right now)
+- Added support for global mods
+- Added $chan parameter to Custom Commands
+- Log to file: Added setting to customize timestamp (via setting commands)
+
+Changes:
+- Changed inputbox font to prevent bug where fallback fonts wouldn't work
+ properly in JTextPane
+- Changed default for "Restore dialogs" setting to "Restore dialogs from last
+ session" (only if you start from fresh settings)
+- Backup: Increased setting backup count to 5 backups
+- Changed staff usermode symbol to & (text symbol, not the badge)
+- Added scaling to emotes if the image is too big, set maximum size to 100x50
+- Improved setting commands (added add/remove commands for String lists, save
+ default for lists/maps), improved help for setting commands
+- Added "set:" commandline parameter to set any setting that can be set with the
+ /set command
+- Changed to new BTTV emotes API
+- Improved URL parsing a bit
+- Updated help
+
+Bugfixes:
+- Fixed Simple Title menu setting not being updated correctly
+- Set foreground color of Viewer History based on the current foreground color
+ of the dialog, so it fits the LAF
+- Set Notification foreground color to black, in case a LAF uses another color
+ that doesn't go well with the yellow background (Notification colors should be
+ customizable eventually)
+
Timeout users (and more) using keyboard shortcuts. Use the
+ User Selection Mode
+ (toggle with Ctrl-Space, then W/S and E to open
+ User Dialog) and the new keyboard shortcuts in the User Dialog for
+ quicker access to Timeout/Ban Buttons and Custom Commands you added.
+New features:
+- User Dialog Buttons (Timeout/Custom Commands) now support shortcuts, Ban and
+ Unban buttons are not hardcoded anymore and have to be added to the setting
+ (setting is automatically changed if you switch from a version before 0.7.2)
+- Added User/Line Selection feature to select a User in chat via the keyboard
+ so e.g. timeouts are possible completely via the keyboard
+- Added feature to modify Addressbook entries via a file
+- Added color restriction for Usericons
+- Highlight/Ignore: Added prefixes ("start:", "status:", "!status:", "!cat:",
+ "chanCat:", "!chanCat")
+- Channel Info Dialog now allows to be resized a lot smaller, Viewercount info
+ now adjusting better to smaller sizes
+- Added setting to change Look&Feel (only Default and System for now)
+- Added setting to attach dialogs to main window, so they always stay in the
+ same relative position when the main window is moved
+- Added some keyboard shortcuts
+- Added some support for FFZ feature friday, added /ffzGlobal command to show
+ global FFZ emote codes
+
+Changes:
+- Added menu entry to open login configuration for easier access (no need to
+ disconnect from chat)
+- Improved login configuration dialog
+- When login was determined invalid by automatic check: Changed warning message,
+ don't remove automatically anymore but let user do it if necessary
+- Added Options submenu to View menu to allow more options with direct access
+- Added more options to Title/Game Presets dialog due to S'ome demand
+- Logging to file now enabled by default (only if you start from fresh settings)
+- MOD/UNMOD messages are now disabled by default (from fresh settings)
+- Custom Commands executed from the Channel Context Menu now include the name
+ of the channel as first parameter (without leading #)
+- Some small improvements of labels/info texts in Settings Dialog
+- Increased join delay, increased delay between failed join attempts
+- Ping connection more often if inactive to detect disconnect quicker and
+ possibly prevent disconnect in some cases
+- Improved URL detection (again)
+- Improved debug messages a bit
+- Improved error catching in some places
+- Added more tests
+- Updated help
+
+Bugfixes:
+- Fixed URLs that don't have a protocol prefix (e.g. http://) being opened
+ without a prefix, which resulted in the browser not opening correctly
+- Fixed error in FrankerFaceZ emote parsing
+- Fixed bug where "Close to tray" wouldn't work without "Minimize to tray" being
+ enabled as well
+- Fixed layout problem in Settings Dialog when log path was too long
+- Use usercolor corrected for readability for colored /me messages
+
You can now add your favorite Twitch Emotes to the new Favorites
+ page of the Emote Dialog. Right-click on the emote you want to add to
+ open the context-menu and click on Favorite, then open the
+ Emote Dialog (Extra - Emoticons or Ctrl+E) and
+ choose the Favorites page to view your favorites.
+
+
Important Information
+
+
The default location to write stream information to has been changed
+ to the exported subfolder of the settings directory (so
+ e.g. C:\Users\name\.chatty\exported\). If you are using
+ this feature e.g. by refering to the created textfiles in your
+ streaming software, you'll have to adjust the path to the textfile
+ there.
+
+
+
Full Changelog
+
+
+New features:
+- Added Emoticon Favorites, that are displayed in the Emote Dialog (you can only
+ add Twitch Emotes for now, not FFZ or BTTV)
+- Added support for correct capitalization of names in chat (experimental, you
+ have to enable it in the settings if you want to try it)
+- Show correctly capitalized stream names in Live Streams/Channel Info Dialog
+ (independent of the Correctly Capitalized Names setting)
+- Added minimize to tray/close to tray options
+- Added setting for auto scroll down timeout length
+- Added setting to change font size of dialogs (experimental, only Userinfo now)
+- Added setting to customize chat log file location
+- Added context menu to Follower/Subscriber Dialog to export list to file
+- Added support for FrankerFaceZ global event emotes
+
+Changes:
+- Changed tray icon to only show when needed
+- Set proper tooltip for tray icon
+- Added some more timestamp options
+- Changed stream status writer output to "exported" subfolder of settings folder
+- Changed stream status writer to ignore case of stream name
+- Channel Info: Added approx. last stream length as tooltip to "Offline" text
+- Changed Twitch badges to use images instead of alpha (shows new colors now)
+- Changed base colors for badges to new Twitch colors (affects FFZ Mod Icon and
+ Fallback Icons)
+- Allow for selection of text in chat by double-clicking (focus to inputbox now
+ only on single-click on chat)
+- Detect a few more URL formats to be made clickable
+- Improved debug logging a bit (memory usage)
+- Some small improvements to memory usage
+- Added some more characters to Font Selection Dialog, but also an input field
+ to enter your own text to test the font
+- Catch the error if hotkey library couldn't be found and output warning instead
+- Updated help
+
+Bugfixes:
+- Fixed info messages sometimes going to the wrong window if popouts are used
+- Fixed subscriber sorting in userlist (but overall sorting can still be screwed
+ up sometimes)
+- Fixed wrong channel being joined when joining channel out of user context menu
+ with "Capitalize Names (First Letter)" option being enabled (fixed implicitly
+ by changing some stuff around for supporting capitalized names)
+- Added workaround for Twitch emotes appearing wrong on Retina displays
+- Nothing to do with Chatty in particular (it's the same for every IRC client),
+ but the "xy just subscribed" message should now work for everyone again,
+ because Twitch fixed it :)
+
Added Emoticon Dialog showing your Subscriber and Turbo emotes as
+ well as channel specific emotes.
+
Followers and Subscribers lists
+ showing your most recent followers and subscribers (you probably
+ need to request new login data with the necessary access for the
+ subscriber list to work).
Just a reminder: If you don't care about a correct userlist or joins/parts,
+ you may want to switch to Twitch Client Version 3 (Settings - Advanced),
+ which has a few advantages.
+ More information..
+
+
Full Changelog
+
+New features:
+- Added Emoticon Dialog, showing emotes you paid for (Subscriber/Turbo) and
+ channel-specific emotes (FFZ/BTTV)
+- Added Followers/Subscribers lists, added new follower sound (works only if
+ Followers Dialog is open)
+- Livestreamer: Added setting to use auth (for sub-only streams), added setting
+ whether to open the Livestreamer Dialog when opening a stream from the menu
+- Added setting to write stream info to a file (e.g. for display on stream)
+- Automatically request moderator list once per channel, added /fixMods command
+ to temporarily fix mods status without showing the list of all moderators
+- Added /host and /unhost commands
+- Added shortcut Ctrl-W to close active tab/restore popout to tab
+- Admin Dialog: Added option to automatically repeat commercial on the set delay
+- Added stream uptime to Channel Info Dialog (how long ago a stream was started)
+
+Changes:
+- Changed message parsing to support "<name> is now hosting you" notification
+ (only works on Twitch Client Version 3 though, see Settings - Advanced)
+- Added setting to specify the timezone of the timestamp seperately from the
+ system timezone setting
+- Added kadgar.net to open live streams from the context menu
+- Added optional filter to remove combining characters used in some languages
+ that may cause an error in some cases
+- Livestreamer: Reuse open tabs if process stopped and opening stream with the
+ same stream/quality, re-enable quality selection buttons if process stopped,
+ improved labels and help
+- Added more timestamp options in the settings and changed to showing as example
+- Added gzip support to Twitch API requests
+- Added check to confirm status of stream going offline, which may or may not
+ prevent wrong offline notifications if the Twitch API returns false data
+- Added hint about entering Twitch Commands in invalid command message
+- Updated help
+
+Bugfixes:
+- Fixed error in message parsing
+- Fixed display error with ban messages
+- Fixed a possible bug with notifications
+- Now showing "<number> /host commands remaining this half hour." message
+
Changed Game Select Dialog to using just one single list for both
+ the Game Favorites and the search result (to use the available space
+ more efficiently).
+
+
+
Full Changelog
+
+New features:
+- Added support for some of the BetterTTV emotes
+- Added feature to ignore indiviual emotes, which makes them not turn into an
+ image (but their code will still show up)
+- Changed game select dialog to one single list for favorites/search as to not
+ waste so much space
+- Added setting to change the livestreamer command (so you can also e.g. set the
+ full path to Livestreamer if necessary)
+- Added option to combine ban messages of the same user within 10 seconds, for
+ example "<name> has been banned from talking (3)" means banned 3 times
+- Added "/ab change" command to add/remove/toggle categories in a single command
+- Added /uptime command
+- Added /openUrl and /openUrlPrompt commands (for use in custom commands)
+- Added ignore setting to not show ignored messages info (count/nick) in chat if
+ the ignored messages dialog is currently open
+
+Changes:
+- Live Streams window always on top of main window (seems a bit flickery though)
+- More Dialogs now closeable with ESC
+- Added Ctrl+J shortcut for opening Join Dialog
+- Save Channel Favorites sort order between sessions
+- Increased number of saved lines per user from 20 to 100
+- Reorganized Settings Dialog a bit (Usericons/Emoticons on seperate pages)
+- Added context menu to Race Id (blue link) in Race Viewer
+- Possibly improved debugging of emoticon loading errors a bit
+- Updated help
+
+Bugfixes:
+- Search dialogs (Ctrl+F) fixed for popouts
+- Fixed error on update notification
+- Improved API response parsing a little bit
+- Fixed context menus in Highlights/Ignored Messages dialogs
+
Ignore chat messages by keyword,
+ username, addressbook category and channel, then choose whether to
+ completely hide them, show how many were ignored every 30s (if any)
+ or show which users where ignored. Ignored messages also get added
+ to a seperate window so you can check them if you want to.
+
Improved Update Notification.
+
Livestreamer context menu
+ quality selection customizable.
+
Improved Emoticon Context Menu (right-click on any emoticon image),
+ now allowing you to insert the emote code into your chat message by clicking the menu entry
+ showing the emote code (and added some more information and options
+ for subscriber emotes).
+
+
Important Information
+
+
Addressbook categories are now all lowercase. If you have any
+ categories that only use case to differentiate between them, this might
+ be a problem for you. Otherwise it should make things a bit clearer and
+ easier.
+
+
+
Full Changelog
+
+New features:
+- Ignore messages (similiar to the Highlight system, match messages by keywords,
+ usernames, addressbook categories and channels)
+- Improved Emote Context Menu (now with channel name on subemotes and clicking
+ on emote code inserts it in the input box)
+- Improved subscriber detection on Twitch Client 1
+- Improved Update Notification to now also show in the Main Menubar (clicking
+ on it opens a window showing the changelog)
+- Livestreamer Context Menu quality selection now customizable
+- Added some commands (including /ffz to show FFZ emotes of the current channel,
+ some commands to open dialogs and stuff intended for use in Custom Commands)
+
+Changes:
+- Addressbook categories are now all made lowercase when added/loaded from file
+- Regular commands can now be also used in Context Menus/User Dialog settings
+- Improved error handling a bit (hopefully)
+- Removed Ignore Joins/Parts setting in favor of Twitch Client 3
+- Changed Twitch Client 1/3 setting to include small explanation
+- Added sort by viewercount in Live Streams Dialog
+- Added chan: and !chan: prefixes (Highlights and Ignore)
+- Updated help
+- Show how many Highlighted/Ignored messages are in the dialogs in the View-menu
+- Improved text settings editor (auto adjust size when typing, added help)
+- Changed Context Menu/User Dialog settings to allow more flexible formatting
+ (linebreaks allowed, / for command optional, | for seperator doesn't have to
+ be directly in front of a command, but still applies to the following one)
+- Moved to new FFZ server and updated parsing (recently added emotes should now
+ show up)
+
+Bugfixes:
+- Fixed horizontal scrolling sometimes happening in chat window
+- Fixed URL Context Menu stream detection to be case-insensitive
+- Fixed display of "<" in Notifications
+- Hopefully fixed possible display error
+
Reworked usericon (badges) system to be more flexible and allow for
+ Custom Usericons.
+
Added Custom Commands,
+ allowing you to define aliases for anything you could also enter into
+ the inputbox manually (and also add those custom commands to the User/Channel
+ Context Menus and the User Dialog).
+
+
+
Full Changelog
+
+New features:
+- Reworked usericon (badges) system, which also allows custom usericons,
+ either replacing the default ones or adding some of your own
+- Added Custom Commands, which allow you to define aliases for anything you
+ can enter into the inputbox (like chat messages, commands)
+- Added settings to add Custom Commands to the User/Channel Context Menus and
+ changed Timeout buttons setting to also add Custom Commands to User Dialog
+- Added option to always show the chat scrollbar, which can be useful for
+ streamers who always want to capture the same subregion of the window
+- Added /clearchat command which clears all text from the current chat window
+- Added settings for what to do when Chatty is started (show connect dialog
+ or connect immediately and autjoin channels etc.)
+
+Changes:
+- Only show the "<user> has been banned from talking" message for users that
+ are currently known in the channel (that have said something, have joined,
+ been modded, etc.)
+- Removed hardcoded /slap command, but added it as default to Custom Commands
+- Removed "Set color" entry from User Context Menu, but added /setcolor
+ command (so it can be readded using Custom Commands if necessary)
+- Updated help
+- Changed list settings editor (used for Highlights, Logging, Commands)
+- Reorganized Settings Dialog a bit
+- Updated /testNotification command to also allow for a channel parameter
+- Changed Highlight Notification to switch to the channel the highlight
+ originated in (similiar to Stream Status Notifications)
+- Regular commands now case-insensitive
+- Handle image URLs which may brake due to possible changes in the Twitch API
+- Added /echo command to just output text as info message (e.g. for testing)
+
+Bugfixes:
+- Fixed speedrun.tv Race Link in SRL Race List context menu
+- Made "Races with.." search case-insensitive
+- Fixed possible flickering of chat window when being scrolled up
+- Remove linebreaks from messages send to the server
+- Fixed some possible display bugs in Settings Dialog
+- Right-clicking on emotes now works on the whole emote
+
Added Livestreamer support, with a dialog (Extra-menu)
+ and optional context menu entry.
+
+
+
Full Changelog
+
+New features:
+- Added SpeedrunsLive (SRL) race viewer
+- Added automatic settings file backup (copies settings to the /backup folder
+ when you start Chatty, at most once per day)
+- Added Livestreamer support (start Livestreamer out of dialog/context menus)
+- Added feature for unique addressbook categories under some circumstances
+- Added "Simple Title" setting to have only "Chatty" as title (Extra menu)
+
+Changes:
+- Improved debug logging (added append to current file, max file size, rotate
+ between several files when max file size is reached)
+- Improved scrolling when window is made smaller
+- Added small delay between joins, automatically rejoin if join failed, added
+ "Joining #channel.." message (which indicates a JOIN was send to the server)
+- Some smaller improvements
+- Added commands to open the current settings/working directory
+- Updated help
+
+Bugfixes:
+- Possibly maybe fixed bug with default userlist width, but it can still be a
+ bit finicky
+- Fixed bug in Channel Favorites dialog when table is empty
+- Fixed /myemotes command
+- Fixed bug when joining channel out of popout
+
Right-click on a tab to not only Close but also
+ Popout the channel.
+
Using the commercial hotkey now will simulate a click on the
+ 30s button if the Admin Dialog is open on the
+ Commercials tab.
+
+
+
Full Changelog
+
+New features:
+- Popout channels into their own window to be able to view them side-by-side
+- Added context menu and improved sorting to Channel Favorites dialog
+- Added check whether window restore position is actually on a screen (if not
+ then open on default position)
+- Added Highlight prefix to cutomize color for individual highlight items
+ (also added ordering buttons that can be necessary for this feature)
+- Added navigation buttons with page history to Help window
+- Added command to manually refresh emoticons (and badges if you rejoin)
+- Added command to show a list of your subemote codes (better emote
+ integration possibly maybe soon)
+- Added option to show action messages (/me) colored like in webchat
+
+Changes:
+- Commercials hotkey now simulates a click on the 30s button if the
+ Admin Dialog is open on the Commercials tab (so you can also use a delay)
+- Added more information to the emote context menu (unfortunately you have
+ to right-click on the left side of the emoticon to open it)
+- Changed default access options to all selected (you can still deselect them if
+ you don't need them and you think it's safer not having them on the token)
+- Decreased scrolling step a bit
+- Improved scroll detection for scrolled up timeout
+- Improved main window title change responsiveness
+- Some small improvements
+- Reorganized and updated help
+
+Bugfixes:
+- Fixed some possible errors by adding some checks
+- Fixed bug when adding a usercolor (not correctly enabled Done button)
+- Fixed bug canceling the list item edit dialog (highlights/logging)
+
The port setting has changed. If you have changed the port setting
+ to another value before, it will be reverted to the new default with
+ this update.
+
With the introduction of group chat, Twitch apparently removed the
+ "xy just subscribed" messages from the chat version Chatty uses. There
+ was also a new version introduced that still has those messages and is
+ generally better (association of bans/info messages/subscribers to
+ channels), but it lacks joins/parts, which means no joins/parts can be
+ shown and the userlist will only contain those people who have said
+ something.
+
+ If you don't care about showing joins/parts and you don't care about
+ a correct/complete userlist, then it may be beneficial for you to
+ enable the Chat Client Version 3 option in the Settings
+ Dialog under Advanced. More information..
+
+
Full Changelog
+
+New features:
+- Admin Dialog: Select previously used or favorited stream status (title/game)
+ from the presets dialog for your title changing convenience
+- Optional new chat version that has no joins/parts but has better channel
+ association for bans/timeouts/subscribers and "xy just subscribed" message
+- Added /slap command due to S'ome demand
+- Improved connecting to chat (automatically trying different servers/ports)
+- Added more shortcuts and stuff
+- Added option to rejoin currently open channels when connecting
+
+Changes:
+- Moved Ignore joins/parts option to settings dialog
+- Some small improvements
+- Updated help
+
+Bugfixes:
+- Hopefully fixed synchronization error
+- Fixed error when editing game favorites
+- Fixed error when no stream title is set
+
+New features:
+- Added Addressbook to associate name with categories, that can be referenced
+ from usercolor settings and highlight settings
+- Added usercolor settings to locally assign custom usercolors
+- Option to restore dialog positions/reopen dialogs on start
+
+Changes:
+- Improved setting for timeout buttons/added to GUI, improved timeout messages
+- Highlight: Default username now matching on word bounds, added word bounds
+ matching prefixes, added highlight next messages
+- Reorganized settings dialog to accomondate new settings/features
+- Updated help
+- Parse /mods response to make users mods
+- Improved Named Colors panel in color chooser
+- Added Ctrl-Shift-Tab to switch to previous channel
+- Added server/port settings
+- Added setting to enable/disable stream status messages in chat
+
+Bugfixes:
+- Fixed FrankerFaceZ mod icon parsing to reflect recent changes
+- Fixed parsing error
+- Fixed userstats max length
+- Added scrolling to "Removed Streams.." list
+
The sound volume values have been changed, you should readjust the
+ volumes when you use this feature.
+
Chatlog is disabled by default, enable it in the settings if you
+ want to use it.
+
+
Full Changelog
+
+New features:
+- New more flexible notifications that replace the system tray notifications
+ (you can still switch back to them though)
+- Added chat logging to record messages and stream/chat infos to file
+- Added Spam Protection
+- Admin Dialog: Relative times, use own channel when no channel is joined,
+ last commercial run time, improved several channels support, dialog
+ not modal anymore, configurable commercial run delay, added help
+- Added message sound, load sound file names from sounds folder, improved
+ sound settings, changed volume values (you may need to adjust your volumes)
+- Check if connection was lost a bit faster depending on previous activity
+- Added new error dialog
+- Show important release information on first startup of new version
+
+Changes:
+- Changed shutdown process
+- Improved settings dialog (help, icons, components, restart required
+ warning)
+- Remove additional whitespace from incoming messages
+- Replace some special html character codes in incoming messages
+- Default userlist width setting, userlist width 0 now possible
+- Always output stream status on join (not only if it's new)
+- Improved help
+- Added setting to enable (and thus disable) open url prompts
+- Added Copy URL option to url prompt
+- Added setting to highlight own messages (always enabled before)
+- Added setting to change the tabs order (join order/alphabetical)
+- Added context menu item to clear the highlights dialog
+- Fixed bug in ViewerHistory when item was still hovered when channel
+ was changed
+- Added help window icon
+- Count number of mods on /mods-command response
+- Prevent auto-scrolling when search is active
+- Added speedrun.tv option for stream urls
+
Changes:
+- FrankerFaceZ: Show custom mod icons (available in some channels)
+- FrankerFaceZ settings, Emoticons/Icon settings seperate
+- Prevent dialogs that can open automatically (error messages) from
+ stealing focus
+- Added chat buffer size setting
+- Added setting to enable/disable mod/unmod messages
+- Added some shortcuts
+- Added command to show working directory
+- Added color preset
+- Improved help
+- Improved viewer history (fixed times per channel)
+- Improved debug output
+- Added command/guide in case getting login data doesn't work
+
+Bugfixes:
+- Fixed error in Viewer history
+
With Version 0.5, Chatty can notify you about streams you follow and
+ show a list of them. You have to request
+ new login data containing <Read user info> access to
+ be able to use that. Go to
+ <Main - Connect - Configure login..>, remove the
+ login and request it again.
+
You can enable/disable this feature under
+ <Main - Settings - Notifications> if you have the
+ necessary access.
+
+
Full Changelog
+
+New features:
+- Get notified when streams you follow go online (requires
+ <Read user info> access, which wasn't even in Chatty before, so you'll
+ have to request new login data)
+- View a list of live streams (you followed or whose channel you are in)
+- FrankerFaceZ emoticons
+- Added search, allowing you to find text in the current chat window
+- Deleted messages (from timeouts/bans) now get shortened to a maximum length,
+ or you can use the previous behaviour or let the whole message be replaced
+ with <message deleted>
+- Change the displayed time range in Viewer History
+- Automatically check if the login is valid, if it is suspected not to be
+- Clickable links in Channel Info Dialog (also turns #srl-abcd into a race link)
+- Cycle between tabs with Ctrl+TAB
+
+Changes:
+- Updated Help
+- Changed Settings Dialog Layout
+- Detect subscribers even when in more than one channel (may not work correctly
+ always, but it's a better guess than before)
+
+Bugfixes:
+- Changed color of inputbox cursor to foreground color
+- Possibly made emoticon image loading a bit more reliable, but it's hard to
+ tell what happens when the loading fails
+- Handle long URLs in the URL open dialog better
+
+New features:
+- Added version checker to inform you about new versions of Chatty
+- Added window icon
+- Added colors to viewer history to indicate stream status changes, hovering
+ displays stream title/game at that time (in addition to viewercount/time)
+- Stream information is now requested for all channels you have currently joined
+- Added tray notifications for highlighted messages and stream status changes
+- Added sound notifications for highlighted messages and stream status changes
+- Added some commandline parameters, settings and context menu entries
+
+Changes:
+- Nicks in JOIN/PART/MOD/UNMOD lines now clickable
+- Settings now saved in seperate files for general settings, login data and
+ history/favorites
+- Fixed tab colors, added indicator for new stream status
+- Added delay for global hotkey so it doesn't repeat as much if kept pressed
+- Updated and improved help
+- Added Mod/Unmod buttons to user dialog (only in your own channel)
+
+Bugfixes:
+- Fixed bug where a status change could reopen a tab that couldn't be closed
+- Improved error handling for API responses
+- Fixed bug where focus sometimes wouldn't be on inputbox when changing tabs or
+ clicking in channel
+
+New features:
+- Added Admin Dialog that let's you change the title/game of your stream
+ and run commercials (optional global hotkey for running commercials)
+- Added Channel Favorites/History that automatically saves channels you joined
+ and also allows you to add favorites (history can be deactivated in the
+ settings)
+- Added Highlight system that makes a message appear in another color if defined
+ keywords are found in it and/or it was send by a defined user (defaults to
+ always highlight your own name)
+- Added join dialog
+- Messages from user "twitchnotify" as info messages (when someone subscribed)
+- Added Warning when joining more than one channel
+- Added context menus for nicks/links/channel/tabs
+- Restore window position from last session
+- Better debugging and error handling
+- Automatically scroll down after 30s of inactivity when being scrolled up
+
+Changes:
+- User Info Dialog: Auto-update message history, show bans, show channel context
+- Lowered stream info (title, game, viewercount) update delay to 120s
+- Improved default user colors
+- Emoticons that contain only word characters match at word boundaries (to match
+ the new behaviour in Twitch Webchat)
+
+New settings:
+- Option for capitalized names
+- Option to show ban message (.. has been banned from talking), defaults to not
+ showing it
+- Color GUI settings (with default and dark preset)
+- And of course quite a few for the new features/bugfixes
+
+Bugfixes:
+- Fixed bug where channels would re-open without being
+ able to close them
+- Fixed bug where the userlist wasn't loaded correctly on join
+ when the channel was joined before in the same session
+- Disabled Direct3D Hardware Acceleration by default to possibly
+ fix Chatty appearing completely black under certain circumstances
+
+
+
First published version was 0.2 so changelog starts from version 0.3.
There are a couple of commands that allow you to change settings from
+ the chat inputbox. (You should probably roughly know what you're doing
+ before using these.)
The following are settings that can be changed using the setting commands.
+ A lot of those - but not all - can also be changed in the Settings Dialog,
+ which is more convient in some cases. This does not show all settings.
Settings with a slightly darker background color
+ are settings that are not available in the Settings Dialog and can only be
+ changed via commands (and sometimes also commandline options).
The font for the chat input box (should only be set to
+ Java logical fonts like Dialog or
+ Monospaced, otherwise fallback fonts in
+ chat may not work correctly*)
+
+
+
dialogFontSize
+
Integer
+
Font size or -1 to keep default
+
-1
+
Setting to customize the font size of dialogs, currently
+ experimentel and only for User Info Dialog.
+
+
+
+
* If a character isn't contained in the chat font you have
+ currently configured, Java will try to find it in the fallback
+ fonts. While still not all characters will be displayed this way, it
+ should work a lot better. You can also add your own fallback fonts
+ to improve the situation further. However, setting the input box
+ font to your chat font somehow breaks the fallback font mechanism,
+ resulting in less characters being able to be displayed (like in
+ versions before 0.7.3).
Default server to connect to, which can be changed in
+ the Settings Dialog and is saved between sessions
+
+
+
portDefault
+
String
+
One or more ports, seperated by comma
+
6667,80
+
Default port to connect to, which can be changed in the
+ Settings Dialog and is saved between sessions
+
+
+
server
+
String
+
The server address, host or IP
+
empty
+
If set, overrides the defaultServer, can be
+ set by commandline options, not saved in between sessions
+
+
+
port
+
String
+
One or more ports, seperated by comma
+
empty
+
If set, overrides the defaultPort, can be
+ set by commandline options, not saved in between sessions
+
+
+
username
+
String
+
Your username
+
empty
+
Public part of the Login data
+ to login into chat
+
+
+
token
+
String
+
OAuth token
+
empty
+
Secret part of the Login data
+ to authorize with Twitch, don't show this to anyone. You
+ shouldn't change this directly, but use the /changetoken
+ command instead when manually setting the token.
+
+
+
spamProtection
+
String
+
messages/seconds, e.g. 10/20
+
18/30
+
How many messages Chatty allows you to send to the server
+ in the given time, to prevent a ban from chat
+
+
+
membershipEnabled
+
Boolean
+
true
+
Refers to the twitch.tv/membership IRCv3 CAP, which
+ enables sending a userlist and joins/parts, allowing for a
+ correct userlist in Chatty and showing of joins/parts in chat
+ (if separately enabled of course)
Forwards messages from the given channels to
+ Stream Chat.
+
+
+
streamChatMessageTimeout
+
Integer
+
Number of seconds, negative to disable
+
-1
+
How long messages are displayed before they disappear
+ from Stream Chat.
+
+
+
streamChatBottom
+
Boolean
+
true
+
Start inserting messages at the bottom. Messages are
+ always inserted below previous messages, but disabling this setting
+ will make them start at the top. Requires a
+ restart of Chatty after changing to take any effect.
+
+
+
streamChatResizable
+
Boolean
+
true
+
Whether the Stream Chat dialog is resizable by dragging
+ the edges.
Allows moderators in the given channel to run the
+ !addStreamHighlight command.
+
+
+
streamHighlightChannelRespond
+
Boolean
+
false
+
If this is enabled, Chatty sends a message to chat when
+ a moderator uses the !addStreamHighlight command. Otherwise
+ the response to the command is only shown locally.
+
+
+
streamHighlightCommand
+
String
+
The command to use for moderators
+
!addstreamhighlight
+
Change this to define the command that can be used by
+ mods to add stream highlights in the channel defined with
+ the streamHighlightChannel setting.
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.
Change font and font size by clicking on Select font.
+
+
Startup
+
You can select what will happen when you start Chatty:
+
+
Do nothing - Just do nothing special
+
Open connect dialog - Open dialog to connect
+
Connect and join specified channels - Connect
+ immediately and join the channels specified in the field below. You can
+ define several channels by seperating them with a comma.
+
Connect and join previously open channels - Connect
+ immediately and join the channels you had open when you closed Chatty.
+
Connect and join favorited channels - Connect
+ immediately and join the channels that are favorited in the Channel
+ Favorites/History dialog.
This allows you to define how timeouts or bans are displayed in Chatty.
+
+
There are three options for deleted messages:
+
Delete Message completely replaces the message with
+ <message deleted>.
+
Strike through will keep the whole message displayed, but
+ crossed out.
+
Strike through, shorten is same as the previous one, but
+ it will also shorten the message to the defined number of characters, so long
+ spam messages don't take as much space, but can mostly still be identified what
+ they were about. Shortened messages are indicated by the points at the end
+ that are not crossed out (e.g. Deleted spam message Long copy pas..).
+
+
Show ban messages: In addition to handling the deleted
+ message, Chatty can also show a message like
+ <name> has been banned from talking once the timeout
+ or ban is issued.
+
Combine ban messages: Chatty can combine ban messages,
+ which means if several bans/timeouts are issued for the same user within 10
+ seconds, only one message is shown for them, with the number of bans shown
+ after the message, e.g. <name> has been banned from talking (3).
+ Ban messages are not combined if a new message from the banned user was
+ received in the meantime.
+
+
+
+
Other
+
+
Timestamp: Whether to show a timestamp in front of
+ chat messages and what format it should have. If you want a different
+ format from the ones provided here, you can use the command
+ /set timestamp <format>. The format can be anything
+ specified by the Java
+ SimpleDateFormat
+ class.
+
Show mod/unmod messages: Whether to show the MOD/UNMOD
+ messages as they come in from Twitch Chat (which are used to show the
+ moderator badge). These messages can be sometimes
+ be kind of broken (on Twitch's side) and can show some or all mods in the channel
+ as being modded/unmodded.
+
Show joins/parts (TC1 only): Show joins/parts, which
+ only works on TC1 (more information). Joins/parts
+ are always kind of delayed, so don't take them too seriously.
+
Show stream status in chat outputs the stream status
+ (title and game) in the chat window on join and when it changes
+ (when the stream goes offline or online or changes the title or game).
+
/me messages colored: Show action messages colored
+ like in webchat.
+
Filter combining characters: Replaces certain ranges of
+ Unicode characters. Those characters are used in some
+ languages to combine characters, but can apparently cause errors in some
+ cases. The filter applies to the main chat window and the recent messages
+ in the User Info Dialog (but not e.g. the chatlog written to file).
+
+
Off - Do nothing
+
Lenient - Replaces at least 3 characters in a row with stars (****), which preserves some legitimate use
+
Strict - Replaces any number of characters in a row with stars (****), use this if you have performance
+ problems when someone posts these kind of characters
Names in Twitch Chat are send all-lowercase by default, however there is
+ an IRCv3 tag send with each message with the display name which Chatty
+ can use to show correct capitalization. You have the following settings:
+
+
Capitalized Names (First Letter) simply makes the
+ first letter of names uppercase. This will be correct for many names,
+ but by far not for all (names might have capital letters in the middle
+ or be all-lowercase). You can enable this if you simply prefer it this
+ way.
+
Correctly Capitalized Names uses the capitalization
+ send in the IRCv3 tag with each message and should be what the user
+ configured. In very rare cases the display nick may differ more than the
+ capitalization. This is enabled by default.
+
+
+
The previous function that requested correctly capitalized names from the
+ Twitch API has been removed. This also means that the associated commands
+ (/refreshCase, /setCase and /getCase)
+ have been removed as well. If you want to customize the capitalization of someone else's
+ name locally, you can now use the Custom Names feature.
+ The names in the userlist will not be correctly capitalized until Chatty has
+ received a message from that user during this session.
Show emoticons: Shows emoticons as images instead
+ of just the text
+
Enable BetterTTV Emotes: Shows some of the BetterTTV emotes.
+ Requires a restart to take effect when you change it.
+
Enable FrankerFaceZ (FFZ): Downloads FrankerFaceZ
+ emotes and Mod Icons (where available). Requires a restart to take
+ effect when you change it.
+
Enable FFZ Mod Icon: Show the FFZ Mod Icon instead of the regular
+ Mod Icon (where available). Requires FrankerFaceZ setting to be enabled.
+
Scale: 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).
+
+
+
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.
Show Usericons: Shows badges as images instead of
+ just text
+
Enable Custom Usericons: Use the custom icons
+ defined in the table below
+
Enable Bot Badge: Enables showing of the bot badge
+ for known bots. Chatty shows a single bot badge for all known bots. The
+ list of bot names comes from different sources: The botNames
+ setting, the BTTV API and the FFZ API.
+
+
BTTV: Use botnames from the BTTV API
+
FFZ: Use botnames from the FFZ API
+
+
+
+
+
Custom Usericons
+
By adding entries to the table you can either replace the default icons (Mod, Turbo, Subscriber, ..)
+ or add additional icons for certain users or addressbook categories. The order
+ of the entries can matter, they are matched from the top, so if more than one
+ icon matches that is supposed to replace a default icon, then the first one
+ is used. If more than one Addon icon matches, then all are used
+ (unless you use the $stop restriction, see section Restriction below).
+
+
You have the following options when you add/edit an item:
+
+
Type
+
The type determines whether a default icon will be replaced
+ (if you choose Moderator, Subscriber, Turbo, ..) or if
+ it should be an additional icon added after the default ones (Addon).
+ Currently, you can have as many Addon-Icons as you want and they are
+ all displayed at once (if they match the requirements of course).
+
+
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 for Addon
+ icons:
+
+
$stop means if this icon matches (and is thus used),
+ it stops searching for further Addon icons. 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 Addon icons.
+
$first puts this Addon icon before
+ the regular icons. The $stop restriction only
+ applies to one group of Addon icons separately
+ (before or after the regular icons).
+
+
+
Examples: $cat:streamer $first, lotsofs
+
+
Channel
+
This is another requirement that also has to be met in order for the
+ icon to be displayed. You can entere 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 file to use for the icon. Must be a .png and
+ should usually be about 18x18 pixels (because that is the size of the
+ default icons). The image files are looked for in the /img
+ subfolder of the working directory (similiar to the /sounds
+ folder). You can click on Image Folder to show information
+ about it and rescan it to update the list of images in the dropdown menu.
+
You can add the special Image File name $ffz which will
+ make it use a FrankerFaceZ icon for that, if available (this only really
+ applies if you use the TypeModerator and want to
+ replace the moderator icon in all channels execept the ones that have a
+ FFZ Mod Icon).
+
You should also be able to specify the full path to an image, if you
+ don't want to use the dedicated image folder. A filename starting with
+ http is interpreted as URL.
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):
+
+
$mod - Moderators
+
$sub - Subscribers
+
$turbo - Turbo Users
+
$admin - Admins
+
$staff - Staff members
+
$all - All users, this can be used to specify a default
+ color (should be put at the very end of the list)
#<color code> - A Html color code, e.g. #0000FF for 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:Blue for 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 $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.
Enable Highlight: Determines whether highlighting
+ is enabled at all.
+
Highlight own name: Makes messages that contain your
+ own name (case-insensitive) highlighted, even if you didn't add it to the list manually.
+
Highlight follow-up: After a highlighted message,
+ also highlight the following messages of the same user for a certain time.
+
Check own text for highlights: Highlights your own messages if
+ they match the criteria, which can be particularly useful to test whether your terms
+ are being matched correctly. This does not mean that all your own messages
+ are automatically highlighted, they still have to match one of the items
+ added to the list. To match all your own messages you can use the user:
+ prefix with your own name.
+
Check ignored messages: Only checks ignored messages
+ for highlights if this is enabled.
+
+
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.
+
+
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.
+
+
cs: makes it case-sensitive, so cs:test
+ matches test but not Test.
+
w: matches at word boundaries, e.g. w:anna
+ will match anna or Anna: but not
+ Hannah or annah. (Is actually just a
+ shortcut for a special regex, so special regex characters will work.)
+
wcs: is the same as w:, but case-sensitive.
+
start: to match at the start, so start:!bet will
+ match messages starting with !bet.
+
re: to use a regular expression, e.g. re:(?i).*\bGTA ?[V5]\b.*
+ to match GTA5, GTA 5, GTA V, gta5, .. (as a word) anywhere in the message. Note
+ that the regex always tries to match the entire message, so you have to
+ add the appropriate wildcards to match parts anywhere in the message.
+
+
+
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.
+
+
user: to specifiy one exact username (case-insensitive)
+ which should highlight only if this user send the message, doesn't
+ search in the message itself.
+
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-seperated
+ 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):
+
+
m Moderator
+
s Subscriber
+
a Admin
+
f Staff
+
b Broadcaster
+
t Turbo User
+
g Global Moderator
+
r Bot as in Robot (depending on what the FFZ/BTTV APIs provides (if
+ enabled) and values in the botNames setting)
+
M User with any kind of moderator/special powers
+ (so Broadcaster/Moderator/Global Moderator/Admin/Staff combined)
+
+ For example: status:st matches
+ 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:stM matches all 'normal' users that have no
+ badge by default (NOT a Subscriber, Turbo User or any kind of Moderator).
+
color: to specify a color other than the default one
+ for displaying this highlight. If you have items with a custom
+ color defined, which match something that might also be matched
+ by other items (with another color or custom color)
+ then the order of items is important so it displays the desired color.
+ Items on the top are matched first, so move items up that should take
+ precedence. For example test and
+ color:blue test2. If test is on the top
+ it will never get to the blue one, because test will
+ always match when test2 would match as well.
+
config: to specify one or more options (seperated
+ by comma) that changes the behaviour):
+
+
silent - Disable sounds for this item
+
!notify - Disable notifications for this item
+
info - This item applies to info messages instead
+ of regular user messages (works only for Ignoring messages at the
+ moment)
+
+
+
+
Examples
+
+
word1 word2
+
Matches e.g. word1 word2, Word1 word2 anywhere in the message
+
Does NOT match only word1 or only word2 anywhere in the message
+
(Each item represents one word or phrase to match as a whole)
+
+
w:anna
+
Matches e.g. Anna?, Anna :D, Anna,
+
Does NOT match Wanna?, Hannah, annah
+
(Match on word boundaries to prevent undesired matches)
+
+
user:joshimuz cs:Hello
+
Matches Hello anywhere in the message, if the message was sent
+ by the user named joshimuz
+
Does NOT match hello
+
(Combine a Meta Prefix (user-specific highlighting) and a Text Matching Prefix (case-sensitive))
+
+
cs:Hello user:joshimuz
+
Matches Hello user:joshimuz anywhere in the message
+
Does NOT match Hello, does NOT matter who send the message
+
(Anything after a Text Matching Prefix is interpreted as text to match, Meta Prefixes must be placed
+ in front of the text)
+
+
cs:abc re:\w+
+
Matches abc re:\w+ anywhere in the message
+
Does NOT match abc test, but also NOT Abc re:\w+
+
(Can't combine Text Matching Prefixes)
+
+
re:abc \w+
+
Matches e.g. abc test
+
Does NOT match aabc test
+
(All Text Matching prefixes can also be replaced by regex)
+
+
re:.*abc \w+.*
+
Matches e.g. abc test anywhere in the message
+
(Regex has to match the whole message, so you need to add wildcards to match anywhere in the message)
+
+
color:yellow wcs:S
+
Matches e.g. S:, Hello S! and makes the message
+ display in yellow color
+
Does NOT match s:, Hello s!, SSSS, ssss
+
(Define a custom color for this item and match case-sensitive on word boundaries)
+
+
chan:lotsofs,joshimuz cs:Hello
+
Highlight messages that contain Hello, but only if in
+ the channel #lotsofs or #joshimuz
+
(Restrict matching to one or more channels)
+
+
status:s chanCat:vip start:!test
+
Match any message starting with !test send by
+ subscribers of the channel, but only if the channel is in the
+ Addressbook category vip (e.g.
+ /ab add #joshimuz vip, notice the leading #)
+
(Restrict matching by user status, channel category and start of message)
Ignores chat messages, either because they match the specified text or -
+ using prefix - other properties like which user wrote the message. 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:
+
+
user:name
+
Ignores the user with the name name in all channels
+
+
user:name chan:tirean,gocnak
+
Ignores the user with the name name in channels #tirean and #gocnak
+
+
config:info subscribed to
+
Ignores the x has subscribed to y info messages that
+ you get when someone subscribes in the channel that is being hosted
+
+
cat:ignore !chan:lotsofs,joshimuz
+
Ignores users in the addressbook category ignore in all channels,
+ except #lotsofs and #joshimuz
+
+
chan:joshimuz re:!bet.*
+
Ignores messages starting with !bet, but only in #joshimuz
+
+
!status:smb chanCat:subonly
+
Ignores any message send by users that are not a subscriber, moderator
+ or broadcaster of the channel, but only if the channel is in the Addressbook
+ category subonly (e.g. /ab add #joshimuz subonly,
+ notice the leading #)
+
+
+
General Options
+
+
Enable Ignore: Enable/disable the Ignore System
+ altogether
+
Ignore own messages: Also ignore own messages (if
+ they match), can be useful for testing
+
What should happen with ignored messages:
+
+
Hide: Don't show ignored messages in chat
+ at all (they still get added to the Ignored dialog)
+
Show count: Shows the number of ignored messages
+ in chat every 30s (if there were any), so you know that messages
+ were ignored
+
Show names: Shows the name of the sender of
+ any ignored messages, in a list similiar to MOD/UNMOD or JOIN/PART
+ messages
+
+
+
Only show if ignored messages dialog is not open:
+ Only show what is configured for "What should happen with ignored messages"
+ when the ignored messages dialog isn't currently open.
You can enable or disable all sounds here. Sounds are searched in the
+ displayed folder, which is the current working directory. Any valid sound
+ files in the folder should be selectable as a sound to be played. If you
+ added or removed files, you may have to use Rescan folder to
+ make the files show up in the list. You can open the folder in your standard
+ file browser from here to add files to it more quickly.
+
+
Sound Types Settings
+
You can specify requirements, soundfile, volume and delay for
+ different types of events:
+
+
When a message is highlighted
+
When a stream changes status (online/offline/changed title/changed game)
+
When any message in received in any open channel
+
When someone joins/leaves any open channel
+
When a new follower is detected (this only works if the Follower
+ Dialog is currently open)
+
+
You can set a delay (seconds) so that the same sound won't be played twice during
+ the set number of seconds. So if e.g. 3 highlighted messages come in within
+ 10 seconds and the delay is set to 15 seconds, only one sound will be played.
+
+
Each sound has different options for when the sound should be played. See
+ the Notification Settings for help on the options.
You can show notifications for two kinds of things:
+
+
Highlights - When a message in chat is highlighted
+
Stream Status - When a stream changes status, e.g.
+ offline -> online or changed title
+
+
+
For both these you can select separately if and when they are shown:
+
+
Off - Never show
+
When channel/app not active - Only when the channel
+ isn't the currently selected tab AND when the program doesn't have focus
+
When channel or app not active - Only when the channel
+ isn't the currently selected tab OR when the program doesn't have focus
+
When app not active - Only when the program doesn't
+ have focus
+
When channel not active - Only when the channel
+ isn't the currently selected tab
+
When channel active - Only when the channel IS the
+ currently selected tab
+
Always - No requirements, always show it
+
+
+
In addition, the option Don't notify about "Stream offline" allows you
+ to never show when a stream changes status to offline, so you will only be
+ notified about streams going live or changing title/game.
+
+
Notification Type / Options
+
Select here whether to use the Chatty Notifications or the default
+ System Tray Notifications. This settings DOES NOT enable or
+ disable notifications altogether, just switch between the types.
+
If you have Chatty Notifications selected, you can change some
+ more options:
+
+
Position: In which corner the the notification appears on the screen
+
Screen: On which screen the notification appears (auto means
+ it's on the same screen as the Chatty window)
+
Display Time: How long the notification will be displayed
+ by default. This can vary a bit depending on the situation.
+
No User Activity: This is a tricky one. If you enable
+ this, then the notification will not be closed after the defined Display Time
+ if no activity was detected in the last few seconds. This can be useful
+ to still see notifications from a few minutes ago if you were away from
+ the computer.
+ The time defines
+ when the notification will be closed no
+ matter what, so older notifications won't stay there forever if you are
+ away from the computer for a bit longer.
+
Activity is tracked through two methods:
+ The first method is tracking the system-wide mouse movements, which is
+ done through an API that may not always return accurate information
+ (e.g. if you are in a game) and it only checks the position every few
+ seconds (only the last location is saved at any time for comparison).
+ The second method detects activity only inside of Chatty, by tracking
+ button presses and mouse actions (e.g. if you type a message, open a
+ dialog etc.).
+
+
+
Followed Streams
+
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.
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:
+
+
always - Log all channels without exception (default)
+
blacklist - Log all channels, except the ones on
+ the blacklist
+
whitelist - Log no channels, except the ones on the
+ whitelist
+
off - Log no channels whatsoever
+
+
+
Messages Types
+
Normal chat messages are always logged, however you can log additional
+ information:
+
+
Chat Info refers to general chat releated info messages
+ like connecting/disconnecting/trying to timeout someone/stream title..
+
Bans/Timeouts refers to bans/timeouts in chat, which
+ will be logged like this: [12:32:25] BAN: name, name2
+
Mod/Unmod refers to when someone in chat is modded/
+ unmodded, which will be logged like this: [12:32:25] MOD: name1, name2
+
Joins/Parts refers to when someone joins/parts the
+ channel, which will be logged like this: [12:32:25] JOIN: name1, name2
+
System Info means any info messages that are related
+ more to Chatty than chat itself, like info about new versions, if you use
+ settings commands..
+
Viewerstats are stats about the viewercount which
+ are logged in a semi-regular interval to give some idea about the viewercount
+ during that time. It 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, e.g.
+ [21:06:21] Viewerstats (21:03-21:06): avg:28.612 min:28.432 max:28.887 [3/28.519-87+455_]).
+
Viewercount will log the viewercount as it is updated,
+ like this: [15:23:58] VIEWERS: 12521
Open dialogs in default location: Always
+ open dialogs in their default location (centered on the main
+ window) when you open them.
+
Keep location during session: Puts dialogs
+ at the same position when you reopen them during the same
+ session (so they are put on the default location when you open
+ them the first time after starting Chatty).
+
Restore dialogs from last session: Puts
+ dialogs at the same position they were at when you closed Chatty
+ last session and also keeps the position during the session.
+
Reopen dialogs from last session: Reopens
+ any dialogs that were open when you closed Chatty last session
+ and also puts them at the same position they were before.
+
+
+
Attach dialogs position to main window: If enabled,
+ moves the dialogs like Channel Info or Admin Dialog along with the
+ main window, so they always keep the same relative position. You can
+ still move the dialogs by themselves of course.
+
+
+
Other
+
+
Open URL Prompt: Enable this to be asked
+ when opening a URL. Even if this is disabled, you may still asked on
+ some occasions, but not for URLs in chat.
+
Always show chat scrollbar: Always show the vertical
+ scrollbar in the chat window (there should never be a horizontal one),
+ even if no scrolling is necessary. This can be useful for using window
+ capture for streaming, because you can always keep the same subregion.
+
Minimize to tray: When minimizing the main Chatty
+ window, it will be minimized to tray.
+
Close to tray: Closing the main Chatty window will
+ not actually exit the program, but instead minimize it to tray. You can
+ actually close the program via Main - Exit or the tray icon
+ context menu.
+
Tab Order: Whether to show tabs in the order they
+ were opened or alphabetically.
+
Default Userlist Width: The default width of the
+ userlist in pixels.
+
+
+
+
Popout
+
+
Restore location/size: When you close a popout
+ window then it's location/size is saved and used for the next popout
+ window that is opened. Each saved location/size is only used once, if
+ there is none left then the default attributes are used. This is also
+ saved between sessions (attributes of popouts that are open when you
+ close Chatty are saved as well).
+
Close popout when only channel: When you have a
+ channel popout window open and close the last channel in the main window,
+ then the popout window will automatically be closed and the channel
+ moved to the main window. Disable this if the popout shouldn't be closed
+ automatically.
Custom commands allow you to specify aliases for anything you could also
+ enter directly into the inputbox (like chat messages or regular commands),
+ with the exception of other custom commands, which is a limitation
+ implemented to prevent infinite loops. Custom commands you add should be in
+ the following format:
+
+
/<commandName> <what the command should do>
+
+
Everything until the first space is the name of the comand, and everything
+ after the first space is the text of the command. For example:
+
+
/hello Hello World!
+
+
If you added that to the custom commands and enter /hello
+ in the inputbox, then it would send Hello World!, just as
+ if you would have written it yourself and pressed Enter.
+
+
Custom Command Parameters
+
You can also specify parameters in the command text, which will be replaced
+ when you execute the custom command. For example:
+
/permit !permit $$1
+
When you enter /permit name, then it will replace $$1
+ with the first word after the command, which in this case would be
+ name, making the actually send text !permit name.
+
+
This is the syntax for specifying parameters (word in this context means
+ anything seperated by a space):
+
+
$1, $2, $3
+
First word, second word, third word etc.
+
+
$1-
+
First word, and all the words after it
+
Equivalently $2-, $3- etc.
+
+
$$1
+
First word, but required, meaning the command result will only be
+ send if all the required commands are actually there
+
Equivalently $$2, $$3- is also possible
+
+
\$1-
+
Escape any special character (like $) by prepending a backslash
+ \, which means this won't be interpreted as a parameter
+ and not be replaced
+
If you actually want to use \, you can escape the
+ backslash itself, for example \\$1- will be replaced
+ (leaving one backslash in front of the replaced parameter)
In a context other than entering the command in the inputbox, there are
+ some predefined parameters. For example if you add a command as a context
+ menu entry (see next section), then clicking that entry will execute the
+ command while automatically adding an appropriate parameter.
+
+
So you can for example add just /Permit to the menu, but
+ the custom command /permit !permit $$1 will actually be
+ executed as !permit <name of the user>.
+
+
+
Context
+
Parameters
+
+
+
All
+
$chan - the currently active channel (without leading #)
+
+
+
User Context Menu
+
$1 - name of the user
+
+
+
User Dialog
+
$1 - name of the user
+
+
+
Channel Context menu
+
$1 - name of the currently active channel (without leading #)
You can add custom commands and regular commands to the User Context Menu (when you right-click
+ on a user in chat), the Channel Context Menu (when you right-click anywhere on the chat
+ that is not otherwise linked) and customize User Dialog Buttons (Custom Commands
+ and Timeout Buttons).
+
Commands can be added in the following format:
+
/<commandName1>, /<commandName2>
+
For example:
+
/Slap, /Permit
+
Which means the command with the name slap will be added
+ first, then permit after that. You can use spaces,
+ linebreaks and/or commas as seperators between commands.
+
+
This is the syntax for specifying commands in the Context Menus/User Dialog:
+
+
/Slap /Permit or Slap, Permit or Slap Permit
+
Commands can be specified with or without forward slash /, then the name
+ (without parameters) and space, linebreak or comma to seperate to the next command.
+
Custom Commands in the User Dialog require the / in front.
+
//Slap
+
Prepending two forward slashes // will put the command
+ in the special submenu More.. (for Context Menus) or
+ in a second line of buttons (for the User Dialog).
+
| Slap or |//Slap
+
Adding | (vertical bar) will add a seperator before the
+ menu item for the next command.
+ The | doesn't have to be directly in front of the command,
+ it simply applies to the following command.
+
Does not work for custom buttons in the User Dialog.
+
/Set_color is displayed as Set color
+
Underscores in command names are replaced with a space for display
+ in a Context Menu or on a button.
+
+
+
In addition, you can define for the User Dialog Buttons:
+
+
5, 2m, 10m, 24h
+
In addition to Custom Commands you can also specify Timeout Buttons
+ in the User Dialog. Times are added just like Custom Commands
+ (seperated by comma/space/linebreak). However they
+ can only be added to the first row of buttons. They are interpreted as
+ seconds by default, unless you add a suffix: s - seconds,
+ m - minutes, h - hours, d - days.
+
120s, 120 is displayed as 120s and 2m
+
Both definitions create a button with a 120 seconds timeout, however
+ if you use a suffix, then the definition is used as button label
+ directly, otherwise the label is automatically created based on the
+ time.
+
/Ban[B], /Unban[U], 2s[P]
+
You can add keyboard shortcuts to buttons, that can be used while the
+ dialog is open and focused. Add a single button in brackets (uppercase).
+ Everything that is understood by
+ getKeyStroke()
+ can be used. No spaces are allowed, however a plus (+) can
+ be used instead (which will be replaced with a space automatically).
+
/Slap[NUMPAD1|Np1], /Permit[NUMPAD2|]
+
Adding a vertical bar (|) after the shortcut will use
+ the text after it up to the closing bracket as label for the shortcut on the button (no
+ spaces are allowed). If you don't specify any text, then no label is
+ used for that shortcut.
+
nokeylabels
+
If that text appears anywhere in the definition, then no labels will
+ be displayed on the buttons for the shortcuts, unless they are
+ explicitly defined.
Scroll down after [..] 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 accidently scrolling up from hiding
+ new messages.
+
Chat buffer size: How many lines of text are kept
+ for each channel in chat to scroll back to.
+
Inform me about new versions: Checks for new
+ versions every few days and outputs a message about it.
+
+
Write Stream Status
+
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
+ (enter /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:
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
+
+
Example which will write two files (if joined to #joshimuz):
If the stream is online, it writes the title and viewercount to title.txt
+ and the game to game.txt.
+ If the stream is offline it writes "Stream offline" to title.txt and empties
+ game.txt.
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.
+
+
Connecting
+
+
Server: The default server to connect to
+
Port: The default port(s) to connect to (can be
+ a list of ports, e.g. 6667,80)
+
+
The values of these settings are used when connecting, unless the commandline
+ parameters -server and/or -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 /get server
+ and /get port.
The Twitch Client Version setting has been removed since Twitch Chat was
+ switched over to IRCv3 tags and commands. It optionally also contains joins/parts/userlist.
If this setting is enabled, the IRCv3 capability that enables joins/parts is send
+ on connect. This doesn't mean you have to show joins/parts in
+ chat, it just means joins/parts are received in the background to maintain the userlist.
You can add hotkeys for certain actions. In general, there
+ are the following types of hotkeys:
+
+
Regular hotkeys, which will only trigger if the main Chatty
+ window has focus (or a popout window).
+
Application-wide hotkeys, which will trigger anywhere in
+ Chatty.
+
Global hotkeys, which are supposed to trigger everywhere
+ on your computer (Windows only, Hotkey version required). However some hotkeys may
+ not work, so just try it out.
+
+
+
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:
+
+
Action: The action to perform when the
+ hotkey is pressed. If you select Custom Command,
+ you have to enter the command to perform in the field below
+ (just the name of the command, see Commands).
+
Hotkey: The key or key combination that
+ has to be pressed to perform the action, click into the field
+ and press the key or key combination you want to use.
+
+
If the hotkey shows as being already used you may
+ still add it, but having more than one action defined
+ for the same hotkey will not trigger all the actions
+ when the hotkey is pressed, but a random one,
+ so it doesn't really make a lot of sense.
+ Adding it anyway can be sensible if you're currently
+ changing several hotkeys and will change the other
+ hotkey afterwards, so each key combination is only used
+ once.
+
+
+
Type:
Regular: Regular hotkey, which will only
+ trigger if the main window or a popout is focused.
+
Application: Application-wide hotkey,
+ which will trigger if any Chatty component is focused.
+
Global: Global hotkey, which will
+ trigger anywhere on your computer (only works with the hotkey
+ version of Chatty and if it loaded properly, Windows only).
+
+
Delay: The delay between performed actions,
+ in 1/10th of a second,
+ if this is 0 then there will be no delay required, otherwise
+ specifying a delay of e.g. 50 will 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.
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.
+
+
TAB Completion
+
+
Show popup:
+ If enabled, shows a small window with information about the
+ current completion if there is more than one matching result.
+ It shows at which result of how many you are when cycling
+ through results as well as a limited overview of which results
+ there actually are.
+
Max Items Shown: How many items
+ (e.g. names that match what you entered) to show
+ in the popup at once. You can set this to 0 to not show any
+ items.
+
Complete to common prefix:
+ Pressing TAB only completes up to the common prefix for
+ all found matches, giving you the opportunity to add
+ more characters and then press TAB again to refine the
+ results or just press TAB again to start cycling through
+ the results.
+
+ With this
+ setting disabled, it immediately completes the first found
+ result, allowing you to directly cycle through by pressing TAB repeatedly.
+
Sorting: Changes how the matching usernames
+ are sorted for completion (only applies to usernames,
+ not for other stuff like emotes or setting names which
+ are always alphabetical).
+
+
Predictive: Gives names of users that were recently
+ active in chat higher priority, with users who send
+ a message that was highlighted the highest. This way
+ people you talk to probably appear under the first
+ few results.
Custom Completion allows you to add terms and their completion,
+ allowing you to not only complete names in chat (TAB) or emotes
+ (Shift-TAB) but also custom stuff you added to the list by prepending the term with a
+ point and using Shift-TAB.
+
+
Example: Add chatty as Key and
+ http://chatty.github.io as Value
+ and then in the inputbox type .chatty (notice the dot in front) and press
+ Shift-TAB to complete it to the URL.
+
+
Custom Completion items can only have one completion, so you
+ can't have .chatty complete to several things
+ as it could be the case with a nickname.
+
+
Besides the Settings Dialog, you can also use the
+ /customCompletion command to modify custom
+ completion items:
+
+
+
/customCompletion add <item> <value> - Add an item
+
/customCompletion set <item> <value> - Change an item that already exists
+
/customCompletion remove <item> - Remove an item
+
+
+
Remember that you can also use TAB Completion for commands. Kappab
+
+
+
diff --git a/help/help-short_guides.html b/help/help-short_guides.html
new file mode 100644
index 0000000..57e752a
--- /dev/null
+++ b/help/help-short_guides.html
@@ -0,0 +1,141 @@
+
+
+ Chatty Help - Short Guides
+
+
+
Go to Main - Settings - Ignore and make sure Enable Ignore
+ is ticked. Then add to the list (press the Plus-Button):
+
!status:smbaf chanCat:subonly
+
The !status:smbaf prefix matches on messages send by users that
+ don't have any of the status levels defined, in this case users
+ that are neither a subscriber (s), moderator (m), broadcaster (b),
+ admin (a) or staff (f). So basicially this only matches on normal users.
+
The second requirement for a match is the chanCat:subonly
+ prefix, which refers to the channel category subonly, which
+ means the channel the message was send in needs to have that Addressbook category.
+ This is used to be able to easily toggle subonly-mode for a channel, and
+ of course to prevent it being enabled in all channels you join in the
+ first place.
+
+
Create Custom Command to modify Addressbook
+
To make use of the Ignore Entry defined in the previous section, you need
+ to add the subonly category to the channel you want to have
+ it enabled for. To do this, you could open the Addressbook Dialog
+ (Channels - Addressbook) and add the channel with the
+ category there (channels need a leading # in this case, so e.g. #joshimuz).
This toggles the subonly category for the given channel, so
+ when the category is there, it removes the category, and when the category is not there,
+ it adds the category.
+
To do this a bit more conveniently, you can add it as a custom command. Go
+ to Main - Settings - Commands and add the following to the
+ list:
+
/Toggle_Subonly /ab change #$$1 !subonly
+
If you enter /Toggle_Subonly joshimuz, this will automatically
+ run the Addressbook as mentioned above ($$1 means this is
+ being replaced with the first word after the command).
+
+
To make this more convenient (entering the command with the correct channel
+ could be a bit of a hassle), add the Custom Command to the Channel Context Menu
+ (on the same page in the settings). Just click on Edit and add
+ the command name (without any parameters):
+
/Toggle_Subonly
+
Now if you right-click on a channel, the context menu that opens should
+ have an entry Toggle Subonly, which you can
+ use to turn your own local subonly mode for the current channel on and off.
Open the <View - Channel Info> to see your current
+ stream title/game, a graph of your viewercount and how long your current
+ stream already is going.
+
Open the <Extra - Followers/Subscribers> dialog
+ to view your 100 most recent Followers/Subscribers and some stats based
+ on that.
+
+
+
Manage your stream
+
+
Open the <View - Channel Admin> dialog to change
+ the title/game of your stream and run commercials:
+
+
Presets/History for title/game combinations
+
Favorite games you play often
+
Run commercials on a delay and/or timer
+
Run commercials while playing a game via a global hotkey
+ (Windows only)
+
+
+
+
+
Capture chat for on-stream chat
+
+
Customize chat colors, for example change to black background to be
+ able to make the background transparent in your streaming program.
+
If you capture Chatty with your streaming program, make sure to
+ enable the setting Settings - Window - Always show chat scrollbar, so you can always capture the same
+ region, independant of how many messages are in the chat window.
+
Change the font so it shows up nicely on stream.
+
If you want to have all text in bold - not just the names - you can
+ set the font by command like this: /set font Arial Bold.
+
You can clear the chat window by using the /clearchat
+ command (e.g. if you changed some settings before starting the stream
+ you don't want to show).
Sometimes there are channels that run on a special set of event chat
+ servers, so they are seperated from the channels you see when you join
+ irc.twitch.tv. This only applies to webchat (at the moment
+ at least), so often the chat you get connecting to irc.twitch.tv
+ is called "mobile chat", because the mobile apps apparently also don't
+ support event chat.
What you have to do in Chatty to be able to get the
+ event chat instead of the "normal chat" that is only used by IRC and
+ mobile users, is connect to a different server. Since Chatty can only
+ connect to one server at a time, you either have to only join channels
+ that are on the event chat servers, or run two seperate instances of
+ Chatty at the same time.
+
+
There are different ways of connecting to a different server:
+
+
The /server <host>[:port] command connects to the given server and
+ port manually.
+
The -server and -port commandline options
+ allow you to specify a different server when you start Chatty.
+
The Server and Port settings in the
+ Settings Dialog under Advanced allows you to set
+ fixed settings for the server to connect to. This especially makes sense
+ if you are using seperate settings for different instances of Chatty.
SpeedRunsLive is a platform
+ dedicated to speedrunning and racing (live speedruns against other players).
+ Chatty has an integrated race viewer, which lists all the current races.
Open the race list via SRL - Race List, which shows the
+ current races. Right-click on a race to open a contextmenu with several
+ options, double-click on a race to open the Race Info dialog.
+
+
Notice that the race list isn't automatically updated, unless you have
+ a Race Info dialog open (which is automatically updated in a regular
+ interval). If you want actual real-time information on races, joining
+ the SRL IRC is a good option. The integration in Chatty is mainly supposed
+ to make opening/joining race related stuff easier and to give a quick and
+ easy overview of who is in a race you are watching (without having to open
+ a website).
Use SRL - Races with.. to find races that the stream of
+ the currently active channel you have joined is part of. This will basicially
+ take the stream you have clicked on, search through all the current races
+ and list all the races that have an entrant that has that stream set. If
+ there is only one matching race, and you currently don't have the Race Info
+ dialog open, then it is immediately opened. Otherwise the matching races are
+ listed for you to select.
Sometimes users aren't correctly sorted in the userlist
+
Windows: Dragging the upper edge to maximize the window vertically
+ doesn't resize the contents of the window. This may be a Java Bug
+ that I cannot fix. Workaround: Try double-clicking the upper edge
+ instead of dragging it.
+
+
+
Errors / Crashes
+
+
Using the Calibri font can cause random errors, due to a bug in
+ Java.
+ (More information)
+
Java can crash due to a bug with the graphics driver.
+ (Forum Posts)
If you experience a laggy interface, this can have several reasons. For
+ one some chat channels are very busy and depending on your computer, this
+ may not be easy to handle. Managing the userlist can cost a lot of
+ performance in large channels because of having to react to hundreds of
+ users joining or leaving at once. It can help to temporarily
+ ignore joins/parts in this case.
+
+
You may also want to check if Irc logging is enabled in the Debug Window
+ (Extra - Debug window - Checkbox: Irc log), which should
+ be disabled by default, but can lower performance if checked.
First of all, you only need Global Hotkey support when you want to use
+ global hotkeys (which you can define in the settings). If you don't, you
+ can just ignore any related messages or download the version of Chatty
+ without Hotkey support. Global hotkeys currently only work on Windows.
+
+
If you want to use global hotkeys and you get a message related to them
+ not working, check the following sections. If you don't get a message,
+ but the global hotkeys you defined just don't work, make sure you
+ actually have global hotkeys enabled in the settings.
+
+
Wrong version of Chatty
+
If you try to add a global hotkey and it tells you that you have the
+ wrong version of Chatty, you probably don't have the version supporting
+ global hotkeys. Download the version that contains hotkey
+ in the .zip filename and try that instead.
+
+
Could not load library (jintellitype-1.3.8.jar)
+
Chatty requires the jintellitype-1.3.8.jar to be in the
+ lib subfolder of where the Chatty.jar is
+ located.
+
+
Could not load JIntellitype.dll
+
If you get this error, you started Chatty with Hotkey support, but it
+ couldn't load the library (.dll) necessary to register hotkeys. This can
+ mean that:
+
+
+
You have the wrong version for your version
+ of Java (32bit or 64bit Java need different versions of the .dll)
+
The JIntellitype.dll isn't stored where the program can
+ find it
+
+
+ Find out if you have the 64bit or 32bit version of Java (e.g. by
+ entering java -version on the commandline to check if there
+ is 64bit in the response), then check if you downloaded the matching
+ version of Chatty.
+
+
Enter /wdir in Chatty to find out what your working directory
+ is and make sure the JIntellitype.dll is in there. If you
+ are starting Chatty via a shortcut, remember that the directory
+ specified in the Run in field determines your working
+ directory (on Windows at least, but global hotkeys are currently Windows only
+ anyway).
If a user is timed out in one channel, Chatty may show the timeouts in
+ other channels as well. This is because there is no channel associated with
+ timeouts or bans in Twitch Chat, so the program has to guess in which
+ channel the timeout occured. See also: Joining more than one channel.
If you repeatedly get disconnected because of possibly invalid login
+ data, please open the Connect Dialog and choose Configure login.. - Verify login.
+ This will send a request to Twitch to check if the access token is valid.
+ If the login data is valid, then Twitch may just have temporary problems
+ and you should try again later. The same goes for when the check itself
+ fails because it can't reach the Twitch API.
+
If the login data isn't valid, you can just remove the login and request
+ new login data. Also see the section about login
+ for more information about invalid logins.
If Java encounters a character that is not contained in the chat font
+ you currently have configured, it will try to find it in the fallback
+ fonts. While still not all characters will be displayed this way, it
+ should work a lot better. If you want to be able to display even more
+ characters, you can add your own fallback fonts into the Java fallback
+ font directory: <JRE_INSTALL_DIR>/jre/lib/fonts/fallback
+
+
On Windows, the JRE would usually be located in
+ C:\Program Files\Java\ or
+ C:\Program Files (x86)\Java\.
+
+
Note: If you set the inputFont
+ setting to something else
+ besides a Java logical font, then the font fallback mechanism may break.
+ This was the case before version 0.7.3.
You need to have at least Java 7 JRE (Java Runtime Environment) installed to run Chatty.
+
If you try to start Chatty by double-clicking the Chatty.jar,
+ first make sure that .jar files are associated with Java,
+ and not some other program like WinRAR. The icon of the Chatty.jar
+ should have a Java icon (coffee cup). If you right-click the Chatty.jar
+ you can select the program to open it with under Open with.
+
+
If you are sure that the Chatty.jar is actually started with
+ Java, but no program window appears, it may be that an error occured before
+ the window (GUI) could be created.
+
+
Check Association of .jar with Java (Windows)
+
Open a commandline window and enter assoc .jar which should output
+ .jar=jarfile and enter ftype jarfile which should
+ output something like "C:\Program Files\Java\jre7\bin\javaw.exe" -jar "%1" %*
+ (see also
+ Could not find the main class. Program will exit.)
+
+
Run from commandline
+
Running Chatty from the commandline has the advantage of being able to
+ get messages from before the GUI is established. Open a commandline where
+ the Chatty.jar is located (Win7/8: Hold Shift while Right-Clicking to open
+ the context menu, click Open command window here) and enter
+ java -jar Chatty.jar.
+
+
Error: Java is not recognized as an internal or external command (Windows)
+
If you experience this when entering java -jar Chatty.jar
+ in the commandline, then it probably can't find Java because it's not in the
+ PATH environment variable (that defines where to look
+ for programs of which only the filename has been entered, not the whole path).
+
You can enter PATH in a commandline window to check what is
+ in it. It should show a list of semicolon-seperated directories, one of which
+ should point to Java.
+
+
Find errors in debug.log
+
See next section. Of course you'll have to navigate to the folder
+ manually.
If you experience any problems or errors, then there may be helpful
+ information for debugging in the debug log, which is located in the settings
+ directory <user_dir>/.chatty/ (e.g.
+ C:\Users\<username>\.chatty\, if you
+ have Chatty running you can enter /openDir to open it or
+ /dir to output the path).
+
In that folder, there are two kinds of debug files:
+
+
The debug.log which is overwritten everytime you start
+ Chatty. It may also have a number at the end (like debug.log.1)
+ if Java couldn't open the usual debug.log.
+
Several files (debug0.log, debug1.log, ..), whereas
+ one of them is written to at a time, and then switched to the next when
+ a certain filesize is reached, rotating between a certain number of files.
+ Those files are not overwritten when Chatty is started, but instead new data is appended.
+
+
So to find possibly relevant data:
+
+
If you haven't started Chatty again after the error occured, check
+ the debug.log first.
+
Otherwise check if one of the debug0.log, debug1.log, ..
+ files could contain the necessary information, based on the last
+ modification dates.
+
+
Even if the error is already some time back, it may still
+ be in there, depending on how much data has been added in the meantime.
+
+
+
+
+ If you found a bug or have a suggestion..
+ [back to menu]
+
When in a channel, Chatty shows some information about that channel
+ in the titlebar, e.g.: [40|59] - GTA:SA Speedruns (Grand Theft Auto: San Andreas)
+
The first number is the number of people in the chat, the second is the
+ viewercount, followed by the current stream title and game. Anything other
+ than the number of people in the chat is requested from the Twitch API about
+ every two minutes.
All command names are case-insensitive. Something like <parameter>
+ represents a required parameter which must be entered for the command to
+ work properly (you don't enter the surrounding < >,
+ they are just there to show it's a parameter). Equivalently [parameter]
+ represents an optional parameter.
+
Chat commands:
+
+
/me <message> - Send an action message (* nickname says something) to the channel
+
/to <nick> [time] - Timeout the user with the given nickname for "time" seconds (time is optional)
+
/timeout, /ban, /unban,
+ /slow, /slowoff,
+ /subscribers, /subscribersoff,
+ /clear, /mods, /host,
+ /unhost, /color
+ just like in normal Twitch Chat
+
/join <channel> - Joins the given channel
+
/part or /close - Leaves the current channel
+
/reconnect - Disconnects and reconnects
+
/fixMods - Temporarily fixes the list of mods (like
+ /mods but without showing the list of mods in chat)
+
+
Info commands:
+
+
/connection - Show info about the current connection
+
/uptime - Shows how long Chatty has been running
+
/appinfo - Shows Chatty uptime and current memory stats
+
/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
+
/openWdir - Opens the current working directory in your file browser
+
/testNotification [channel] - Display a test notification (optionally with channel,
+ which means right-clicking on the notification will join that channel)
+
/myemotes - Show your subscriber emote codes (only works if you
+ have joined any channel before, this is only a quick info, better emote
+ integration maybe to be implemented later)
+
/ffz, /ffzGlobal - Shows the FFZ channel emote codes for the current channel/global FFZ emotes
+
/releaseinfo - Opens the help with the release information
+
+
+
Other commands:
+
+
/clearchat - Clears the current chat window of all text
+
/setcolor <name> - Opens the usercolor settings
+ for the given name
+
/echo <text> - Outputs the given text as a info message
/settings, /livestreams, /channeladmin,
+ /channelinfo, /search, /openFollowers,
+ /openSubscribers - Opens the according dialog
+
/insert <text> - Inserts the given text into the input box at
+ the current caret position (can be useful for Custom Commands put
+ in a menu)
+
/insertword <text> - Same as /insert,
+ but adds spaces so it's seperated from text before and after (if present)
+
/openUrl <url> - Opens the given url
+
/openUrlPrompt <url> - Open the given url after
+ showing a prompt for confirmation
+
+
+
Advanced commands (not recommended for use unless you know what you do):
+
+
/server <host>[:port] - Connect to a custom server
+
/raw <command> - Send a raw command to the server
+
/refresh <emoticons/badges/ffz/ffzglobal/bttvemotes>
+ - Refresh the Twitch emoticons or badges (current channel) list or
+ refresh FrankerFaceZ channel emoticons (current channel) or global emoticons.
+ This downloads the lists from the Internet, so don't use this
+ unless you need to (it's basicially like pressing reload in your
+ browser, just only for some stuff).
+
/changetoken <token> - Checks if the given token
+ is valid and sets it as new token if it is
The login data consists of a username (or account name) and most importantly an access token, which is sort of a
+ revokable password that can also have different types of access associated with it, the ones usable for Chatty being:
+
+
+
Chat access
+
Required to connect to chat (required for Chatty).
+
+
Read user info
+
Required to request the streams you follow, so you can get notified
+ when they start streaming.
+
+
Editor access
+
Allows you to change the title/game of your stream and streams you
+ are an editor in via the Admin Dialog.
+
+
Run commercials
+
Allows you to run comercials on your stream
+ via the Admin Dialog (if you are partnered).
+
+
Show subscribers
+
Required to view the list of your subscribers
+ via the Subscribers Dialog (if you have a sub button).
+
+
+
Once requested from Twitch, the login data is stored locally on your computer
+ along with the other settings of Chatty. Since Twitch gives out the access token
+ per application, any access token for the same account requested with Chatty
+ will be invalidated when you request a new access token.
+
If getting login data fails, read this guide.
+ If your login was determined invalid, read down below.
To allow Chatty more access than it already has (e.g. if you haven't selected
+ editor access before, but you want it now),
+ you need to request a new access token.
+ Just go to <Main - Login..>, delete the login
+ and request it again with the necessary access.
+
+
Allow less access
+
To allow Chatty less access than it already has (e.g. you don't want it
+ to have editor access anymore) you need to first revoke access
+ completely in your Twitch Account
+ Settings, then
+ authorize access again. What will not work is just requesting a new
+ token without selecting the now unwanted access. Twitch will always
+ respond with a token that has at least as much access as the previous
+ one.
The access token is saved in the login file in the settings
+ directory and can thus be accessed
+ by anyone having access to your computer.
+ It allows anyone who obtains it to chat in your name and access the other
+ things listed above (if you allowed it when getting the token). If you think
+ the token may have been compromised, please immediately delete it and
+ request a new one (which will invalidate any previously issued)
+ or go to your Twitch Settings subsection
+ Connections
+ and revoke the accesss there.
If your login is determined invalid (either by checking it manually or
+ when Chatty performed an automatic check), this can mean one of two things:
+
+
Twitch returned false data and your login is actually still valid
+ (which rarely happens, but it is possible).
+
Your login is actually invalid:
+
+
You have requested new login data for the same Twitch Account from
+ another instance of Chatty, for example on another Computer, which
+ has automatically invalidated the previously requested login data
+ (access token).
+
You have just requested login data and something went wrong, or it
+ wasn't loaded properly from the settings.
+
The token was invalidated for some other reason.
+
+
+
+
+
What happens when your login is no longer valid:
+
+
You can't connect to chat anymore. If you are already connected and
+ stay connected, this doesn't matter.
+
Your followed streams are no longer requested, so you may not be
+ informed about streams starting anymore (if you had that enabled in the
+ first place).
+
Other features that require authentication won't work properly anymore, like
+ the Admin Dialog.
+
+
+
How to proceed:
+
+
If it is known or reasonable to assume that Twitch is currently derping,
+ then you can manually try to verify the login at a later time.
+
Go to <Main - Login..> to open the Login configuration
+ and click on [Verify login].
+
+
Request new login data.
+
Go to <Main - Login..> to open the Login configuration
+ (unless you are already there), [Remove login] and create
+ a new login.
There are a few special symbols that are used for users in chat. These
+ are displayed in the userlist and - if usericons are disabled - also in chat.
+
+
~ The Streamer
+
@ Moderators
+
* Global Moderators
+
! Admins
+
& Staff
+
+ Turbo users
+
% Subscribers
+
^ Bots as recognized by local setting, FFZ API and BTTV API
+
+
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.
When you type in the inputbox, you can TAB-complete different types of
+ things:
+
+
Nicknames of who is currently in the userlist (using TAB)
+
Chatty setting names when you use a setting command (using TAB)
+
Some comands after / (using TAB, e.g. /sub then TAB to complete to /subscribers)
+
Emoticon names (using Shift-TAB, e.g. Datsh then TAB to complete to DatSheffy)
+
Custom completion
+ that is prepended with a dot and for which items can be added in the
+ settings (using Shift-TAB)
+
+
+
How it works
+
There are a couple of settings
+ that change the behaviour of the TAB Completion.
+
+
+
Enter the beginning of an item (name, setting, emote).
+
Press TAB for a nickname/setting/command or Shift-TAB
+ to enter the completion mode, which will:
+
+
Complete to the full item (e.g. full name) if there is only
+ one item matching what you entered
+
For more than one match, depending on the Complete to common prefix setting:
+
+
Complete to the common prefix of all found items that match
+ what you entered, allowing you to enter more characters
+ to refine the search and then press TAB or
+ Shift-TAB again to enter a new completion
+
Complete to the full item of the first match
+
If enabled, it will also show a popup with information
+ about the completion, which doesn't show if there is only
+ one match
+
+
+
+
+
You can then either:
+
+
Press TAB repeatedly to cycle forwards through the found
+ matches or Shift-TAB to cycle backwards
+
Press ESC to cancel the completion mode and go
+ back to the text when you started the completion
+
Continue typing/editing the text to exit the completion
+ while keeping what you already completed
+
+
+
+
+
The found matches are all ordered alphabetically, except for nickcompletion
+ for which you can choose different types of sorting. By default nicknames use
+ predictive sorting, which means users who recently wrote a message or highlighted
+ you have a higher priority, increasing the chance that the users you want to
+ address appear as the first few matches.
+
+
Example: Nick Completion
+
+
Enter z in the editbox
+
Press TAB to complete as a nickname
+
+
On default settings, this may complete to ze_tt
+ with two other results
+
+
+
Cycle through to zMASKm by:
+
+
Pressing TAB, which cycles fowards to zMASKm
+
Or press Shift-TAB to cycle backwards to zeblover
+ and Shift-TAB again to cycle to zMASKm
+
+
+
+
+
Example: Emote Completion
+
+
Enter dat in the editbox
+
Press Shift-TAB to complete as an emote
+
+
On default settings, this may complete to DatHass with two other results
+
+
+
Cycle through to DatSheffy by:
+
+
Pressing TAB, which cycles fowards to DatSaunce
+ and TAB again to cycle to DatSheffy
+
Or press Shift-TAB to cycle backwards
+ to DatSheffy
Chatty provdes an input history for the chat input box that allows you to
+ call up lines you entered previously, to make it easier to e.g. repeat
+ commands with similiar parameters, repeat messages you send to chat or just
+ look up what you wrote before. You can even save messages to the history
+ that you haven't send yet to be able to send them later.
+
+
How lines are saved in the history:
+
+
Send a message or enter a command
+
Press Down-Arrow after entering/editing a message
+ (which saves it to the history, but also clears the input box)
+
Identical lines already in the history are removed (or you
+ can think of it being moved to the latest position)
+
+
+
Using the history:
+
+
You can navigate backwards and forwards through the history by
+ pressing Up-Arrow and Down-Arrow.
+
Pressing Up-Arrow when you already entered some
+ text replaces that with the latest history item.
+
Pressing Down-Arrow when you already entered some
+ text clears the input box and but also saves what you entered to
+ the history (as mentioned above).
+
When you navigated to a history item and edited it:
+
+
Pressing Up-Arrow will move to the previous
+ history item, allowing you to then press Down-Arrow
+ again to go back to the unedited history item
+
Pressing Down-Arrow will act as if you
+ entered a completely new line and add the edited item
+ to the history and clear the input box
If enabled, the history automatically saves channels you join and when
+ you last joined them. By default channels expire from the history after
+ 30 days of not joining them (can be changed).
+
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.
The highlight system allows you to add words or phrases that make chat
+ messages appear in another color and appear in a seperate window, which you can
+ open under View - Highlights (you can clear the highlights window
+ in it's context menu).
The ignore system works very similiar to the highlight system, just that
+ it hides messages instead of highlighting them. They however also get
+ added to a seperated window, which you can open under View - Ignored
+ (you can clear the messagess in the window in it's context menu).
The color of a user is displayed in the User Info Dialog. Color Names
+ are used where possible, HTML Color Codes are displayed in the Tooltip.
+ Colors with asterisk (*) are default colors (the user hasn't set one
+ or hasn't said anything during this session yet). A color in parentheses
+ means it's the original color, while the other color is the corrected one
+ that is actually displayed.
+
Corrected Colors
+
Chatty attempts to make colors more readable automatically by changing
+ them to increase contrast. This doesn't work very well though, although it
+ should work for extreme cases like white on white or black on black.
+
+
Custom Colors
+
You can also specify custom colors for certain users or types of users
+ in the settings. Custom colors are indicated by two asterisks (**) in the
+ User Info Dialog.
Chatty supports the default Twitch Emoticons (Normal/Turbo/Subscriber),
+ which should work the same as in normal Twitch Chat. It however also
+ supports FrankerFaceZ, a custom
+ set of emotes that is normally made available in normal Twitch Chat by use of browser
+ extensions. It also supports BetterTTV emotes.
+
+
You can enable/disable Emoticons in general (displaying the icons instead
+ of the text) in the settings under Emoticons. You can also
+ ignore specific emotes in the same place in the settings.
+
+
In chat you can right-click on an emoticon to show some info about it.
+ Click on the emote code (e.g. FrankerZ) in the context menu
+ to insert the emote in the inputbox. If it is a subscriber emote, you
+ also have some more options.
+
+
Emote Dialog
+
Use Extra - Emoticons or press Ctrl-E to open
+ the Emote Dialog, which has various pages:
+
+
The Favorites page lists emotes you have added to the favorites
+ via the Emote Context Menu (right-click on an emote in the dialog or chat and
+ choose Favorite, emotes that already are favorited can be
+ removed from favorites the same way).
+
The My Emotes page lists the emotes you paid for (Subemotes/Turbo).
+
The Channel page lists the emotes that are specific to the current channel
+ (FFZ and BTTV, if there are any). It also includes
+ the subscriber emotes of the current channel (if it has any), whether you
+ can use them or not (but it displays a message if you are not subscribed).
+
The Twitch page shows all free global Twitch emotes
+
The Other page shows all global FZZ/BTTV emotes
+
+
+
Click on an emote to insert it into the current channel inputbox. Double-click
+ on an emote to also close the Emote Dialog in the process, or press ESC or
+ Ctrl-E to close it. Right-click on an emote to show a context menu
+ with some more information/options.
+
+
Right-click on an emote and choose Show Details to open the
+ Detail View in the Emote Dialog, which shows the emote in different sizes
+ and some information about it. Clicking on an emote in chat also opens the
+ Detail View.
+
+
Note that you need to have joined at least one channel for your subemotes/turbo emotes
+ to show up, because only then does Twitch Chat send that information to the client.
You can add your own local emotes by creating a file called emotes.txt
+ in the settings directory (enter /dir in Chatty to find the
+ settings directory, /openDir to directly open it). The
+ file can have one emote on each line, for example:
This can be used to replace existing emotes, since custom emotes are
+ checked first and thus take precedence. This is not intended to replace
+ FFZ or BTTV emotes, just to help configure emotes to your personal
+ preference. For example you could also add an image for you own name to
+ have it highlighted in chat in a different way.
+
+
Syntax
+
+
The syntax per line is (you can use as many spaces or TABs as seperators as you want):
+
+
[settings] <code> [settings] <image> [settings]
+
+
Settings can be in any of the shown places, but are always optional. Available settings are:
+
+
+
+
set:<setid> to specify a
+ Twitch emote set. This will only affect messages you write yourself.
+
id:<emoteid> to specify a Twitch emote id to
+ replace. This will only affect incoming messages.
+
chan:<channel> to restrict the emote to the
+ given channel.
+
size:<width>x<height> to specify the
+ size of the emote (you can omit this if you want to use the image
+ size).
+
+
+
Required:
+
+
The code can be prefixed with re:
+ to specify a regular expression. Otherwise it is interpreted as plain text.
+
The image file is relative to the settings directory (where you created
+ the emotes.txt in), so just put them in the same directory.
+ You should also be able to use URLs to load the image from the internet.
+
+
+
Lines starting with # are ignored and can be used for comments.
+
+
The emotes.txt file is loaded when you start Chatty, so if you edit the file
+ while Chatty is running, you have to use the /reloadCustomEmotes
+ command for it to take effect.
+ Emote images may be cached, so if you change the image, you MAY have to
+ clear the cache (/clearemotecache CUSTOM).
With this feature, you can select a user in chat with keyboard shortcuts
+ (if the window is active). So you can e.g. timeout a user with your keyboard
+ alone.
+
+
Press Ctrl-Space (can be changed in the settings) to enter
+ this mode. If there are any user
+ messages in chat, then the newest message will get another background color
+ which shows that it is selected. In that mode, the focus is on the textpane,
+ which enables more shortcuts:
+
+
W to move up a user
+
S to move down a user
+
A to move up twice
+
D to move down twice
+
Q to quit out of the mode
+
E to open the User Dialog for the currently selected user
+
+
+
When you move up and down, it actually switches to the next user instead
+ of to the next line. So if the same user send 10 messages in a row, it will
+ jump to the first message of the next user above it.
+
+
In addition to the currently selected message, it will also highlight all
+ other messages by the same user. You can also hold Ctrl and
+ click on a username in chat to highlight all that users messages (and enter
+ User Selection Mode).
+
+
You can also click and hold in an empty area of the textpane, which puts
+ and holds the focus there, so you can just use the shortcuts in the list
+ above to enter the User Selection Mode and switch between messages. However
+ if you let go of the mouse key, it will immediately leave the mode again.
+
+
Using Global Hotkeys
+
You can also configure global hotkeys with some User Selection actions.
+ However, if the focus is not on the chat, then the usual shortcuts won't
+ work, so you'll have to define additional global hotkeys to e.g. timeout the
+ currently selected user. See the hotkey settings for what actions are
+ available.
Stream Chat is a seperate dialog, opened via the /openStreamChat
+ command or the Extra menu, that can have chat messages from one or several
+ channels redirected to it (only regular chat messages, so no JOINS/PARTS, info messages
+ and so on). It also can have a message timeout set, so messages will
+ disappear after a certain amount of seconds.
+
+
The idea is to capture Stream Chat to display chat on stream and
+ messages will only be displayed if the chat has been recently active. So
+ this doesn't really make a lot of sense for busier channels, unless you
+ simply prefer to only have regular messages or to have a seperate dialog
+ for the capture.
+
+
Getting started
+
You need to add the channel which messages are redirected to the
+ Stream Chat dialog before anything will appear. The setting you are required
+ to change is streamChatChannels,
+ which is a list setting giving you different ways of editing it:
+
+
/set streamChatChannels #<channel> - To set
+ the channel to only this one
+
/add streamChatChannels #<channel> - To add
+ a channel in addition to the ones already set
+
/remove streamChatChannels #<channel> - To remove
+ a channel from the list
+
+
Check out other settings that are also edited with setting commands.
+
In addition, make sure you have Settings - Window - Restore dialogs
+ set to at least Restore dialogs from last session in order
+ to keep the position/size of the Stream Chat dialog between sessions.
+
+
Commands
+
+
/openStreamChat - Opens the Stream Chat dialog
+
/setStreamChatSize <width>x<height> - Set the exact size of the Stream Chat dialog in pixels
+
/getStreamChatSize - Shows the size of the Stream Chat dialog in pixels
+
/clearStreamChat - Removes all messages
+
/streamChatTest [message] - Adds a test message to the Stream Chat dialog, if you don't specify a message
+ a default one is used
You can give people in chat custom names that will appear in chat and
+ in the userlist instead of the regular Twitch username and in the User Info
+ Dialog in addition to the regular Twitch username. In other places (like
+ the User Context Menu or auto-completion) the regular Twitch username is
+ used.
+
+
The following commands are used to set custom names:
+
+
/setname <name> <custom name> - to set a custom name
It is recommended that you read and understand this whole section
+ before enabling this feature.
+
Chatty implements the new /w command that Twitch Chat provides, allowing
+ you to send private messages in chat to other users. However, it is disabled
+ by default, since it has a few problems:
+
+
Twitch is currently testing Whispering on the Group Chat servers but
+ is planning to move it to a whole different system soon, which means
+ in the current state it is not really encouraged to be used by
+ third-party applications. It is unclear what the new system will be
+ and whether it will be possible to implement it in Chatty. Also, due
+ to these circumstances, not too much development time will be put
+ into the Whisper feature in Chatty at this time.
+
Whispering currently runs on the Group Chat servers, so Chatty can't
+ just use irc.twitch.tv to connect as for regular chat.
+ Since there is no easy official way to get the server data
+ automatically, you have enter the IP and port yourself if you want
+ to use this feature.
+
+
Getting started
+
You have to change a few settings in order to use this feature
+ (all under Main - Settings - Advanced):
+
+
Whisper Enabled: Connect to the given Group Chat server to send and receive
+ whispers.
+
Server: The Group Chat server IP to connect to. You can check:
+
+
Twitchstatus.com (unofficial site) at the bottom of the page,
+ "Group Chat" tab
+
Get an IP from the Twitch API using this guide
+ (you will need a token and be member of a Group Chat, you won't need to get a channelname)
+
+
Port: The port for the Group Chat server you
+ are using (you should get it along with the IP).
+
+ All these three settings require a restart of Chatty to take full effect,
+ although it may have some effect without a restart.
+
+
Once properly enabled and connected, [W] will be shown in the titlebar and
+ the /connection command will show the Whisper connection.
+ The connection is attempted once you connect to regular chat.
+
+
+
Optional settings:
+
+
Whitelist: If enabled, only users that have the
+ Addressbook category whisper will be able to send
+ whispers to you. Messages from other users are completely ignored.
+ Alternatively you can also blacklist users by adding them to the
+ blockwhisper category (which makes most sense with the Whitelist setting
+ disabled).
+
Display: Changes where the whispers are displayed.
+
+
Active Chat - Show in the chat window you are currently having
+ active in Chatty.
+
One Window - Show all whispers in one separate window.
+ In that window you will be able to respond to whispers by
+ just typing <name> <message> instead
+ of having to use the /w command. To be sure you
+ actually provide the user to send it to you can only whisper
+ to users that have already whispered to you (so e.g.
+ Hey how are you? :) wont't be send to the user
+ named Hey). The tab for collecting all whispers
+ is named $[whisper].
+
Per User - Open an extra tab for every
+ user that whispers to you. You can respond to whispers by
+ just typing the message in the tab for that user. The tab
+ will be named $<username>.
+
+
+
+
+
+
Usage
+
+
When you receive a whisper, it will be displayed depending on the Display setting and
+ will be indicated by the nickname being marked like this: -[name]-
+
When you send a whisper via /w <name> <message>,
+ then this will be indicated in chat by the nickname being marked like this: >>[name]
+
In both cases the name is the name of the person you are talking with, not your own name.
+
When you click on the name, you will be able to see your conversation,
+ with your own messages marked with a asterisk in front (*), which is usually
+ used to mark action messages (/me).
+
+
+
If you get a lot of errors like Whisper feature: Disconnected there
+ may be a temporary problem, you may have entered the server/port wrong or
+ the feature is not working as it is implemented in Chatty anymore (in which
+ case you should disable the feature).
The Channel Info Dialog shows the current stream status of the active
+ stream. The data is requested from the Twitch API in a semi-regular interval,
+ so it can take some time to update.
+
+
Online Time
+
If the stream is online, the Online: 1h 30m
+ shows how long ago the stream was started. That time comes directly from the
+ Twitch API, so it is able to show the correct online time, even if you started
+ Chatty after the stream started.
+
+
If there is a time in parentheses
+ (like 1h 30m (2h)), then that time denotes how long the stream
+ was online, but including small offline periods (PICNICs) of at most 10 minutes,
+ which means that this time is more of a guess of what might be expected as
+ stream online time and also depends on when Chatty got the data (if you join
+ the channel after a PICNIC, then it won't include the time before, because it
+ never received the data for it).
+
+
History Graph
+
The History is a graph that shows the development of the viewers
+ of the currently active channel and also indicates stream status changes
+ (online/offline/title/game) by different colors.
+
Hover over points to display the stream status and viewercount
+ at that time. Right-click for a context-menu.
+
+
+
+
+
There are two ways to change which time range is being displayed:
+
+
Time Range means only the last x hours
+ are being displayed. For example if the whole data spans 10 hours
+ you can choose to only display the last 2 hours. This will display
+ the maximum range after the actual range
+ (even if the actual range isn't as long as the
+ maximum range):
+ 15:32 - 19:14 (2h)
+ You can change this via the context menu.
+
+
Fixed Start/End means that either
+ the beginning of the displayed data is fixed or both the
+ beginning and end of the data are fixed, meaning that the
+ displayed graph will never change. The times that show the
+ actual range indicate whether they are fixed:
+ |15:58| - 19:14 or |15:58| - |18:20|
+ Double-click on a point to set it as a fixed start, then
+ double-click on another point to set it as a fixed end.
+ Double-click anywhere else to clear fixed start/end.
+ This setting is channel-specific and isn't saved when you
+ close Chatty.
+
+
+
+
+
+
+
+
+
+
+
The History is recorded while you have the channel open in Chatty
+ as well as for all followed channels, if you have that feature
+ enabled.
+
The shown data usually fits to the available vertical space
+ (so if the min/max viewercounts were 341/403 then only this
+ range is shown). If you choose Toggle Vertical in
+ the context-menu, you can switch between the shown range
+ (min/max) and the full range (0-max).
Chatty can show Notifications when the status of a stream changes.
+ There is also a Live Streams window (Channels - Live Channels)
+ that shows the currently live streams. Both these features always include channels you have
+ joined and - if enabled - channels you have followed. Streams that are
+ no longer online, or whose channels you have left and you don't follow,
+ are added to a list that you can open in the Live Streams window context
+ menu (Removed streams..).
+
+
Notifications
+
Chatty Notifications are little info boxes that can be shown for stream
+ status changes and highlighted messages. When you left-click on a notification
+ it is closed immediately, right-clicking closes it as well and in addition
+ also joins the associated channel.
Chatty can request a list of streams you follow on a regular basis, so
+ you have both an overview of currently live streams as well as be
+ informed about status changes (offline -> online, title change, game change).
+ This is always available for streams whose channels you have joined in chat,
+ but with this feature enabled, this works for all streams you follow even
+ without joining their channel.
+
This feature requires Read user info access, so Chatty can
+ request your followed streams. Read the section about login
+ to learn more about login data and access.
+
You can enable/disable this feature in the Settings under Notifications.
You can open a list of the Followers of a channel by joining that channel
+ and then opening the Followers Dialog via Extra - Followers.
+ It always opens on the currently active channel, or if you are in no channel
+ at all, your own channel.
+
+
You can open a list of your Subscribers by opening the Subscribers Dialog
+ via Extra - Subscribers. It always opens on your own channel,
+ because you can only display the Subscribers of your own channel. If you don't
+ have any Subscribers, it will simply show an empty list (and an error). You
+ also need to have selected the necessary access when
+ requesting login data.
+
+
You can save the current list to a file by right-clicking on the dialog
+ (not the list) and selecting the format.
+
+
Usage
+
Both the Followers and Subscribers Dialog otherwise work in pretty much
+ the same way. Data is only requested as long as you have the dialog open. It
+ is requested in a semi-regular interval and then displays that data in the
+ list (and some stats).
+
If followers/following is mentioned below, then the same applies for
+ subscribers/subscribing in the appropriate dialog.
+
+
+
+
At the top it shows some stats:
+
+
Total: The total number of followers (not to be confused
+ with the followers shown in the list, which are the most recent 100).
+ After the total number, it shows the change compared
+ to the last update, e.g. Total: 3.190 (+2),
+ which will stay there until the next update.
+
Week/Day/Hour: These are some stats based
+ on the current list shown below. It shows how many followers
+ there are in the list that followed in the last 7 days (Week), 24 hours (Day) and
+ 60 minutes (Hour). (So Day does NOT mean Today
+ as in since 0:00.)
+ If it says 99+ it means that there are more than
+ 99 followers in that timespan, but Chatty can't determine whether
+ it's 100 or more than 100, because the list only contains the
+ 100 most recent followers.
+
+
+
There are different background colors for some entries:
+
+
New entries (meaning entries
+ that appeared first in the last update)
+
Entries of the last 15 minutes
+
Entries of the last hour
+
+
+
The time has different colors for older entries:
+
+
Entries older than a day
+
Entries older than a week
+
+
At the bottom, it shows approximately how long ago data was last received,
+ or a short error message if an error occured.
+
+
+
+
+
+
About New Followers/Refollows
+
Everything that determines whether a follower is new or a refollow is
+ saved per session. So if you restart Chatty, it assumes that all followers
+ except from the first request are new. So if you start Chatty, open the
+ Followers Dialog on your channel, it will load the followers for the first
+ time and show none of them as new. Now if it updates a minute later, and there
+ are users it hasn't seen as having followed before, then it assumes these
+ users as new followers.
+
+
Now a user of course might have been a follower for a year, then unfollow
+ and follow again. Chances are that Chatty won't notice that and assume a new
+ follower. What it however does is that it only shows each user as new follower
+ once per session. So if someone follows and Chatty shows that user as a new follower,
+ then that user unfollows and follows again, Chatty will notice that the first
+ and the second follow time are different, and will show this user as a refollow
+ (the name slightly grey).
+
+
So this basicially just prevents the same user from e.g. making a sound
+ go off (if you have that enabled) several times just by refollowing several
+ times. At most that will happen once per session. Other than that
+ the data is mostly shown just as it comes in from Twitch. It will still
+ show refollows on the top of the list.
Chatty can help you with creating Highlights of your stream by recording
+ the stream time (how long the stream has been online) using a command or
+ hotkey. When you add a Stream Highlight in Chatty, it is written to a file
+ which you can then view later.
+
+
The following commands are available:
+
+
/addStreamHighlight [comment] - Adds a highlight at
+ the current time, with a comment if you want to.
+
/openStreamHighlights - Opens the file where the stream
+ highlights are stored in your default text editor.
+
+
+
You can also add a hotkey to add stream highlights, so you can also do it
+ yourself while streaming out of a game (given that global hotkeys work in
+ the game).
+
+
Allow your moderators to add highlights
+
You can also let your moderators add stream highlights
+ (!addStreamHighlight [comment]), but you first have to
+ change some settings:
+
+
+
/set streamHighlightChannel #<yourchannelname> to
+ allow moderators in the given channel to run the command
+
/set streamHighlightChannelRespond 1 to send a response to
+ chat when the mod command is used (otherwise the message is just shown locally)
+
/set streamHighlightCommand !highlight to set !highlight
+ as mod command
Both the ignore joins/parts and Twitch Client Version 3 option have
+ been removed. You can now disable the Correct Userlist
+ setting to not get any joins/parts if you think it could improve performance.
There are a few options you can launch Chatty with, that will override
+ settings loaded from the settings file:
+
+
+
-server <host/ip>
+
Specify a different server to connect to
+
+
-port <port>
+
Specify a different port to use for connecting
+
+
-user <username>
+
Your username
+
+
-password [password]
+
Login with password instead of access token, optionally
+ also the actual password to use. Twitch doesn't allow
+ password login anymore.
+
+
-token [token]
+
Login with the given token
+
+
-connect
+
Connect immediately when starting Chatty
+
+
-channel <channel>
+
The channel to join
+
+
-ds
+
Don't save settings on exit (settings are everything that is
+ saved between sessions like login data, always on top, ..)
+
+
-cd
+
Use current working directory (usually the directory you
+ start Chatty from) for saving/loading settings and other files.
+ This can be useful to make Chatty more portable or use several
+ different setting files on the same computer.
+
+
-set:<settingName> <setting value>
+
Change any setting that can be edited via the /set
+ command (see Setting Commands).
Settings are loaded from files when Chatty is started and saved into files
+ once it is closed. By default these files are saved in a subfolder
+ .chatty of your user directory. You can also use the
+ -cd commandline parameter to use the current working
+ directory instead. You can find out which folder is used by entering the
+ /dir command.
+
Since Version 0.4 of Chatty, the settings are no longer saved in a single
+ settings-file, but instead several files:
+
+
login: Contains the login data, including the access
+ token, which should be kept confidential.
+
favoritesAndHistory: Contains channel history and
+ favorites, as well as game favorites.
+
settings: The main file, which contains all customizations
+ made to Chatty that should not be confidential or private.
+
statusPresets: Contains status (title/game) presets
+ from the Admin Dialog.
If you are referring to a specific version of Chatty, please provide the
+ actual version number, which you can find on the top of the main help page in Chatty
+ (this one if you are reading this in Chatty, otherwise go to Chatty and open
+ Help - About/Help or press F1).
This application (except for the parts mentioned in the previous paragraph)
+ is released under the MIT License.
+
+
+Copyright (c) 2014 tduva
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.
+
+
+
diff --git a/help/style.css b/help/style.css
new file mode 100644
index 0000000..e66433a
--- /dev/null
+++ b/help/style.css
@@ -0,0 +1,130 @@
+body {
+ max-width: 700px;
+ font-size: 1em;
+ background-color: #FDFDFD;
+ font-family: Arial, sans-serif;
+ padding: 10px;
+ margin: 0;
+}
+h1 {
+ margin: 4px 0 5px 0;
+ font-size: 1.2em;
+ background-color: #EEEEEE;
+ padding: 3px;
+ border-bottom: 1px solid #AAAAAA;
+}
+h2 {
+ margin: 14px 0 0 0;
+ font-size: 1.1em;
+ border-bottom: 1px solid #AAAAAA;
+ padding-bottom: 2px;
+}
+h3 {
+ font-size: 1em;
+ margin: 10px 0 0 0;
+ padding: 0;
+}
+li ul {
+ margin-top:1px;
+ margin-bottom:3px;
+}
+li {
+ font-size: 1em;
+ margin-top: 2px;
+}
+.sub {
+ list-style-type: none;
+ margin-top: 0;
+}
+.top {
+ font-size: 0.75em;
+}
+code {
+ background-color: #EEEEEE;
+}
+cite {
+ background-color: #EEEEEE;
+}
+#backlink {
+ margin: 0 0 10px 0;
+}
+
+td {
+ padding: 10px;
+}
+
+table.settings {
+ border-collapse: collapse;
+ margin-top: 10px;
+}
+table.settings td {
+ padding: 3px;
+ margin: 0;
+ border: 1px solid #DDDDDD;
+}
+table.settings th {
+ padding: 0;
+ margin: 0;
+ border-bottom: 1px solid #000;
+}
+.setting {
+ font-family: monospace;
+}
+.settingExclusive {
+ background-color: #EEEEEE;
+}
+.settingNoCommandEdit {
+ color: #999999;
+}
+table.versionCompareTable {
+ border-collapse: collapse;
+}
+.versionCompareTable td {
+ padding: 2px;
+ margin: 0;
+}
+table.loginlinks {
+ border-collapse: collapse;
+}
+.loginlinks td {
+ padding: 2px;
+ border: 1px solid #DDDDDD;
+ text-align: center;
+}
+.loginlinks th {
+ padding: 2px;
+}
+
+table.files {
+ border-collapse: collapse;
+ margin-top: 10px;
+}
+
+.files td {
+ padding: 2px;
+ border: none;
+ text-align: left;
+ vertical-align: top;
+}
+
+.moreInfo {
+ padding: 7px;
+ font-style: italic;
+}
+.moreInfo a {
+ font-weight: bold;
+ font-style: normal;
+}
+.paragraphs dd {
+ padding-bottom: 4px;
+/* padding: 0 0 0 16px;
+ background-image: url(go-next.png);
+ background-repeat: no-repeat;*/
+}
+
+.defList {
+ margin-left: 20px;
+}
+.defList dt {
+ margin-top: 5px;
+}
\ No newline at end of file
diff --git a/help/userdialog.jpg b/help/userdialog.jpg
new file mode 100644
index 0000000..7f8c6fa
Binary files /dev/null and b/help/userdialog.jpg differ
diff --git a/help/usericons.jpg b/help/usericons.jpg
new file mode 100644
index 0000000..b11876d
Binary files /dev/null and b/help/usericons.jpg differ
diff --git a/help/viewerhistory_small.gif b/help/viewerhistory_small.gif
new file mode 100644
index 0000000..b9c67e1
Binary files /dev/null and b/help/viewerhistory_small.gif differ
diff --git a/humanized_time_span.js b/humanized_time_span.js
new file mode 100644
index 0000000..efddf4e
--- /dev/null
+++ b/humanized_time_span.js
@@ -0,0 +1,105 @@
+// Copyright (C) 2011 by Will Tomlins
+//
+// Github profile: http://github.com/layam
+//
+// Permission is hereby granted, free of charge, to any person obtaining a copy
+// of this software and associated documentation files (the "Software"), to deal
+// in the Software without restriction, including without limitation the rights
+// to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+// copies of the Software, and to permit persons to whom the Software is
+// furnished to do so, subject to the following conditions:
+//
+// The above copyright notice and this permission notice shall be included in
+// all copies or substantial portions of the Software.
+//
+// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+// IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+// FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+// AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+// LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+// OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+// THE SOFTWARE.
+
+
+function humanized_time_span(date, ref_date, date_formats, time_units) {
+ //Date Formats must be be ordered smallest -> largest and must end in a format with ceiling of null
+ date_formats = date_formats || {
+ past: [
+ { ceiling: 60, text: "$seconds seconds ago" },
+ { ceiling: 3600, text: "$minutes minutes ago" },
+ { ceiling: 86400, text: "$hours hours ago" },
+ { ceiling: 2629744, text: "$days days ago" },
+ { ceiling: 31556926, text: "$months months ago" },
+ { ceiling: null, text: "$years years ago" }
+ ],
+ future: [
+ { ceiling: 60, text: "in $seconds seconds" },
+ { ceiling: 3600, text: "in $minutes minutes" },
+ { ceiling: 86400, text: "in $hours hours" },
+ { ceiling: 2629744, text: "in $days days" },
+ { ceiling: 31556926, text: "in $months months" },
+ { ceiling: null, text: "in $years years" }
+ ]
+ };
+ //Time units must be be ordered largest -> smallest
+ time_units = time_units || [
+ [31556926, 'years'],
+ [2629744, 'months'],
+ [86400, 'days'],
+ [3600, 'hours'],
+ [60, 'minutes'],
+ [1, 'seconds']
+ ];
+
+ date = new Date(date);
+ ref_date = ref_date ? new Date(ref_date) : new Date();
+ var seconds_difference = (ref_date - date) / 1000;
+
+ var tense = 'past';
+ if (seconds_difference < 0) {
+ tense = 'future';
+ seconds_difference = 0-seconds_difference;
+ }
+
+ function get_format() {
+ for (var i=0; i
Extract the .zip into a folder of your choice and start Chatty.jar.
When you start Chatty the Connect Dialog should come up. Click Create login.. and Request login data and follow the instructions to authorize Chatty to connect to chat for you. There is also a short
- Getting Started Guide.
-
There is some help available (you can find the same in the program itself). There is also a changelog.
There is some help available (you can find the same in the program itself). There is also a changelog.
You can use this banner if you like Chatty and want to promote it. Just link to http://getchatty.sourceforge.net please. :)
Feedback (Feature requests, Bug reports)
@@ -221,11 +221,11 @@ function loaded() {
Chatty provides a different way of using Twitch Chat and has a lot of features you may find useful.
Does Chatty support Twitch Group Chat?
-
No. However, you can manually connect to Group Chat by changing the server/port to connect to (you can change it in the Settings under Advanced, use the 'server' and 'port'
- settings, the /server command or commandline parameters) and looking up the channel name yourself
+
No. However, you can manually connect to Group Chat by changing the server/port to connect to (you can change it in the Settings under Advanced, use the 'server' and 'port'
+ settings, the /server command or commandline parameters) and looking up the channel name yourself
(you can use this blogpost for help on that). There are a few drawbacks: Since Chatty can currently only
connect to one server at a time, you would have to run more than one instance if you want to use regular Twitch Chat at the same
- time. Use this guide in the help for more information. It also wouldn't recognize the channel as a group chat channel, so some stuff
+ time. Use this guide in the help for more information. It also wouldn't recognize the channel as a group chat channel, so some stuff
might not work correctly.
Is Group Chat support planned?
@@ -241,13 +241,13 @@ function loaded() {
Sometimes the Twitch API will return a stream as offline, even though it isn't. Chatty checks the API twice before reporting a stream as offline, but if both checks return false data, then a false offline report will happen.
Why does the userlist only contain users that send a message?
-
Check what Twitch Client Version you have set under Settings - Advanced. Learn more about what that does in the Settings Help. Otherwise this may just be Twitch not sending the userlist, which can sometimes happen (especially on larger channels).
+
Check what Twitch Client Version you have set under Settings - Advanced. Learn more about what that does in the Settings Help. Otherwise this may just be Twitch not sending the userlist, which can sometimes happen (especially on larger channels).
Why do I see much less messages in Chatty compared to webchat?
-
If you receive fewer/not the same messages on a particular channel compared to webchat, then webchat is probably using the Event Chat servers for that channel. They are a seperate group from servers than the normal ones you get when connecting to irc.twitch.tv. See: Join Eventchat.
+
If you receive fewer/not the same messages on a particular channel compared to webchat, then webchat is probably using the Event Chat servers for that channel. They are a seperate group from servers than the normal ones you get when connecting to irc.twitch.tv. See: Join Eventchat.
diff --git a/twitter.png b/twitter.png
new file mode 100644
index 0000000..52846b1
Binary files /dev/null and b/twitter.png differ
diff --git a/version.txt b/version.txt
new file mode 100644
index 0000000..75eff58
--- /dev/null
+++ b/version.txt
@@ -0,0 +1 @@
+0.8 Implemented Twitch Chat updates, new BTTV/FFZ APIs, better TAB completion, and much more..
\ No newline at end of file
Chatty Beta to main page
+
+
+
+
diff --git a/help/help-issues.html b/help/help-issues.html
new file mode 100644
index 0000000..74b4291
--- /dev/null
+++ b/help/help-issues.html
@@ -0,0 +1,154 @@
+
+
+ 