From b18562ffa195d12a8aa33b21e6c481133f9bcd0c Mon Sep 17 00:00:00 2001
From: tduva <chattyclient@gmail.com>
Date: Wed, 27 Mar 2019 05:22:33 +0100
Subject: [PATCH] v0.9.6 updates

---
 help/help-custom_commands.html | 80 +++++++++++++++++++++++++++++++++-
 help/help-releases.html        | 51 +++++++++++++++++++++-
 help/help-settings.html        | 22 +++++++++-
 help/help-troubleshooting.html | 11 +++--
 help/help.html                 |  3 +-
 help/style.css                 |  3 ++
 index.html                     | 18 ++++----
 7 files changed, 171 insertions(+), 17 deletions(-)

diff --git a/help/help-custom_commands.html b/help/help-custom_commands.html
index 9ef0ea5..40a40f0 100644
--- a/help/help-custom_commands.html
+++ b/help/help-custom_commands.html
@@ -13,7 +13,9 @@
         <li>
             <a href="#custom-commands">Custom Commands</a>
             <ul>
+                <li><a href="#restrict-channel">Restrict to channel</a></li>
                 <li><a href="#anonymous-custom-commands">Anonymous Custom Commands</a></li>
+                <li><a href="#chain-commands">Chaining Commands</a></li>
             </ul>
         </li>
         <li>
@@ -61,6 +63,9 @@
         <code>Hello World!</code> to chat, just as if you would have written it
         yourself and pressed Enter.</p>
     
+    <p>See <a href="#replacements">Replacements</a> for more advanced usage.</p>
+    
+    <h3><a name="restrict-channel">Restrict to channel</a></h3>
     <p>Adding a <code>#</code> and a channel name you can restrict the command
         to that channel:</p>
     
@@ -91,6 +96,11 @@
         <dd>Outputs <code>Open Channels: joshimuz lotsofs cirno_tv</code></dd>
     </dl>
     
+    <h3><a name="chain-commands">Chaining Commands</a></h3>
+    <p>Executing several commands in a row is not a feature of Custom Commands,
+        although the <a href="help.html#commands-chain">/chain command</a> can
+        be used to achieve something like that.</p>
+    
     <h2><a name="replacements">Replacements</a></h2>
     <ul>
         <li><a href="#simple-replacements">Simple Replacements</a></li>
@@ -162,7 +172,7 @@
     
     <p>The short notation ( <code>$1</code> ) only works for the numbers 1 to 9,
         which usually should be enough. For other kinds of replacements you must
-        use the regular notation including parentheses: <code>$(1)</code> .</p>
+        use the regular notation including parentheses: <code>$(10)</code> .</p>
     
     <h3><a name="parameters-context">Pre-defined Parameters</a></h3>
     <p>Custom Commands can be used in a number of different places. Depending on
@@ -339,8 +349,76 @@
             with <code>1-</code> referring to <code>apple pie</code> turns into
             either <code>cheesecake</code>, <code>strawberry cake</code> or
             <code>apple pie</code>.</dd>
+        
+        <dt><code>$randnum(&lt;from&gt;,&lt;to&gt;)</code> or <code>$randnum(&lt;to&gt;)</code></dt>
+        <dd>Randomly chooses a number in the given range (inclusive). If only
+            one number is given, it the range is 0 to the given number. If the
+            "from" is not a number, it defaults to 0, if the "to" is not a
+            number it defaults to a really big number.</dd>
+        <dd><em>Example:</em> <code>$randnum(600,800)</code> chooses a random
+            number between 600 and 800.</dd>
+        <dd><em>Example:</em> <code>$randum($$1)</code> chooses a random number
+            between 0 and what is the first parameter.</dd>
+        
+        <dt><code>$datetime([format],[timezone],[locale])</code></dt>
+        <dd>Outputs the current date/time. You can optionally give a format
+            pattern (based on <a href="https://docs.oracle.com/javase/8/docs/api/java/time/format/DateTimeFormatter.html#patterns">DateTimeFormatter</a>),
+            a timezone (based on <a href="https://docs.oracle.com/javase/8/docs/api/java/time/ZoneId.html">ZoneId</a>,
+            although something like "New York" should also work) and a locale
+            (a language tag such as "en").</dd>
+        <dd>Predefined formats:
+            <ul style="margin-top:0">
+                <li>Short: <code>date</code>, <code>time</code>, <code>datetime</code></li>
+                <li>With timezone: <code>date2</code>, <code>time2</code>, <code>datetime2</code></li>
+                <li>Locale-specific: Append <code>_short</code>, <code>_medium</code>,
+            <code>_long</code> or <code>_full</code>, e.g. <code>datetime_full</code></li>
+            </ul>
+        </dd>
+        <dd>
+            <em>Examples:</em>
+            <dl style="margin-top:0">
+                <dt><code>$datetime()</code></dt>
+                <dd><code>Wednesday, March 13, 2019 3:11:48 PM CET</code></dd>
+                <dd>(Default format depends on the locale, in this case using the system default.)</dd>
+                
+                <dt><code>$datetime(,,de)</code></dt>
+                <dd><code>Mittwoch, 13. März 2019 15:12 Uhr MEZ</code></dd>
+                <dd>(Default format depends on the locale, in this case explicitly specified.)</dd>
+                
+                <dt><code>$datetime(time)</code></dt>
+                <dd><code>23:31:27</code></dd>
+                <dd>(Using one of the pre-defined formats "<code>time</code>".)</dd>
+                
+                <dt><code>$datetime(datetime2,Vancouver)</code></dt>
+                <dd><code>2019-03-12 15:31:45 PDT GMT-0700</code></dd>
+                <dd>(Using the more verbose "<code>datetime2</code>" pre-defined format, with a timezone specified.)</dd>
+                
+                <dt><code>$datetime(datetime_full,Rome,it)</code></dt>
+                <dd><code>mercoledì 13 marzo 2019 15.32.03 CET</code></dd>
+                <dd>(Using one of the locale-specific pre-defined formats, with timezone and locale specified.)</dd>
+                
+                <dt><code>$datetime(,london)</code></dt>
+                <dd><code>Wednesday, March 13, 2019 2:16:36 PM GMT</code></dd>
+                <dd>(Empty format to be able to specify timezone.)</dd>
+                
+                <dt><code>$datetime(HH:mm:ss zzzz,Tokyo,en)</code></dt>
+                <dd><code>07:50:20 Japan Standard Time</code></dd>
+                <dd>(Output is usually based on your system language, but you
+                    can also explicitely specify it.)</dd>
+                
+                <dt><code>$datetime(eeee\, dd. MMMM yyyy,,de)</code></dt>
+                <dd><code>Dienstag, 12. März 2019</code></dd>
+                <dd>(Custom format, <code>,</code> escaped since it normally
+                    separates function parameters, empty timezone in order to be
+                    able to specify locale.)</dd>
+            </dl>
     </dl>
     
+    <p class="note"><em>Tip:</em> Enter e.g. <code>//echo $datetime()</code>
+        into the chat inputbox to test a function directly, use arrow up/down
+        keys to cycle through previous inputs. Of course you won't be able to
+        use some context dependant parameters this way.</p>
+    
     <p class="note"><em>Note:</em> The <code>&lt;identifier&gt;</code> parameter means <em>only</em>
         the identifier, without any <code>$</code>, while the other parameters
         may contain replacements (including functions). You can think of this
diff --git a/help/help-releases.html b/help/help-releases.html
index 7b4d7e4..bf39cd3 100644
--- a/help/help-releases.html
+++ b/help/help-releases.html
@@ -17,6 +17,7 @@
     <h1><a name="top">Release Information</a></h1>
     
     <p>
+        <a href="#0.9.6">0.9.6</a> |
         <a href="#0.9.5">0.9.5</a> |
         <a href="#0.9.4">0.9.4</a> |
         <a href="#0.9.3">0.9.3</a> |
@@ -55,7 +56,55 @@
     full list of changes.</p>
     
     <h2>
-        <a name="0.9.5">Version 0.9.5</a> <a name="latest">(This one!)</a> (2019-02-14)
+        <a name="0.9.6">Version 0.9.6</a> <a name="latest">(This one!)</a> (2019-03-27)
+        <a href="#top" class="top">[back to top]</a>
+    </h2>
+    <p>The new clickable mentions feature allows you to open the User Dialog by
+        clicking not only on the usernames in front of the messages, but also on
+        names that are mentioned within the messages themselves (as long as the
+        mentioned user has recently chatted). In addition, hovering your mouse
+        over a mention marks the username in chat temporarily.</p>
+    
+    <pre>
+### Chat
+- Added clickable mentions for users who have recently chatted (configurable in
+  "Names" settings with different styling options)
+- Hovering mention in chat with the mouse now temporarily marks that user
+  (configurable in "Names" settings with different options on what triggers it)
+- Mark Highlight/Ignore matches in more places, such as links or mentions
+  (toggle in "Highlight" settings)
+- Improved support for some new Twitch Chat messages
+- Switched GIF decoder (which should fix some previously broken Animated GIFs)
+
+### Custom Commands / Customization
+- Added Custom Command functions `$datetime()` and `$randnum()`
+- Added "vip" to `$mod` Custom Usericon position
+- Added general "Info Message" Notification type
+- Added hotkey actions for 120s and 180s commericals
+- Added hotkey action to toggle Channel Favorites dialog
+
+### Other
+- Changed image cache structure to improve startup time
+- Made some timing methods independent of system clock
+- Added default fallback font (Unifont) to Windows Standalone
+- Added commands for fallback font directory
+- Increased/added character limit for some input fields
+- Livestreamer Dialog: Don't reset size/position as often
+- Updated localization strings
+- Updated help
+
+### Bugfixes
+- Fixed bug that would cause the wrong element to be clicked sometimes
+- Fixed error when trying to insert Emote from Emote Dialog into full inputbox
+- Fixed loading of English (UK) strings
+- Fixed User Dialog opening position being wrong with some taskbar locations
+- Fixed custom emotes not showing in Emote Dialog favorites tab
+- Fixed marked word (rectangle) style on some backgrounds
+- Fixed some Emoji having an unrendered character behind them
+    </pre>
+    
+    <h2>
+        <a name="0.9.5">Version 0.9.5</a> (2019-02-14)
         <a href="#top" class="top">[back to top]</a>
     </h2>
     <p>Twitch released the Stream Tags API for third-party developers, so Chatty
diff --git a/help/help-settings.html b/help/help-settings.html
index 3a29893..66fceb3 100644
--- a/help/help-settings.html
+++ b/help/help-settings.html
@@ -1354,6 +1354,18 @@
         <dd>Any Chat Message (including highlighted ones, in this case
             the order of list entries can matter).</dd>
         
+        <dt>Info Message</dt>
+        <dd>Most messages that are not regular Chat Messages, by default shown
+            in blue color (e.g. joining a channel, channel state change, command
+            responses, sub notifications, and more).</dd>
+        <dd>A few of these messages are output in all open channels at once
+            (e.g. "Disconnected" message), which would trigger a notification
+            for each channel.</dd>
+        <dd>This will trigger at the same time as some other event types, e.g.
+            Subscriber Notification, so make sure you're not using both of them
+            at the same time, or using text or channel matching to restrict it
+            accordingly.</dd>
+        
         <dt>Whisper</dt>
         <dd>Any Whisper message (including highlighted ones).</dd>
 
@@ -1589,8 +1601,16 @@
         <a name="Commands">Commands</a>
         <a href="#top" class="top">[back to menu]</a>
     </h2>
+    <p>This settings page allows you to do the following, which is explained in
+        more detail on another page:</p>
     
-    <div class="moreInfo">This help is on a separate page: <a href="help-custom_commands.html">Custom Commands &amp; Context Menus</a></div>
+    <ul>
+        <li><a href="help-custom_commands.html#custom-commands">Add Custom Commands</a>, which
+            are basicially aliases for anything you could also enter directly
+            into the inputbox.</li>
+        <li><a href="help-custom_commands.html#menus">Customize the User Dialog and various Context Menus</a>
+            using Custom Commands and similiar syntax.</li>
+    </ul>
     
     
     <h2>
diff --git a/help/help-troubleshooting.html b/help/help-troubleshooting.html
index d7ddcfb..c6eae0b 100644
--- a/help/help-troubleshooting.html
+++ b/help/help-troubleshooting.html
@@ -201,10 +201,13 @@
         (you may have to create the <code>/fallback</code> directory yourself):
         <code>&lt;JRE_DIR&gt;/lib/fonts/fallback</code></p>
     
-    <p>To find the <code>&lt;JRE_DIR&gt;</code> location you can either enter
-        the command <code>/openJavaDir</code> to open the directory in your file
-        browser or enter the command <code>/showJavaDir</code> to output the
-        path. The commands have to be entered in the Chatty chat inputbox.</p>
+    <p>To find it you can use the command <code>/showFallbackFontDir</code> to
+        output the full path or the command <code>/openFallbackFontDir</code> to
+        directly open the path in your file browser. The commands have to be
+        entered into the Chatty chat inputbox.</p>
+    
+    <p>The Windows Standalone already contains the <a href="http://unifoundry.com/unifont/index.html">Unifont</a>
+        fonts as fallback fonts by default.</p>
     
     <p><em>Note:</em> If you set the <code>inputFont</code>
         <a href="help-setting_commands.html#font">setting</a> to something other
diff --git a/help/help.html b/help/help.html
index a7a7346..31a7e6c 100644
--- a/help/help.html
+++ b/help/help.html
@@ -5,7 +5,7 @@
         <link rel="stylesheet" type="text/css" href="style.css" />
 </head>
 <body>
-    <h1><a name="top">Chatty (Version: 0.9.5)</a></h1>
+    <h1><a name="top">Chatty (Version: 0.9.6)</a></h1>
     <table>
         <tr>
             <td valign="top">
@@ -245,6 +245,7 @@
         <li><code>/showBackupDir</code> / <code>/openBackupDir</code> - Show/open the <a href="help-guide_folders.html#backup">backup directory</a></li>
         <li><code>/showDebugDir</code> / <code>/openDebugDir</code> - Show/open the debug log directory</li>
         <li><code>/showJavaDir</code> / <code>/openJavaDir</code> - Show/open the directory of the JRE used by Chatty</li>
+        <li><code>/showFallbackFontDir</code> / <code>/openFallbackFontDir</code> - Show/open the directory where Java looks for <a href="help-troubleshooting.html#font">fallback fonts</a></li>
         <li><code>/showTempDir</code> / <code>/openTempDir</code> - Show/open the system's temp directory</li>
         <li><code>/refresh &lt;emoticons/badges/ffz/ffzglobal/bttvemotes/emotesets&gt;</code>
             - Refresh the given data from it's respective API:
diff --git a/help/style.css b/help/style.css
index ce8ecce..ad1d749 100644
--- a/help/style.css
+++ b/help/style.css
@@ -146,6 +146,9 @@ table.files {
 .defList dt {
     margin-top: 5px;
 }
+.defList dd {
+    margin-top: 3px;
+}
 
 .dl-settings {
     margin-left: 20px;
diff --git a/index.html b/index.html
index 4738f11..64f2e6a 100644
--- a/index.html
+++ b/index.html
@@ -16,9 +16,9 @@ function loaded() {
 		      { ceiling: null,  text: "$years years ago" }
 		]
 	}
-	document.getElementById("ago").innerHTML = "Version 0.9.5 released "+humanized_time_span("2019/02/14", Date(), custom_date_formats)+"";
+	document.getElementById("ago").innerHTML = "Version 0.9.6 released "+humanized_time_span("2019/03/27", Date(), custom_date_formats)+"";
 
-	getDownloads("v0.9.5");
+	getDownloads("v0.9.6");
 
 	slideshow_init("slideshow");
 }
@@ -157,7 +157,7 @@ function getDownloads(tag) {
 
 
 	<h2 id="download">Download</h2>
-	<p>Choose one of the following downloads of <strong>Chatty Version 0.9.5</strong><span id="dlCount" style="margin-bottom:7px;"></span>. For older versions or betas go to <a href="https://github.com/chatty/chatty/releases">GitHub</a>.</p>
+	<p>Choose one of the following downloads of <strong>Chatty Version 0.9.6</strong><span id="dlCount" style="margin-bottom:7px;"></span>. For older versions or betas go to <a href="https://github.com/chatty/chatty/releases">GitHub</a>.</p>
 	<p>If this is your first time using Chatty check out the <a href="help/help-getting-started.html"><strong>Getting Started Guide</strong></a>.</p>
 
 	<h3>Windows</h3>
@@ -169,11 +169,11 @@ function getDownloads(tag) {
 		<tr>
 			<td>
 				<dl>
-					<dt><a href="https://github.com/chatty/chatty/releases/download/v0.9.5/Chatty_0.9.5_win_standalone_setup.exe"><strong>Download Windows Standalone (Installer)</strong></a> <span class="recommended"><sup>Recommended</sup></span></dt>
+					<dt><a href="https://github.com/chatty/chatty/releases/download/v0.9.6/Chatty_0.9.6_win_standalone_setup.exe"><strong>Download Windows Standalone (Installer)</strong></a> <span class="recommended"><sup>Recommended</sup></span></dt>
 					<dd>Install into a folder of your choice and start <code>Chatty.exe</code> (or optionally created shortcuts).</dd>
 				</dl>
 				<dl>
-					<dt><a href="https://github.com/chatty/chatty/releases/download/v0.9.5/Chatty_0.9.5_win_standalone.zip">Download Windows Standalone (.zip)</a></dt>
+					<dt><a href="https://github.com/chatty/chatty/releases/download/v0.9.6/Chatty_0.9.6_win_standalone.zip">Download Windows Standalone (.zip)</a></dt>
 					<dd>Extract the .zip into a folder of your choice and start <code>Chatty.exe</code>.</dd>
 				</dl>
 
@@ -181,13 +181,13 @@ function getDownloads(tag) {
 			</td>
 			<td>
 				<dl>
-					<dt><a href="https://github.com/chatty/chatty/releases/download/v0.9.5/Chatty_0.9.5_win_setup.exe">Download JAR-Version (Installer)</a></dt>
+					<dt><a href="https://github.com/chatty/chatty/releases/download/v0.9.6/Chatty_0.9.6_win_setup.exe">Download JAR-Version (Installer)</a></dt>
 					<dd>Can select global hotkey support during installation.</dd>
 					<dd>Install into a folder of your choice and start <code>Chatty.jar</code> (or optionally created shortcuts).</dd>
 				</dl>
 				<dl>
-					<dt><a href="https://github.com/chatty/chatty/releases/download/v0.9.5/Chatty_0.9.5.zip">Download JAR-Version (.zip)</a></dt>
-					<dd>Also available with global hotkey support for <a href="https://github.com/chatty/chatty/releases/download/v0.9.5/Chatty_0.9.5_hotkey_32bit.zip">32bit-Java</a> / <a href="https://github.com/chatty/chatty/releases/download/v0.9.5/Chatty_0.9.5_hotkey_64bit.zip">64bit-Java</a></dd>
+					<dt><a href="https://github.com/chatty/chatty/releases/download/v0.9.6/Chatty_0.9.6.zip">Download JAR-Version (.zip)</a></dt>
+					<dd>Also available with global hotkey support for <a href="https://github.com/chatty/chatty/releases/download/v0.9.6/Chatty_0.9.6_hotkey_32bit.zip">32bit-Java</a> / <a href="https://github.com/chatty/chatty/releases/download/v0.9.6/Chatty_0.9.6_hotkey_64bit.zip">64bit-Java</a></dd>
 					<dd>Extract the .zip into a folder of your choice and start <code>Chatty.jar</code>.</dd>
 				</dl>
 			</td>
@@ -195,7 +195,7 @@ function getDownloads(tag) {
 	</table>
 
 	<h3>Non-Windows</h3>
-	<p>For OS other than Windows (e.g. Linux or MacOS) you will need to download the <a href="https://github.com/chatty/chatty/releases/download/v0.9.5/Chatty_0.9.5.zip">JAR-Version (.zip)</a> and must have Java 8 or later installed on your system. Extract the .zip into a folder of your choice and start <code>Chatty.jar</code>.</p>
+	<p>For OS other than Windows (e.g. Linux or MacOS) you will need to download the <a href="https://github.com/chatty/chatty/releases/download/v0.9.6/Chatty_0.9.6.zip">JAR-Version (.zip)</a> and must have Java 8 or later installed on your system. Extract the .zip into a folder of your choice and start <code>Chatty.jar</code>.</p>
 
 	<h2 id="feedback">Contact</h2>
 	<p>If you have any feedback or questions feel free to contact me. You can <a href="https://discord.gg/WTuqGeJ">join the Chatty Discord</a> <sup>preferred</sup>, write me an <a href="mailto:chattyclient@gmail.com">E-Mail</a> or use <a href="https://twitter.com/chattyclient">Twitter</a>.</p>