v0.23 files

help/help-custom_commands.html

@@ -233,7 +233,7 @@
             <th>Description</th>
         </tr>
         <tr>
-            <th rowspan="9"><em>All</em></th>
+            <th rowspan="4"><em>All</em></th>
             <td><code>chan</code></td>
             <td>The current channel context (without leading #)</td>
         </tr>
@@ -248,27 +248,8 @@
                 without leading #)</td>
         </tr>
         <tr>
-            <td><code>streamstatus</code></td>
+            <td><code>stream...</code></td>
-            <td>Stream Status (Title/Game or Offline)</td>
+            <td><a href="#stream-identifiers">Stream Info (e.g. uptime, stream title) identifiers</a></td>
-        </tr>
-        <tr>
-            <td><code>streamtitle</code></td>
-            <td>Stream Title (only if live)</td>
-        </tr>
-        <tr>
-            <td><code>streamgame</code></td>
-            <td>Stream Game (only if live)</td>
-        </tr>
-        <tr>
-            <td><code>streamviewers</code></td>
-            <td>Number of viewers (only if live)</td>
-        </tr>
-        <tr>
-            <td><code>streamuptime</code></td>
-            <td>Stream Uptime (only if live)</td>
-        </tr>
-        <tr>
-            <td colspan="2">The stream info is of the current channel context</td>
         </tr>
         <!-- User Context Menu -->
         <tr>
@@ -417,6 +398,20 @@
         <li><code>user-channel</code> - The name of the channel the user talked in (with leading # if applicable)</li>
     </ul>
     
+    <h3><a name="stream-identifiers">Stream Info Identifiers</a></h3>
+    <p>The stream info is of the current channel context, if available.</p>
+    <ul>
+        <li><code>streamstatus</code> - Stream Status ("Title (Game)" or "Offline")</li>
+    </ul>
+    <p>Only available if live:</p>
+    <ul>
+        <li><code>streamtitle</code> - Stream Title</li>
+        <li><code>streamgame</code> - Stream Game</li>
+        <li><code>streamviewers</code> - Number of viewers</li>
+        <li><code>streamuptime</code> - Stream Uptime, ignoring short breaks as shown in the Chatty titlebar</li>
+        <li><code>streamuptime2</code> - Actual Stream Uptime as reported by Twitch directly</li>
+    </ul>
+    
     <h3>Pre-defined Parameters Example</h3>
     <dl class="defList">
         <dt><code>/streaminfo /echo [Stream Status] $(streamstatus) [Uptime] $(streamuptime)</code></dt>
@@ -452,6 +447,7 @@
             <a href="#func-lower">$lower()</a>,
             <a href="#func-upper">$upper()</a>,
             <a href="#func-trim">$trim()</a>,
+            <a href="#func-quote">$quote()</a>,
             <a href="#func-replace">$replace()</a>,
             <a href="#func-rand">$rand()</a>,
             <a href="#func-sort">$sort()</a>,
@@ -519,6 +515,14 @@
             <a href="https://docs.oracle.com/en/java/javase/17/docs/api/java.base/java/lang/String.html#trim%28%29">String.trim()</a> method).</dd>
         <dd><em>Example:</em> <code>$trim( abc )</code> turns into <code>abc</code>.</dd>
         
+        <dt><a name="func-quote"><code>$quote(&lt;input&gt;,[quote character])</code></a></dt>
+        <dd>Add quotes around the input. Any quotes in input will be doubled.
+            A custom quote character can be specified, by default a double-quote
+            (<code>"</code>) is used.</dd>
+        <dd><em>Example:</em> <code>$quote(51° 28' 38" N)</code> turns into
+            <code>"51° 28' 38"" N"</code> and <code>$quote(51° 28' 38" N,')</code>
+            turns into <code>'51° 28'' 38" N'</code>.</dd>
+        
         <dt><a name="func-replace"><code>$replace(&lt;input&gt;,&lt;search&gt;,&lt;replace&gt;,[method])</code></a></dt>
         <dd>Search and replace in text.</dd>
         <dd>Especially when using Regex, remember

help/help-guide_folders.html

@@ -32,7 +32,7 @@
     <p>Learn what directories and files Chatty creates/uses.</p>
 
     <h2><a name="files">Files / Directory structure</a></h2>
-    <h3>Settings Directory</h3>
+    <h3><a name="settings-dir">Settings Directory</a></h3>
         <p>The settings directory by default is in your user home directory in a
             subdirectory called <code>.chatty</code>. You can enter the command
             <code>/dir</code> to display and <code>/openDir</code> to open the
@@ -89,7 +89,7 @@
         </tr>
         <tr>
             <td>|-- cache</td>
-            <td class="fileCommentFolder">[Directory]</td>
+            <td class="fileCommentFolder">[Directory] (<a href="#customize">customize</a>)</td>
         </tr>
         <tr>
             <td>|&nbsp; &nbsp;|- &lt;cache files&gt;</td>
@@ -101,7 +101,7 @@
         </tr>
         <tr>
             <td>|-- debuglogs</td>
-            <td class="fileCommentFolder">[Directory]</td>
+            <td class="fileCommentFolder">[Directory] (<a href="#customize">customize</a>)</td>
         </tr>
         <tr>
             <td>|&nbsp; &nbsp;|- &lt;debug files&gt;</td>
@@ -113,19 +113,23 @@
         </tr>
         <tr>
             <td>|-- exported</td>
-            <td class="fileCommentFolder">[Directory]</td>
+            <td class="fileCommentFolder">[Directory] (<a href="#customize">customize</a>)</td>
         </tr>
         <tr>
             <td>|&nbsp;&nbsp;&nbsp;|-&nbsp;stream_highlights.txt</td>
             <td class="fileComment">Recorded <a href="help.html#streamhighlights">stream highlights</a></td>
         </tr>
+        <tr>
+            <td>|&nbsp;&nbsp;&nbsp;|-&nbsp;&lt;exported text&gt;</td>
+            <td class="fileComment"><a href="help.html#commands-system">/exportText command</a> output</td>
+        </tr>
         <tr>
             <td>|</td>
             <td></td>
         </tr>
         <tr>
             <td>|-- logs</td>
-            <td class="fileCommentFolder">[Directory]</td>
+            <td class="fileCommentFolder">[Directory] (<a href="#customize">customize</a>)</td>
         </tr>
         <tr>
             <td>|&nbsp; &nbsp;|- &lt;log files&gt;</td>
@@ -188,7 +192,7 @@
         </tr>
         <tr>
             <td>|-- sounds</td>
-            <td class="fileCommentFolder">[Folder] Sound files for Notifications</td>
+            <td class="fileCommentFolder">[Folder] Sound files for Notifications (<a href="#customize">customize</a>)</td>
         </tr>
         <tr>
             <td>|&nbsp; &nbsp;|- &lt;sound&gt;.wav</td>
@@ -196,7 +200,7 @@
         </tr>
         <tr>
             <td>|-- img</td>
-            <td class="fileCommentFolder">[Folder] Image files for Custom Badges</td>
+            <td class="fileCommentFolder">[Folder] Image files for Custom Badges (<a href="#customize">customize</a>)</td>
         </tr>
         <tr>
             <td>|&nbsp;&nbsp;&nbsp;|-&nbsp;&lt;various&nbsp;images&gt;</td>
@@ -208,6 +212,22 @@
     <p>This is where the Chatty.jar is located and is used for loading libraries
     that Chatty uses.</p>
     
+    <h3><a name="customize">Customize</a></h3>
+    <p>Some folders can be changed:</p>
+    <ul>
+        <li>Settings directory: See <a href="#settings-dir">Settings Directory</a>
+            (this one also affects the default location of some other folders)</li>
+        <li>Debuglogs: Using the <code>-debugdir</code> <a href="help.html#launch">launch option</a></li>
+        <li>Logs: In the Settings under "Log to file"</li>
+        <li>Cache: In the Settings under "Other"</li>
+        <li>Exported files: In the Settings under "Other"</li>
+        <li>Images: In the Settings under "Other"</li>
+        <li>Sounds: In the Settings under "Notifications"</li>
+    </ul>
+    
+    <p>Changing folders usually requires a restart of Chatty to be properly
+        applied.</p>
+    
     <h2><a name="uninstall">Uninstall</a></h2>
     <p>To remove Chatty from your computer:</p>
     

help/help-laf.html

@@ -500,6 +500,12 @@
                 <td>Use some inactive window colors for the Noir Look&amp;Feel, on/off</td>
                 <td></td>
             </tr>
+            <tr>
+                <td>provideErrorFeedback</td>
+                <td></td>
+                <td>When set to "off" it won't play an error sound for some invalid actions (e.g. backspacing on an empty input field), on/off</td>
+                <td></td>
+            </tr>
             <!-- ########################### -->
             <tr>
                 <th colspan="4"><a name="chatty">Chatty Properties (any Look & Feel)</a></th>

help/help-releases.html

@@ -17,6 +17,7 @@
     <h1><a name="top">Release Information</a></h1>
     
     <p>
+        <a href="#0.23">0.23</a> |
         <a href="#0.22">0.22</a> |
         <a href="#0.21">0.21</a> |
         <a href="#0.20">0.20</a> |
@@ -71,7 +72,43 @@
     full list of changes.</p>
     
     <h2>
-        <a name="0.22">Version 0.22</a> <a name="latest">(This one!)</a> (2023-01-15)
+        <a name="0.23">Version 0.23</a> <a name="latest">(This one!)</a> (2023-02-17)
+        <a href="#top" class="top">[back to top]</a>
+    </h2>
+    <pre>
+### Twitch Features
+- Added support for new stream tags API
+  - Up to 10 tags, max 25 characters, no spaces or special characters
+  - Existing favorited/Status History tags automatically get their spaces
+    removed, however you will need to replace any special characters yourself as
+    you see fit
+- Added `/shoutout` command and display of shoutouts for moderators
+
+### Custom Commands 
+- Changed "Test" dialog output to be less wide with long commands
+- Added some syntax highlighting to some settings
+- Added function `$quote()` for easier quoting (e.g. to write CSV)
+
+### Other
+- Added settings to customize cache, image and exported directories, added
+  launch option to customize debug directory
+- Added a setting (disabled by default) for the Look&Feel error sound (e.g. when
+  backspacing at the start of an input field)
+- Removed session debug log file
+- Added Stream Highlights customization settings for file output
+- Improved Pronouns caching
+- "Open URL" Popup: Added checkbox to disable the popup, apply setting to some
+  more places
+- Updated help
+
+### Bugfixes
+- Fixed Join-link (e.g. for raids) context menu entries
+- Fixed Stream Highlights error when customized chat response message wasn't a
+  valid Custom Command
+    </pre>
+    
+    <h2>
+        <a name="0.22">Version 0.22</a> (2023-01-15)
         <a href="#top" class="top">[back to top]</a>
     </h2>
     <pre>

help/help-report_issue.html

@@ -63,16 +63,10 @@
         the command <code>/openDebugDir</code> to open it directly (or
         <code>/showDebugDir</code> to output it's path).</p>
 
-    <p>There are two kinds of debug files:</p>
+    <p>The directory contains several rotating files (<code>debug0.log, debug1.log, ..</code>),
-    <ul>
+            that are not overwritten when Chatty is restarted. Normally
-        <li>Several rotating files (<code>debug0.log, debug1.log, ..</code>),
+            <code>debug0.log</code> is a good place to start when looking for
-            that are not overwritten when Chatty is restarted, so it's usually a
+            recent information.</p>
-            good way to find older logs. Normally <code>debug0.log</code> is a
-            good place to start.</li>
-        <li>The <code>debug_session.log</code> which is overwritten everytime
-            you start Chatty. This could be good if you haven't restarted Chatty
-            yet.</li>
-    </ul>
 </body>
 </html>
     

help/help-settings.html

@@ -160,7 +160,7 @@
         <li><code>$all</code> - All users, this can be used to specify a default
         color (should be put at the very end of the list)</li>
         <li><code>$broadcaster</code> - Broadcasters</li>
-        <li><code>$cat:&lt;category&gt;</code> - A category from the <a href="help.html#addressbook">Addressbook</a></li>
+        <li><code>$cat:&lt;category&gt;</code> - A category from the <a href="help-addressbook.html">Addressbook</a></li>
         <li><code>#&lt;color code&gt;</code> - A Html color code, e.g. <code>#0000FF</code> for blue, which can
             be used to replace colors</li>
         <li><code>$color:&lt;color code or name&gt;</code> - A Html color code or name (names
@@ -969,7 +969,7 @@
             Behaves like the <code>regm:</code>/<code>re:</code> prefix, in that
             it always tries to match the entire username. Example:
             <code>reuser:(?i)a.*</code> would match all names starting with "a".</li>
-        <li><code>cat:</code> - One or several (comma separated) <a href="help.html#addressbook">Addressbook</a>
+        <li><code>cat:</code> - One or several (comma separated) <a href="help-addressbook.html">Addressbook</a>
             categories. The user who send the message must be in at least one of them.
             Example: <code>cat:friends,family</code> (the user must be in "friends" or "family", or both)</li>
         <li><code>!cat:</code> - One or several Addressbook categories.
@@ -978,7 +978,7 @@
             have been sent in. Example: <code>chan:joshimuz,tirean</code></li>
         <li><code>!chan:</code> - One or several channels the message must
             <em>not</em> have been sent in.</li>
-        <li><code>chanCat:</code> - One or several <a href="help.html#addressbook">Addressbook</a>
+        <li><code>chanCat:</code> - One or several <a href="help-addressbook.html">Addressbook</a>
             categories. The channel the message was send in must be in at least
             one of those categories (added to the Addressbook with the name of
             the channel, including leading #, e.g. <code>#esl_csgo</code>).</li>

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.22)</a></h1>
+    <h1><a name="top">Chatty (Version: 0.23)</a></h1>
     <table>
         <tr>
             <td valign="top">
@@ -63,7 +63,7 @@
                 <ul class="menu">
                     <li><a href="help-settings.html">Settings Help</a></li>
                     <li><a href="help-setting_commands.html">Setting Commands</a></li>
-                    <li><a href="help-guide_folders.html">Setting Files (and others)</a></li>
+                    <li><a href="help-guide_folders.html">Files / Folders (Settings etc.)</a></li>
                     <li><a href="#launch">Launch options</a></li>
                     <li><a href="help-addressbook.html">Addressbook</a></li>
                     <li><a href="help-custom_commands.html">Custom Commands</a></li>
@@ -1933,6 +1933,10 @@ MiniK   http://static-cdn.jtvnw.net/emoticons/v1/25/1.0     set:793 id:3287</pre
         <dd>Creates a directory called "portable_settings" next to where the
             "Chatty.jar" is located and uses that as settings directory.</dd>
         
+        <dt><code>-debugdir &lt;dir&gt;</code></dt>
+        <dd>Specify the debug log directory. The specified directory has to
+            already exist, same as with <code>-d</code>.</dd>
+        
         <dt><code>-set:&lt;settingName&gt; &lt;setting value&gt;</code></dt>
         <dd>Change any setting that can be edited via the <code>/set</code>
         command (see <a href="help-setting_commands.html">Setting Commands</a>).</dd>
@@ -1979,6 +1983,7 @@ MiniK   http://static-cdn.jtvnw.net/emoticons/v1/25/1.0     set:793 id:3287</pre
         <li>Website: <a href="https://chatty.github.io">https://chatty.github.io</a></li>
         <li>E-Mail: chattyclient@gmail.com</li>
         <li>Twitter: <a href="https://twitter.com/ChattyClient">@ChattyClient</a></li>
+        <li>Mastodon: <a href="https://mstdn.social/@chattyclient">mstdn.social/@chattyclient</a></li>
         <li>Discord: <a href="https://discord.gg/WTuqGeJ">Chatty Discord Invite</a></li>
     </ul>
     <p>If you are reporting an issue, please read the page on <a href="help-report_issue.html">Reporting Issues</a>.</p>

index.html

@@ -16,9 +16,9 @@ function loaded() {
 		      { ceiling: null,  text: "$years years ago" }
 		]
 	}
-	document.getElementById("ago").innerHTML = "Version 0.22 released "+humanized_time_span("2023/01/15", Date(), custom_date_formats)+"";
+	document.getElementById("ago").innerHTML = "Version 0.23 released "+humanized_time_span("2023/02/17", Date(), custom_date_formats)+"";
 
-	getDownloads("v0.22");
+	getDownloads("v0.23");
 
 	slideshow_init("slideshow");
 }
@@ -158,7 +158,7 @@ function getDownloads(tag) {
 
 
 	<h2 id="download">Download</h2>
-	<p>Choose one of the following downloads of <strong>Chatty Version 0.22</strong><span id="dlCount" style="margin-bottom:7px;"></span>. For older versions or betas go to the <a href="https://github.com/chatty/chatty/releases">GitHub Releases</a>. Checksums for  release files are available as <a href="https://tduva.com/chatty/checksums/v0.22/">SHA-256 hashes</a>.</p>
+	<p>Choose one of the following downloads of <strong>Chatty Version 0.23</strong><span id="dlCount" style="margin-bottom:7px;"></span>. For older versions or betas go to the <a href="https://github.com/chatty/chatty/releases">GitHub Releases</a>. Checksums for  release files are available as <a href="https://tduva.com/chatty/checksums/v0.23/">SHA-256 hashes</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>
@@ -170,11 +170,11 @@ function getDownloads(tag) {
 		<tr>
 			<td>
 				<dl>
-					<dt><a href="https://github.com/chatty/chatty/releases/download/v0.22/Chatty_0.22_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.23/Chatty_0.23_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.22/Chatty_0.22_win_standalone.zip">Download Windows Standalone (.zip)</a></dt>
+					<dt><a href="https://github.com/chatty/chatty/releases/download/v0.23/Chatty_0.23_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>
 
@@ -182,11 +182,11 @@ function getDownloads(tag) {
 			</td>
 			<td>
 				<dl>
-					<dt><a href="https://github.com/chatty/chatty/releases/download/v0.22/Chatty_0.22_win_setup.exe">Download JAR-Version (Installer)</a></dt>
+					<dt><a href="https://github.com/chatty/chatty/releases/download/v0.23/Chatty_0.23_win_setup.exe">Download JAR-Version (Installer)</a></dt>
 					<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.22/Chatty_0.22.zip">Download JAR-Version (.zip)</a></dt>
+					<dt><a href="https://github.com/chatty/chatty/releases/download/v0.23/Chatty_0.23.zip">Download JAR-Version (.zip)</a></dt>
 					<dd>Extract the .zip into a folder of your choice and start <code>Chatty.jar</code>.</dd>
 				</dl>
 			</td>
@@ -194,7 +194,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.22/Chatty_0.22.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.23/Chatty_0.23.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>