diff --git a/help/help-custom_commands.html b/help/help-custom_commands.html index e397220..e398562 100644 --- a/help/help-custom_commands.html +++ b/help/help-custom_commands.html @@ -42,6 +42,8 @@
  • Separators
  • Shortcuts
  • Positioning
  • +
  • Dynamic Labels
  • +
  • Optional Menu Entries
  • Special Commands
  • @@ -915,6 +917,8 @@ $j(
  • Separators
  • Shortcuts
  • Positioning
  • +
  • Dynamic Labels
  • +
  • Optional Menu Entries
  • Special Commands
  • @@ -1148,6 +1152,118 @@ Spoiler[S]=/timeout $$1 600 No spoilers positioning is based on the current state of the menu, so it can matter when you add entries with absolute positioning.

    +

    Dynamic Labels using Custom Commands

    + +

    Note: This feature must be enabled in the Settings + under "Commands" (otherwise replacements in labels have no effect).

    + +

    You can use Custom Command replacements in the label of inline commands + or submenus. The label is updated:

    + + + +

    For example if you have a counter command that increases a number, it + could show the current number in the menu entry label by reading it from + the settings via $get():

    + +
    +Increase counter ($get(var,c))=/set2 var c $calc($get(var,c) + 1)
    +
    + +

    You can also use this to hide an entry, by adding a required replacement, + like $$is(mystatus:M), which will cause the entire label to + be empty if you are not a mod in the channel and thus will not be added + to the menu. Just adding $$is(mystatus:M) will add true + if you are a mod, so you can wrap it in an $if() (in this + example it's a submenu called "Mod Menu"):

    + +
    +@$if($$is(mystatus:M),Mod Menu)
    +
    + +

    Note: Compared to identifiers + for regular commands, some information may be missing in the context of + labels and restrictions.

    + +

    Optional Menu Entries (Restrictions)

    + +

    Note: This feature must be enabled in the Settings + under "Commands" (otherwise added restrictions have no effect).

    + +

    You can add restrictions to individual menu entries or a group of + entries. The restriction is applied (entries added or removed):

    + + + +

    The restriction must always be on it's own line and start and + end with a square bracket, which contain a Custom Command that is + surrounded by spaces. If the Custom Command returns a non-empty value + the menu entries will show up, otherwise they are hidden.

    + +
    +
    [ <restriction using custom command> ]
    +
    Only affects the following menu entry. A similar effect can be + achieved by using Label Commands.
    + +
    [<name> <restriction using custom command> ]
    +
    Opens up a section, like an HTML tag. The <name> + is used to identify where the section ends. Different restrictions + can be nested inside eachother, causing them all to be applied to + the affected menu entries.
    + +
    [/<name>]
    +
    Ends a section that has the given name.
    +
    + +

    Example:

    + +
    +[mod $is(mystatus:M) ]
    +@Modes
    +.Emoteonly[E]=/emoteonly
    +.Emoteonly Off[O]=/emoteonlyoff
    +.Subsonly[S]=/subscribers
    +.Subsonly Off[D]=/subscribersoff
    +Clear[C]=/clear
    +
    +[ $ifeq($datetime(M),9,true) ]
    +/Subtember
    +[/mod]
    +
    +[ $is(chan:joshimuz\,botimuz) ]
    +/JoshFAQ /JoshSub
    +
    + +

    The "Modes" submenu, the "Clear" command and the "Subtember" command only + show when you are a mod in the channel. The $is() + function uses Highlight syntax + and returns an empty value if it doesn't match. It's that Custom Command + part that defines the actual restriction, the "mod" in [mod ... ] + is arbitrarily named, it just has to match the closing [/mod].

    + +

    The "Subtember" command has an additional requirement though, defined + directly above it, which uses the functions $ifeq() and $datetime() to + only show the menu entry when the month is September.

    + +

    The "/JoshFAQ" and "/JoshSub" commands only show in the channel #joshimuz + or #botimuz. Note that the \, between the channel names + requires the backslash to escape the comma, + meaning it tells the Custom Command parser that the comma isn't meant as + a function parameter separator, but rather to separate the channels in + the Highlighting syntax.

    + +

    Note: Compared to identifiers + for regular commands, some information may be missing in the context of + labels and restrictions.

    +

    Special Commands

    In the User Dialog Buttons setting you can use some special commands:

    diff --git a/help/help-guide2.html b/help/help-guide2.html index 26f81d9..533defc 100644 --- a/help/help-guide2.html +++ b/help/help-guide2.html @@ -20,7 +20,7 @@

    If you can't fix this problem and there are no other error messages that may indicate what is going wrong, then you can still proceed with opening the - link by clicking on "Open URL" in the dialog (or this link, which has all permissions Chatty needs). Chatty won't be able to + link by clicking on "Open URL" in the dialog (or this link, which has all permissions Chatty needs). Chatty won't be able to receive the token automatically (your browser will tell you that it can't load the page when you get to http://127.0.0.1:61324), so you have to read on in the next section, especially diff --git a/help/help-releases.html b/help/help-releases.html index c1d212d..1354c19 100644 --- a/help/help-releases.html +++ b/help/help-releases.html @@ -17,6 +17,7 @@

    Release Information

    + 0.25 | 0.24.1 | 0.24 | 0.23 | @@ -74,7 +75,43 @@ full list of changes.

    - Version 0.24.1 (This one!) (2023-05-10) + Version 0.25 (This one!) (2023-07-21) + [back to top] +

    +
    +### Twitch Features
    +- Added amount/currency next to Hype Chat messages, added `config:hypechat`
    +  Highlighting prefix
    +- Switched to new follower API (only allows moderators to see the list of
    +  followers, count is visible for everyone though)
    +- Added multi-month subs info to subscriber notifications
    +- Improved badge tooltips based on updated API information
    +
    +### Custom Commands
    +- Context Menu/User Dialog custom entries/buttons:
    +  - Added ability to show entries only when they match certain restrictions
    +    (for example based on channel or user status, see the Custom Commands help)
    +  - Entries with empty labels now get removed, so using a required replacement
    +    in a label can also serve to hide it based on certain conditions
    +  - Added more context-specific parameters for use in labels and restrictions
    +  - Added ability to use replacements in User Dialog button labels, like you can
    +    in context menus as well
    +- Added settings to trigger commands when middle-clicking on user in chat
    +  (equivalent to Ctrl+clicking, in the Settings under "Chat")
    +
    +### Other
    +- Select associated message in a few more cases when opening User Dialog
    +- Improved support for different `.wav` file formats
    +- Updated Gradle to 8.2.1 (and related build changes)
    +- Updated Java for the Windows Standalone
    +- Updated help
    +
    +### Bugfixes
    +- Fixed channel status warning appearing in Admin Dialog when it shouldn't
    +    
    + +

    + Version 0.24.1 (2023-05-10) [back to top]

    diff --git a/help/help-settings.html b/help/help-settings.html
    index 39396a0..0c397dc 100644
    --- a/help/help-settings.html
    +++ b/help/help-settings.html
    @@ -1085,6 +1085,7 @@
                     
  • config:restricted - Match messages by restricted users shown only for moderators. Note that messages by monitored users can not be matched yet.
  • +
  • config:hypechat - Match Hype Chat messages.
  • blacklist: to specify one or more text patterns diff --git a/help/help-troubleshooting.html b/help/help-troubleshooting.html index cf71da7..5736d5c 100644 --- a/help/help-troubleshooting.html +++ b/help/help-troubleshooting.html @@ -34,6 +34,7 @@
  • Known Issues
  • Bad performance / OutOfMemoryError
  • Debug log
  • +
  • MacOS Issues
  • @@ -362,6 +363,19 @@ [back to menu]
    Moved: Report Issue
    + +

    + MacOS Issues + [back to menu] +

    + +

    Files can't be accessed

    +

    If Chatty can't access some files (e.g. sounds), you may have to give the + JAR Launcher additional access. Go to System Preferences - Security - + Privacy - Full Disk Access and add the Jar Launcher.app + to the list. + More information..

    + diff --git a/help/help.html b/help/help.html index ed516a2..2174480 100644 --- a/help/help.html +++ b/help/help.html @@ -5,7 +5,7 @@ -

    Chatty (Version: 0.24.1)

    +

    Chatty (Version: 0.25)

    @@ -194,7 +194,7 @@ function getDownloads(tag) {
    diff --git a/index.html b/index.html index 950a76b..43fdc26 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.24.1 released "+humanized_time_span("2023/05/10", Date(), custom_date_formats)+""; + document.getElementById("ago").innerHTML = "Version 0.25 released "+humanized_time_span("2023/07/21", Date(), custom_date_formats)+""; - getDownloads("v0.24.1"); + getDownloads("v0.25"); slideshow_init("slideshow"); } @@ -158,7 +158,7 @@ function getDownloads(tag) {

    Download

    -

    Choose one of the following downloads of Chatty Version 0.24.1. For older versions or betas go to the GitHub Releases. Checksums for release files are available as SHA-256 hashes.

    +

    Choose one of the following downloads of Chatty Version 0.25. For older versions or betas go to the GitHub Releases. Checksums for release files are available as SHA-256 hashes.

    If this is your first time using Chatty check out the Getting Started Guide.

    Windows

    @@ -170,11 +170,11 @@ function getDownloads(tag) {
    -
    Download Windows Standalone (Installer) Recommended
    +
    Download Windows Standalone (Installer) Recommended
    Install into a folder of your choice and start Chatty.exe (or optionally created shortcuts).
    -
    Download Windows Standalone (.zip)
    +
    Download Windows Standalone (.zip)
    Extract the .zip into a folder of your choice and start Chatty.exe.
    @@ -182,11 +182,11 @@ function getDownloads(tag) {
    -
    Download JAR-Version (Installer)
    +
    Download JAR-Version (Installer)
    Install into a folder of your choice and start Chatty.jar (or optionally created shortcuts).
    -
    Download JAR-Version (.zip)
    +
    Download JAR-Version (.zip)
    Extract the .zip into a folder of your choice and start Chatty.jar.

    Non-Windows

    -

    For OS other than Windows (e.g. Linux or MacOS) you will need to download the JAR-Version (.zip) and must have Java 8 or later installed on your system. Extract the .zip into a folder of your choice and start Chatty.jar.

    +

    For OS other than Windows (e.g. Linux or MacOS) you will need to download the JAR-Version (.zip) and must have Java 8 or later installed on your system. Extract the .zip into a folder of your choice and start Chatty.jar.

    Contact

    If you have any feedback or questions feel free to contact me. You can join the Chatty Discord preferred, write me an E-Mail or use Twitter.