Release v5.65.3

v5.65.3 Update Notes

🛠️ Improved

• Firebot detects the new Twitch Lead Moderator role as a moderator in chat messages and restrictions
• Removing users from Twitch roles now prompts for confirmation (#3374)
• Persistent custom variables are now saved to disk whenever changes are made (create/set, expire, and delete)
• When attempting a backup, if a custom backup path is specified and doesn't exist, Firebot now resets to the default and notifies the user so that backups will continue to successfully run
• Clarified how volume works for the default Text-To-Speech effect
• Clarified macOS install instructions

✅ Fixed

• Fixed an issue where moving a widget via the Update Overlay Widget Settings effect modal would keep the widget in the new location even if the effect wasn't saved or run (#3383)
• Fixed an issue where Firebot may fail to backup or launch when restoring a backup that specified a non-existent backup file path
• Fixed an issue where certain Firebot cleanup actions may not occur on shutdown

Windows Install

• Download and run Firebot-v5.65.3-setup.exe

MacOS Install

• Download Firebot-v5.65.3-macos-arm64.dmg (Apple Silicon) or Firebot-v5.65.3-macos-x64.dmg (Intel Macs)
• Right click the .dmg and select "Open"
• In the dialog that appears click "Cancel"
• Right click the .dmg again and select "Open"
• In the dialog that appears click "Open"

Note: Mac OS does not receive auto-updates

Linux Install

• DEB or RPM based distributions:
  • Download Firebot-v5.65.3-linux-x64.deb or Firebot-v5.65.3-linux-x64.rpm
  • Install the file using your system package manager
  • Open Firebot v5 from your system program runner
• Other distributions:
  • Download Firebot-v5.65.3-linux-x64.tar.gz
  • Unpack Firebot-v5.65.3-linux-x64.tar.gz
  • Change into the directory where you unpacked the archive
  • Run the Firebot v5 executable.

Note: Linux does not receive auto-updates

Release v5.65.2

v5.65.2 Update Notes

✨ New

• There is now an option to disable automatic Firebot updates via Settings > Advanced > Automatic Firebot Updates

Caution

We highly recommend that you leave automatic Firebot updates ENABLED. This ensures that you get the latest Firebot features, fixes, and platform updates as soon as they're released.

If you choose to disable Firebot automatic updates, YOU are responsible for updating Firebot yourself. Also, you will no longer receive support if you are running an unsupported version of Firebot. Please see our support policy for more information.

• Quickly copy debug info about your Firebot installation for support use via Help > About Firebot

✅ Fixed

• Fixed an issue where restrictions may not work as expected on system commands
• Fixed an issue where the Firebot Shoutout overlay may not respect the scale value (#3371)
• Fixed an issue that may prevent Firebot from opening if the global-settings.json file becomes corrupt (#3378)

Windows Install

• Download and run Firebot-v5.65.2-setup.exe

MacOS Install

• Download Firebot-v5.65.2-macos-arm64.dmg (Apple Silicon) or Firebot-v5.65.2-macos-x64.dmg (Intel Macs)
• Right click the .dmg and select "Open"
• In the dialog that appears click "Cancel"
• Right click the .dmg again and select "Open"
• In the dialog that appears click "Open"

Note: Mac OS does not receive auto-updates

Linux Install

• DEB or RPM based distributions:
  • Download Firebot-v5.65.2-linux-x64.deb or Firebot-v5.65.2-linux-x64.rpm
  • Install the file using your system package manager
  • Open Firebot v5 from your system program runner
• Other distributions:
  • Download Firebot-v5.65.2-linux-x64.tar.gz
  • Unpack Firebot-v5.65.2-linux-x64.tar.gz
  • Change into the directory where you unpacked the archive
  • Run the Firebot v5 executable.

Note: Linux does not receive auto-updates

Release v5.65.1

v5.65.1 Update Notes

✅ Fixed

• Fixed an issue where the Update Overlay Widget Settings effect wouldn't persist settings (#3366)
• Fixed an issue that may occur when using a ! character inside of a variable expression (#3369)
• Fixed an issue where overlay widgets were missing from the Remove Setup modal (#3365)
• Fixed an issue where announcements sent using the /announce slash commands would insert commas instead of spaces
• Fixed an issue where the avatar wasn't perfectly centered on the Firebot shoutout (#3367)
• Fixed an issue with the $math variable when used with other variables (#3364)

Windows Install

• Download and run Firebot-v5.65.1-setup.exe

MacOS Install

• Download Firebot-v5.65.1-macos-arm64.dmg (Apple Silicon) or Firebot-v5.65.1-macos-x64.dmg (Intel Macs)
• Right click the .dmg and select "Open"
• In the dialog that appears click "Cancel"
• Right click the .dmg again and select "Open"
• In the dialog that appears click "Open"

Note: Mac OS does not receive auto-updates

Linux Install

• DEB or RPM based distributions:
  • Download Firebot-v5.65.1-linux-x64.deb or Firebot-v5.65.1-linux-x64.rpm
  • Install the file using your system package manager
  • Open Firebot v5 from your system program runner
• Other distributions:
  • Download Firebot-v5.65.1-linux-x64.tar.gz
  • Unpack Firebot-v5.65.1-linux-x64.tar.gz
  • Change into the directory where you unpacked the archive
  • Run the Firebot v5 executable.

Note: Linux does not receive auto-updates

Release v5.65.0

v5.65.0 Update Notes

Note

Due to Twitch API changes, sub gift events no longer include the total number of months the recipient has been subscribed to the channel. Therefore, the $giftSubMonths variable and the months parameter of the $giftReceivers variable have been deprecated in Firebot.

✨ New

• Overlay Alert Effect! Have you ever setup an alert that plays on stream whenever something cool happens, like a follow or sub, but had to setup multiple effects just to show the one alert? Not anymore! We've added the new Overlay Alert effect that rolls a bunch of features into one simple action. Using this effect, you can display an image or video, text with color-accented fields, and even play a sound all at once! If you've created or used overlay alerts on other platforms before, this should feel very familiar.
• Overlay Widgets! This long-awaited feature is finally here! These are persistent items that stay on your overlay. Many of them are great for tracking things like channel goals or subathons, but you can use them however you like. In this first release, we've added several simple overlay widgets to get you started, or if you want to get extra creative, you can supply specific HTML and JavaScript to create your own Custom Widgets that you can tweak exactly the way you want. We're looking at adding additional widget types in the future, so stay tuned! Here are the widget types available in this release:
  • Countdown Timer
  • Countdown to Date
  • Counter Display
  • Current Date/Time
  • Custom Widget
  • Custom Widget (Advanced)
  • Image
  • Progress Bar
  • Text
• New Firebot profile page! Beginning with Firebot 5.65, anytime a viewer uses the !commands command, they'll be directed to a new Firebot profile page that's easy to remember - because it's your Twitch username! Check it out here
• Effect List Run Modes! All effect lists can now set their own run mode. Starting with this release, effect lists will have the following run modes:
  • Sequential (All) (default) - This is how effect lists run by default today, running every effect in the list in order anytime the associated trigger fires.
  • Sequential (Single) - This behaves like and will replace the Run Sequential Effect effect.
  • Random (Single) - This behaves like and will replace the Run Random Effect effect.

Note

Starting in Firebot 5.66, we will hide the Run Sequential Effect and Run Random Effect effects. These will continue to work if they've already been setup, but we highly recommend migrating to the new effect list run modes immediately by changing them to the Run Effect List effect type.

• Webhooks! [EXPERIMENTAL] Thanks to the new Crowbar API service that powers the new profile page, you can now receive webhooks in Firebot! When you add a new webhook, the service will assign it a URL that you can use with services that support sending webhooks.
  • Wanna see webhooks in action? Check out the brand new Ko-fi, Fourthwall, and GitHub plugins!
  • Please note that this feature is experimental and may experience issues as we continue refining it.
• Effect Queue Monitor! You can now view the effects in your effect queues in real time. You can even pause or clear them if necessary. (#2817)
• Dashboard Settings! We know that chat settings could be hard to find and needed a little updating, so we added a brand new Dashboard page to Settings. These contain all the settings that were in the previous chat settings popup, but redesigned and with added options to quickly edit Quick Actions and the Activity Feed, plus two brand-new options: Reverse Chat Order and Show Activity Feed Events in Chat. Still want access to those settings from the Dashboard? No problem! The Dashboard settings button is now bigger and easier to find. (#3205) (#3133)
• Event Set Reordering! We know many of you have event sets for a lot of different reasons, whether it's something simple like grouping similar events, or more complex scenarios like separating events based on specific themes or scenes you have setup in OBS. We also know folks have been wanting a way to reorganize those sets for a while, and now you can! (#2194)
• Global Values! These are static values that are available from any trigger type via a variable (like $!myGlobalValue), whether it's commands, events, timers, etc. You can use global values for anything, from commonly reused words/phrases to sensitive data like API keys. These can be configured from Settings > Advanced > Global Values. (#3114)

Caution

While secret values aren't displayed on screen in the Firebot UI, the value itself is stored in your settings.json file in plain text and will be inserted anywhere you use the variable, so as with any other sensitive data, exercise caution when using/displaying it.

• Support for Shared Chat Messages in the Dashboard!
• Support for Shared Hype Trains and Treasure Trains!
• Support for Twitch Power-ups! (#3208)
• Added Manual effect queue type (#2818)
• You can now choose which account (streamer or bot) will perform moderation actions (chat deletes/clears/mode changes, bans/timeouts, shoutouts, Shield Mode) (Settings > Advanced > Default Moderation User) (#2152)
• Quotes can now be exported to a CSV file via the Quotes page (#1692)
• Firebot Quotes can be imported via the Quotes page
• The !commands command now supports a default command sort tag option for the profile page (#2858)
• New !command import subcommand to import effect lists via a share code (#3256)
• Streamer account can now optionally bypass command cooldowns (Settings > Triggers > Streamer Account Exempt From Cooldowns) (#3218)
• You can now choose to display custom roles or ranks next to a viewer's name in chat on the Dashboard (#3200)
• You can now export viewers, currencies, and ranks
• You can now view users in Twitch roles, and edit Twitch moderators/VIPs, from the Roles & Ranks page
• You can now specify a reason when using the Ban and Timeout effects (#3316)
• Binary data support: The HTTP Request & Play Sound effects and $readFile variable now support raw binary data (#3202)
• Added the following new effects:
  • Comment
  • Copy Text to Clipboard
  • Enable/Disable Shield Mode
  • Hide Message In Chat Feed
  • Highlight Message in Chat Feed
  • Retrigger Last Activity
  • Send Message to Custom Widget
  • Set Custom Widget State
  • Set Output
  • Show Toast Notification
  • Switch Statement
  • Sync Data to Profile Page
  • Toggle Overlay Widgets
  • Trigger Manual Effect Queue
  • Update Countdown (Dynamic)
  • Update Overlay Widget Settings
  • Update Progress Bar
• Added the following new events:
  • Channel Reward Redemption: Choose an Emote to Unlock
  • Channel Reward Redemption: Highlight My Message
  • Channel Reward Redemption: Modify a Single Emote
  • Channel Reward Redemption: Send a Message in Sub-Only Mode
  • Channel Reward Redemption: Unlock a Random Sub Emote
  • Custom Overlay Widget Message Received
  • Hype Train Level Up
  • Outgoing Raid Started
  • Outgoing Raid Canceled
  • Power-up: Gigantify an Emote
  • Power-up: Message Effects
  • Power-up: On-Screen Celebration
  • Webhook Received
• Added the following new variables:
  • $atob
  • $base64Decode
  • $base64Encode
  • $btoa
  • $chatUserCount
  • $customWidgetId
  • $customWidgetName
  • $customWidgetMessageName
  • $customWidgetMessageData
  • $eventData
  • $formatDuration
  • $gigantifiedEmoteName
  • $gigantifiedEmoteUrl
  • $hypeTrainPreviousLevel
  • $isAnonymous
  • $isChannelLive
  • $isSharedChatEnabled
  • $isSharedTrain
  • $isTreasureTrain
  • $joinDate
  • $lastSeen
  • $latestClipUrl
  • $latestFollower
  • $lifetimeGiftCount
  • $objectKeys
  • $randomClipUrl
  • $scanWholeMessage
  • $sharedChatParticipants
  • $sharedChatSourceAvatarUrl
  • $sharedChatSourceDisplayName
  • $sharedChatSourceUser
  • $sharedChatSourceUserId
  • $sharedChatSourceUsername
  • $sprintf
  • $twitchVodUrl
  • $webhookHeader
  • $webhookHeaders
  • $webhookId
  • $webhookName
  • $webhookPayload
  • $webhookRawPayload
• Added the following new filters:
  • Channel is Live
  • Countdown Timer (Dynamic)
  • Custom Widget
  • Lifetime Gift Count
  • Message Name
  • Shared Train
  • Triggered Command
  • Treasure Train
  • Webhook
• Added Limit Per Stream restriction for commands, similar to Twitch's built-in restriction for Channel Rewards (#3113)
• Added Only When Live restriction
• Any effect in a list can now be run asynchronously, meaning Firebot will not wait for it to complete before running any effects that follow it
• New Purple Sky UI theme in memory of CKY 💜

🛠️ Improved

• Several UI Updates! Several parts of the Firebot UI have been completely redesigned, including custom commands, Effect Lists, Dashboard and Quick Action settings, and much more! We've also made several other UI improvements, including rearranging a couple of items on the sidebar to better group them with related features.
• Expanded emote support! The Dashboard now has an option to preload ALL the emotes your streamer and bot accounts have access to on Twitch. That means emotes you have from subscribing to other channels, unlocked via hype trains, special events,...

Release v5.65.0-beta2

Changes since 5.65.0-beta1:

✨ New

• Image overlay widget
• Activity Feed notifications can now be shown as alerts in the chat feed (Settings > Dashboard > Show Activity Feed Events in Chat)
• Effects:
  • Set Output
• Events:
  • Custom Overlay Widget Message Received
• Event filters:
  • Custom Widget
  • Message Name
• Variables
  • $customWidgetId
  • $customWidgetName
  • $customWidgetMessageName
  • $customWidgetMessageData
  • $sharedChatSourceAvatarUrl
• Restrictions
  • Only When Live

🛠️ Improved

• Firebot Shoutout effect has had a design refresh, including a new sequenced entrance animation
• The Only trigger when channel is live option for commands has been removed. Use the new Only When Live restriction instead.
• The Progress Bar overlay widget now has several additional configuration options
• Text position on the Overlay Alert effect is now configurable
• The overlay position editor used in widgets has more configuration options
• The effect list run modes have been renamed:
  • All is now Sequential (All)
  • Sequential is now Sequential (Single)
  • Random is now Random (Single)
• The Show Toast Notification and Comment effects now support markdown
• The Show Toast Notification effect can now be set to dismiss manually or on a custom timeout value
• The Highlight Message In Chat Feed effect can now be used in the Chat Message Spotlighted event
• Dashboard sent chat message history is now preserved after navigating away from and back to the Dashboard
• Subcommands now have a right-click context menu for easier option acccess
• Copied events can now be pasted above or below existing events, similar to commands
• When the Persist All Custom Variables option is turned off, custom variables can be individually set to persist
• Viewer import can now be canceled before import completes
• Plugin-created webhooks now have an indicator in the Webhooks modal
• Custom overlay widgets can now send data back to Firebot via the Custom Overlay Widget Message Received event
• Any effect in a list can now be run asynchronously, meaning Firebot will not wait for it to complete before running any effects that follow it
• Additional UI updates/fixes

✅ Fixed

• Fixed an issue with the !steam command due to changes Valve made removing an old API endpoint we were using
• Fixed a beta1 issue where some custom fonts would not apply to Countdown Timer (Dynamic) and Progress Bar overlay widgets
• Fixed a beta1 issue where Manual effect queues would display as Unknown in the Effect Queue Manager
• Fixed a beta1 issue where the "Hide game/category art" option would be displayed even if the "Show last game/category" option was disabled
• Fixed a beta1 issue where the Tag Notification Sound volume slider position would reset when reopening Dashboard settings
• Fixed a beta1 issue with toast notification backgrounds
• Fixed a beta1 issue with chat scroll pausing in reverse order mode
• Fixed a beta1 issue where opening a Firebot setup file from outside of Firebot would not load the import modal
• Fixed a beta1 issue where deleting custom variables would not refresh the custom variable inspector
• Fixed a beta1 issue where the heist game wasn't working correctly
• Fixed a beta1 issue where sounds may not play when a custom device is selected

⚙️ Under the Hood

• The require module has been removed from custom scripts/plugins as it has been deprecated for quite some time
• The fs module is deprecated and will be removed in Firebot 5.66 as it depends on the fs-extra NPM package. Use node's built-in fs modules instead.
• Variable definitions can now specify that they are sensitive, displaying a warning in the variable popup UI
• Electron 39.2.4
• Twurple 8.0.2

Windows Install

• Download and run Firebot-v5.65.0-beta2-setup.exe

MacOS Install

• Download Firebot-v5.65.0-beta2-macos-arm64.dmg (Apple Silicon) or Firebot-v5.65.0-beta2-macos-x64.dmg (Intel Macs)
• Right click the .dmg and select "Open"
• In the dialog that appears click "Cancel"
• Right click the .dmg again and select "Open"
• In the dialog that appears click "Open"

Note: Mac OS does not receive auto-updates

Linux Install

• DEB or RPM based distributions:
  • Download Firebot-v5.65.0-beta2-linux-x64.deb or Firebot-v5.65.0-beta2-linux-x64.rpm
  • Install the file using your system package manager
  • Open Firebot v5 from your system program runner
• Other distributions:
  • Download Firebot-v5.65.0-beta2-linux-x64.tar.gz
  • Unpack Firebot-v5.65.0-beta2-linux-x64.tar.gz
  • Change into the directory where you unpacked the archive
  • Run the Firebot v5 executable.

Note: Linux does not receive auto-updates

Release v5.65.0-beta1

Note

Due to Twitch API changes, sub gift events no longer include the total number of months the recipient has been subscribed to the channel. Therefore, the $giftSubMonths variable and the months parameter of the $giftReceivers variable have been deprecated in Firebot.

✨ New

• Overlay Alert Effect! Have you ever setup an alert that plays on stream whenever something cool happens, like a follow or sub, but had to setup multiple effects just to show the one alert? Not anymore! We've added the new Overlay Alert effect that rolls a bunch of features into one simple action. Using this effect, you can display an image or video, text with color-accented fields, and even play a sound all at once! If you've created or used overlay alerts on other platforms before, this should feel very familiar.
• Overlay Widgets! This long-awaited feature is finally here! These are persistent items that stay on your overlay. Many of them are great for tracking things like channel goals or subathons, but you can use them however you like. In this first release, we've added several simple overlay widgets to get you started, or if you want to get extra creative, you can supply specific HTML and JavaScript to create your own Custom Widgets that you can tweak exactly the way you want. We're looking at adding additional widget types in the future, so stay tuned! Here are the widget types available in this release:
  • Countdown Timer
  • Countdown to Date
  • Counter Display
  • Current Date/Time
  • Custom Widget
  • Custom Widget (Advanced)
  • Progress Bar
  • Text
• New Firebot profile page! Beginning with Firebot 5.65, anytime a viewer uses the !commands command, they'll be directed to a new Firebot profile page that's easy to remember - because it's your Twitch username! Check it out here
• Effect List Run Modes! All effect lists can now set their own run mode. Starting with this release, effect lists can be set to Random or Sequential. The Random run mode will replace the Run Random Effect effect and the Sequential run mode will replace the Run Sequential Effect effect.

Note

Starting in Firebot 5.66, we will hide the Run Sequential Effect and Run Random Effect effects. These will continue to work if they've already been setup, but we highly recommend migrating to the new effect list run modes immediately.

• Webhooks! [EXPERIMENTAL] Thanks to the new Crowbar API service that powers the new profile page, you can now receive webhooks in Firebot! When you add a new webhook, the service will assign it a URL that you can use with services that support sending webhooks.
  • Wanna see webhooks in action? Check out the brand new Ko-fi, Fourthwall, and GitHub plugins!
  • Please note that this feature is experimental and may experience issues as we continue refining it.
• Effect Queue Monitor! You can now view the effects in your effect queues in real time. You can even pause or clear them if necessary. (#2817)
• Dashboard Settings! We know that chat settings could be hard to find and needed a little updating, so we added a brand new Dashboard page to Settings. These contain all the settings that were in the previous chat settings popup, but redesigned and with added options to quickly edit Quick Actions and the Activity Feed, plus a new option to reverse the order of chat messages on the Dashboard. Still want access to those settings from the Dashboard? No problem! The Dashboard settings button is now bigger and easier to find. (#3205) (#3133)
• Global Values! These are static values that are available from any trigger type via a variable (like $!myGlobalValue), whether it's commands, events, timers, etc. You can use global values for anything, from commonly reused words/phrases to sensitive data like API keys. These can be configured from Settings > Advanced > Global Values. (#3114)

Caution

While secret values aren't displayed on screen in the Firebot UI, the value itself is stored in your settings.json file in plain text and will be inserted anywhere you use the variable, so as with any other sensitive data, exercise caution when using/displaying it.

• Support for Shared Chat Messages in the Dashboard!
• Support for Shared Hype Trains and Treasure Trains!
• Support for Twitch Power-Ups! (#3208)
• Added Manual effect queue type (#2818)
• You can now choose which account (streamer or bot) will perform moderation actions (chat deletes/clears/mode changes, bans/timeouts, shoutouts, Shield Mode) (Settings > Advanced > Default Moderation User) (#2152)
• Quotes can now be exported to a CSV file via the Quotes page (#1692)
• Firebot Quotes can be imported via the Quotes page
• The !commands command now supports a default command sort tag option for the profile page (#2858)
• New !command import subcommand to import effect lists via a share code (#3256)
• Streamer account can now optionally bypass command cooldowns (Settings > Triggers > Streamer Account Exempt From Cooldowns) (#3218)
• You can now choose to display custom roles or ranks next to a viewer's name in chat on the Dashboard (#3200)
• You can now export viewers, currencies, and ranks
• You can now view users in Twitch roles, and edit Twitch moderators/VIPs, from the Roles & Ranks page
• You can now specify a reason when using the Ban and Timeout effects (#3316)
• Binary data support: The HTTP Request & Play Sound effects and $readFile variable now support raw binary data (#3202)
• Added the following new effects:
  • Comment
  • Copy Text to Clipboard
  • Enable/Disable Shield Mode
  • Hide Message In Chat Feed
  • Highlight Message in Chat Feed
  • Retrigger Last Activity
  • Send Message to Custom Widget
  • Set Custom Widget State
  • Show Toast Notification
  • Switch Statement
  • Sync Data to Profile Page
  • Toggle Overlay Widgets
  • Trigger Manual Effect Queue
  • Update Countdown (Dynamic)
  • Update Overlay Widget Settings
  • Update Progress Bar
• Added the following new events:
  • Channel Reward Redemption: Choose an Emote to Unlock
  • Channel Reward Redemption: Highlight My Message
  • Channel Reward Redemption: Modify a Single Emote
  • Channel Reward Redemption: Send a Message in Sub-Only Mode
  • Channel Reward Redemption: Unlock a Random Sub Emote
  • Hype Train Level Up
  • Outgoing Raid Started
  • Outgoing Raid Canceled
  • Power-up: Gigantify an Emote
  • Power-Up: Message Effects
  • Power-up: On-Screen Celebration
  • Webhook Received
• Added the following new variables:
  • $atob
  • $base64Decode
  • $base64Encode
  • $btoa
  • $chatUserCount
  • $eventData
  • $formatDuration
  • $gigantifiedEmoteName
  • $gigantifiedEmoteUrl
  • $hypeTrainPreviousLevel
  • $isAnonymous
  • $isChannelLive
  • $isSharedChatEnabled
  • $isSharedTrain
  • $isTreasureTrain
  • $joinDate
  • $lastSeen
  • $latestClipUrl
  • $latestFollower
  • $lifetimeGiftCount
  • $objectKeys
  • $randomClipUrl
  • $scanWholeMessage
  • $sharedChatParticipants
  • $sharedChatSourceDisplayName
  • $sharedChatSourceUser
  • $sharedChatSourceUserId
  • $sharedChatSourceUsername
  • $sprintf
  • $twitchVodUrl
  • $webhookHeader
  • $webhookId
  • $webhookName
  • $webhookPayload
• Added the following new filters:
  • Channel is Live
  • Countdown Timer (Dynamic)
  • Lifetime Gift Count
  • Shared Train
  • Triggered Command
  • Treasure Train
  • Webhook
• Added Limit Per Stream restriction for commands, similar to Twitch's built-in restriction for Channel Rewards (#3113)
• New Purple Sky UI theme in memory of CKY 💜

🛠️ Improved

• Several UI Updates! Several parts of the Firebot UI have been completely redesigned, including custom commands, Effect Lists, Dashboard and Quick Action settings, and much more! We've also made several other UI improvements, including rearranging a couple of items on the sidebar to better group them with related features.
• Expanded emote support! The Dashboard now has an option to preload ALL the emotes your streamer and bot accounts have access to on Twitch. That means emotes you have from subscribing to other channels, unlocked via hype trains, special events, and more!

Important

Because of the potentially large number of emotes this can load, it may take several seconds after you connect to chat for emotes to appear in autocomplete. Also, if you change this setting, it will take effect the next time you connect to chat. That means if you're already connected when you change it, you'll need to disconnect, then reconnect.

• Release Notes can now be found under the Help menu
• The chat emote autocomplete preview now includes animated emotes where available
• Several events have been moved to EventSub:
  • Chat Message Deleted
  • Community Subs Gifted
  • Gift Sub Upgraded
  • Prime Sub Upgraded
  • Sub Gifted
• Community Subs Gifted event behavior is now much more reliable (#2186)
• Outgoing Raid event is now called Outgoing Raid Completed to differentiate from new outgoing raid events
• Commands now have an option to only trigger when channel is live (#2703)
• Firebot Setup options (create, import, remove) have been moved from Settings to the File menu
• The Chat Message event now supports the following variables when the message triggers a command:
  • $arg
    ...

Release v5.64.0

v5.64.0 Update Notes

✨ New

• Firebot has been fully migrated to EventSub! This is a major change as Twitch has deprecated PubSub in favor of EventSub. This will ensure continued functionality for Twitch events and notifications.
• Most effects will now have automatic dynamic labels by default. You can still override these default labels with your own or turn this feature off entirely in Settings. (#2127)
• Custom Scripts can now create UI Extensions, allowing them to add entirely new pages to the Firebot UI.
• Added Golden Kappa Hype Train Indicator
• Currency command updates:
  • Added a subcommand to look up another users currency (#3018)
  • Added a "set" subcommand to set another users currency
• Enhancements to simulating events
  • Event properties are now prefilled with default values
  • It is now possible to reload previously used property values
• Support for Shared Chat throughout the app
• Added an option to prevent your commands from being used in shared chats on a global and per command basis
• Added an Event Filter and $isSharedChatMessage variable
• Added ability to open streamers firebot profile page from the commands tab
• Added "Outgoing Raid" Event (#2767)
• Added an "Open Overlay in Browser" option to the Tools menu
• Added $vip array variable
• Added support for custom fonts for the Dashboard chat (#2955)
• The voices list in the TTS Effect is now searchable (#3000)
• Added $arrayFuzzySearch variable (#3002)
• Added $overlayResourcesPath variable to get the system path of the overlay-resources directory (#3007)
• Added a user allow list to the URL moderation tool (#2983)
• Added "Wait for speech to finish" option to the Text-To-Speech effect
• Added option to show correct trivia question on an incorrect answer
• Added a role filter to currency update event (#2873)
• Added "send as reply" as an option for restrictions
• Added $fileName variable that extracts a file name from a file path with a file extension (#2803)
• Added Effect Queue Status as event that trigger when the status of a queue changes.
• Added Effect Queue Added as a event that triggers when a new item are added to a effect queue.
• Added a filter for Effect Queue Status , Effect Queue Added and existing Effect Queue Cleared.
• Added new $effectQueueStatus variable that returns the true or false or null based of the status of the effect queue.
• Added $arraySlice replace variable (#2776)
• Added $pollChoices and $pollTitle variables
• New installers for Debian and Fedora (or similar) Linux distributions
• Added Apple Silicon (arm64) support for macOS, allowing Firebot to run natively on Apple Silicon Macs
• Added custom WebSocket listeners and events to plugins
• Added built in variable api (#2899)
• Added clear custom role api (#2483)
• Added Quotes events to websocket server
• Added Viewer Metadata Events to the Websocket Server
• Added Viewer Metadata POST, PUT, and DELETE APIs

🛠️ Improved

• Added array parameters to $min and $max (#2987)
• $randomActiveViewer can now filter roles into or out (#2805)
• Added a way to see and clear unknown sources in obs toggle effects (#2980)
• Improved styling of some notification toasts (#2997)
• Added an option for decimal padding to the $commafy variable
• New custom fonts are now dynamically added to the overlay
• Allow stream categories to be set to empty
• Made error logs more verbose for the http request effect (#2935)
• Added support for .oga file extension to the Play Sound effect
• Add Quote effect now includes the new quote id as an effect output (#2822)
• The dashboard chat will now remember Active Chat User, Message Text, and Replying-To even if you switch tabs (#2772)
• Option to default quotes to streamer name if no @ is provided (#2336)
• Added a property selector parameter to the $customRoleUsers
• Added Custom WebSocket Event effect
• Improved the verbiage on how to setup Streamdeck Website actions for the latest version of the app
• Toned down the brightness of the chat alert bg color (#2880)
• Improved accessibility of some dropdown selects
• Scheduled effect lists can now be added to Setups

✅ Fixed

• Fixed twitch clips not playing as expected in the overlay (#2778)
• Fixed 'Wait for sound to finish' not working (#2879)
• Fixed Twitch Global Emote Text Overlap (#3069)
• Fixed errors in effects breaking Effect (#3066)
• Fixed role bonuses pay out (#3030)
• Fixed cannot assign sort tags to some channel rewards (#3031)
• Fixed Currency Variable Not Pulling user (#3021)
• Fixed File Writer Newline Escapes (#3025)
• Simulated events are no longer cached (#2672)
• Fixed Toggle Event effect not working as expected on initial creation (#3008)
• Fixed ranks not sending chat messages (#2994)
• Fixed $rankLadder variable not being available (#2996)
• Fixed Empty Conditional Effects Showing Empty Conditions (#2986)
• Fixed HTTP Request effect JSON header
• Fixed edit user metadata editor type
• Improved channel rewards error handling when logged out
• Fixed Anonymous Cheering Total Bits Amount
• Resolved a race condition with overlay connect
• Fixed linux overlay not working when pwd not firebot dir
• Fixed sub kind filter
• Fixed filter values showing Not Set
• Fixed follower channelGoalCurrentAmount (#2919)
• Fixed obs change scene var menu and rotation var menu (#2918)
• Fixed $donationAmount and $formatedDonationAmount not being available for all donation services (#2917)
• Resolves some Duplicate Preset Effect List issues (#2920)
• We no longer send failed dashboard slash commands to twitch chat
• Resolved a bug with global command cooldowns allowing more than one command to be ran at once (#2909)
• Fixed carriage return not being ignored in replace line of write file. (#2892)
• Fixed a bug with chat moderation when a viewer had no saved view time (#2883)
• Fixed Elgato light strip colors
• Fixed poll choice and poll choices showing twice on the UI for simulate event
• Fixed case sensitivity in !permit moderation command (#2863)
• Fixed system command overrides not presenting new options from definition (#2831)
• Fixed menu position for activity feed effect (#2833)
• Fixed clip live check (#2845)
• Fixed ffz and 7tv wide emotes overlap
• Fixed Currencies Pay Out While Offline Even if Offline Payout is Disabled (#2801)
• Fixed twitch chat roles not getting added and updated properly in the viewer database
• Fixed random location setting for the show text effect
• Corrected $hasRole and $hasRoles Usage Examples (#2790)
• Fixed an error when saving quick action (#2779)
• When a command fails due to incorrect category/game, it now display's the correct one
• Fixed Condition of 0 showing as [Not Set] (#3086)

⚙️ Under the Hood

• The backup system has been refactored and should now be much more reliable
• The audio system has been refactored to help protect against memory leaks
• Refactored various modules to Typescript

Windows Install

• Download and run Firebot-v5.64.0-setup.exe

MacOS Install

• Apple Silicon
  • Download Firebot-v5.64.0-macos-arm64.dmg
  • Open the .dmg and drag Firebot into your Applications
  • Run the following command in Terminal:

  xattr -c /Applications/Firebot.app
  

• Intel Macs
  • Download Firebot-v5.64.0-macos-x64.dmg
  • Right click the .dmg and select "Open"
  • In the dialog that appears click "Cancel"
  • Right click the .dmg again and select "Open"
  • In the dialog that appears click "Open"

Note: Mac OS does not receive auto-updates

Linux Install

• DEB or RPM based distributions:
  • Download Firebot-v5.64.0-linux-x64.deb or Firebot-v5.64.0-linux-x64.rpm
  • Install the file using your system package manager
  • Open Firebot v5 from your system program runner
• Other distributions:
  • Download Firebot-v5.64.0-linux-x64.tar.gz
  • Unpack Firebot-v5.64.0-linux-x64.tar.gz
  • Change into the directory where you unpacked the archive
  • Run the Firebot v5 executable.

Note: Linux does not receive auto-updates

Release v5.64.0-beta1

v5.64.0-beta1 Update Notes

✨ New

• Firebot has been fully migrated to EventSub! This is a major change as Twitch has deprecated PubSub in favor of EventSub. This will ensure continued functionality for Twitch events and notifications.
• Most effects will now have automatic dynamic labels by default. You can still override these default labels with your own or turn this feature off entirely in Settings. (#2127)
• Custom Scripts can now create UI Extensions, allowing them to add entirely new pages to the Firebot UI.
• Added Golden Kappa Hype Train Indicator
• Currency command updates:
  • Added a subcommand to look up another users currency (#3018)
  • Added a "set" subcommand to set another users currency
• Enhancements to simulating events
  • Event properties are now prefilled with default values
  • It is now possible to reload previously used property values
• Added ability to open streamers firebot profile page from the commands tab
• Added $vip array variable
• Added support for custom fonts for the Dashboard chat (#2955)
• The voices list in the TTS Effect is now searchable (#3000)
• Added $arrayFuzzySearch variable (#3002)
• Added $overlayResourcesPath variable to get the system path of the overlay-resources directory (#3007)
• Added a user allow list to the URL moderation tool (#2983)
• Added "Wait for speech to finish" option to the Text-To-Speech effect
• Added option to show correct trivia question on an incorrect answer
• Scheduled effect lists can now be added to Setups
• Added a role filter to currency update event (#2873)
• Added "send as reply" as an option for restrictions
• Support for Shared Chat throughout the app
  • Added an option to prevent your commands from being used in shared chats on a global and per command basis
  • Added an Event Filter and $isSharedChatMessage variable
• Added $fileName variable that extracts a file name from a file path with a file extension (#2803)
• Added "Outgoing Raid" Event (#2767)
• Added Effect Queue Status as event that trigger when the status of a queue changes.
• Added Effect Queue Added as a event that triggers when a new item are added to a effect queue.
• Added a filter for Effect Queue Status , Effect Queue Added and existing Effect Queue Cleared.
• Added new $effectQueueStatus variable that returns the true or false or null based of the status of the effect queue.
• Added $arraySlice replace variable (#2776)
• Added $pollChoices and $pollTitle variables
• New installers for Debian and Fedora (or similar) Linux distributions
• Added Apple Silicon (arm64) support for macOS, allowing Firebot to run natively on Apple Silicon Macs
• Added custom WebSocket listeners and events to plugins
• Added built in variable api (#2899)
• Added clear custom role api (#2483)
• Added Quotes events to websocket server
• Added Viewer Metadata Events to the Websocket Server
• Added Viewer Metadata POST, PUT, and DELETE APIs

🛠️ Improved

• Added array parameters to $min and $max (#2987)
• $randomActiveViewer can now filter roles into or out (#2805)
• Added a way to see and clear unknown sources in obs toggle effects (#2980)
• Improved styling of some notification toasts (#2997)
• Added an option for decimal padding to the $commafy variable
• New custom fonts are now dynamically added to the overlay
• Allow stream categories to be set to empty
• Made error logs more verbose for the http request effect (#2935)
• Added support for .oga file extension to the Play Sound effect
• Add Quote effect now includes the new quote id as an effect output (#2822)
• The dashboard chat will now remember Active Chat User, Message Text, and Replying-To even if you switch tabs (#2772)
• Option to default quotes to streamer name if no @ is provided (#2336)
• Added a property selector parameter to the $customRoleUsers
• Added Custom WebSocket Event effect
• Improved the verbiage on how to setup Streamdeck Website actions for the latest version of the app
• Toned down the brightness of the chat alert bg color (#2880)
• Improved accessibility of some dropdown selects

✅ Fixed

• Fixed 'Wait for sound to finish' not working (#2879)
• Fixed Twitch Global Emote Text Overlap (#3069)
• Fixed errors in effects breaking Effect (#3066)
• Fixed role bonuses pay out (#3030)
• Fixed cannot assign sort tags to some channel rewards (#3031)
• Fixed Currency Variable Not Pulling user (#3021)
• Fixed File Writer Newline Escapes (#3025)
• Simulated events are no longer cached (#2672)
• Fixed Toggle Event effect not working as expected on initial creation (#3008)
• Fixed ranks not sending chat messages (#2994)
• Fixed $rankLadder variable not being available (#2996)
• Fixed Empty Conditional Effects Showing Empty Conditions (#2986)
• Fixed HTTP Request effect JSON header
• Fixed edit user metadata editor type
• Improved channel rewards error handling when logged out
• Fixed Anonymous Cheering Total Bits Amount
• Resolved a race condition with overlay connect
• Fixed linux overlay not working when pwd not firebot dir
• Fixed sub kind filter
• Fixed filter values showing Not Set
• Fixed follower channelGoalCurrentAmount (#2919)
• Fixed obs change scene var menu and rotation var menu (#2918)
• Fixed $donationAmount and $formatedDonationAmount not being available for all donation services (#2917)
• Resolves some Duplicate Preset Effect List issues (#2920)
• We no longer send failed dashboard slash commands to twitch chat
• Resolved a bug with global command cooldowns allowing more than one command to be ran at once (#2909)
• Fixed carriage return not being ignored in replace line of write file. (#2892)
• Fixed a bug with chat moderation when a viewer had no saved view time (#2883)
• Fixed Elgato light strip colors
• Fixed poll choice and poll choices showing twice on the UI for simulate event
• Fixed case sensitivity in !permit moderation command (#2863)
• Fixed system command overrides not presenting new options from definition (#2831)
• Fixed menu position for activity feed effect (#2833)
• Fixed clip live check (#2845)
• Fixed ffz and 7tv wide emotes overlap
• Fixed Currencies Pay Out While Offline Even if Offline Payout is Disabled (#2801)
• Fixed twitch chat roles not getting added and updated properly in the viewer database
• Fixed random location setting for the show text effect
• Corrected $hasRole and $hasRoles Usage Examples (#2790)
• Fixed an error when saving quick action (#2779)
• Fixed twitch clips not playing as expected in the overlay (#2778)
• When a command fails due to incorrect category/game, it now display's the correct one

⚙️ Under the Hood

• The backup system has been refactored and should now be much more reliable
• The audio system has been refactored to help protect against memory leaks
• Refactored various modules to Typescript

Windows Install

• Download and run Firebot-v5.64.0-beta1-setup.exe

MacOS Install

• Apple Silicon
  • Download Firebot-v5.64.0-beta1-macos-arm64.dmg
  • Open the .dmg and drag Firebot into your Applications
  • Run the following command in Terminal:

  xattr -c /Applications/Firebot.app
  

• Intel Macs
  • Download Firebot-v5.64.0-beta1-macos-x64.dmg
  • Right click the .dmg and select "Open"
  • In the dialog that appears click "Cancel"
  • Right click the .dmg again and select "Open"
  • In the dialog that appears click "Open"

Note: Mac OS does not receive auto-updates

Linux Install

• DEB or RPM based distributions:
  • Download Firebot-v5.64.0-beta1-linux-x64.deb or Firebot-v5.64.0-beta1-linux-x64.rpm
  • Install the file using your system package manager
  • Open Firebot v5 from your system program runner
• Other distributions:
  • Download Firebot-v5.64.0-beta1-linux-x64.tar.gz
  • Unpack Firebot-v5.64.0-beta1-linux-x64.tar.gz
  • Change into the directory where you unpacked the archive
  • Run the Firebot v5 executable.

Note: Linux does not receive auto-updates

Release v5.63.2

v5.63.2 Hotfix Notes

• Fixed viewer details modal never loading
• Fixed OBS Transition Started event showing incorrect scene name
• Fixed OBS Program Scene Changed double event
• Fixed HTML text area in HTML effect overflowing modal to the right

v5.63.0 Update Notes

✨New

• Ranks System (#1898)
  • Automated ladders to move viewers through ranks based on view time or currency
  • Manual ladders that you control fully with the new Update Viewer Rank effect
• $variable Macro System
  • Reuse complicated variables easily.
• Run Random Effect now supports weighted chances (#1971).
• Added ability to convert any effect list into to Preset Effect Lists (#2624)
• Added Activity Feed Alert effect (#2667)
• New Variables:
  • $userProfileImageUrl as alias for $userAvatarUrl
  • $userBio to retrieve user's Twitch bio/about (#2612)
  • $obsIsConnected for OBS connection state (#2608)
  • $chatMessageTextOnly returns chat message without URIs or emotes (#2598)
  • $effectQueueLength for effect queue length (#2533)
  • $randomUUID for random IDs
  • $chatMessageId to grab the chat message ID
  • $unixTimestamp variable to return number of seconds since unix epoch (#2644)
• New Events: Chat Message Deleted, Twitch Chat Cleared
• OBS Integration:
  • Added Transform OBS Source effect (#2664)
  • Support for OBS Groups
  • New events: OBS Connected and OBS Disconnected (#2618)
  • Support for OBS chapter markers (#2616)
  • Added support for OBS GDI+ v3 Text Sources (#2638)
• Channel Rewards: Events for when a Channel Reward is accepted or rejected (#2572)
• User Interaction: Mark user active on channel point redemption (#2542)
• Dashboard Feedback: Added feedback for slash command use (#2527)
• Twitch Viewer Card: Link added to viewer info popup.
• Graphics: Firebot Graphics provided by nxbs (#2585)
• Ability to abort running effects and effect lists, either manually or via automatic timeout
• TTS support on Linux (#2705)
• Add Control Hue Light effect

🛠️ Improved

• Single-line text inputs can now be expanded
• Edit Effect modal header is now sticky, allowing constant access to the Test Effects button
• Subcommands can now inherit the base command cooldowns
• Added add/edit tags button to sort tag popover (#2690)
• Added searching to Create New Setup components (#2599)
• OBS Color Picker, Raw/Variable Color Entry (#2708)
• Timeout option for HTTP Request effect
• $effectOutput now supports propertyPath and defaultData arguments (#2709)
• Added case-insensitive 'contains' to conditional effect
• New selectable image types: .bmp, .apng, .webm
• Input box changed to a multiline textarea for preset list args (#2399, #2626)
• UI improvements: padding, whitespace, and scrolling (#2602, #2597, #2490)
• Skip null/empty username values on custom role import (#2489)
• Aria support for preset effect lists and add/edit event modal (#2642, #2640)
• Edge-case handling of $chatMessageTextOnly (#2649)
• Improved index-referencing for $arrayElement and $arrayRemove (#2651)
• Reduced logging spam (#2653)
• Added max age and featured only Twitch clip options to the Play Video effect
• Improved rounded corners of inputs that have a title
• Improved copy and corrected typos throughout the app
• Philips Hue integration now has improved bridge discovery
• Clickable link added to feature stream setting
• Aria labels added to settings where missing (#2623)
• Improved Effect Modal Test Effect Aria accessibility (#2604)

✅ Fixed

• $randomActiveViewer variable filtering (#2627)
• Fuzzy matching for array-related searching (#2605)
• $readFile example description fixed (#2603)
• Windows resize with display scaling (#2578)
• /me not triggering from commands.
• Show Image effect not respecting specified duration.
• Run Command Effect arg returning undefined.
• Perform ad check on startup.
• Time input not saving seconds (#2494)
• $ensureNumber ignoring string empty
• Reward filters not having display description
• Can't use effect output variables in Preset Effect List arguments (#2444)
• Searching commands with "!" in Create Setup modal returns incorrect results (#2643)
• Streamer account logged out after putting host PC to sleep or when a network issue is encountered (#2646)
• Viewer Rank event filter not functioning correctly (#2654)
• Viewer Rank commands sending incorrect chat messages after rank up
• Channel rewards creating invalid default color codes (#2682)
• Export setup file extension on linux (#2677, #2678)
• Cooldown search negation (#2676)
• Corrected data output types for OBS variables
• Sort tag menu overflowing under modal footer
• Clip effect failing because it thinks streamer is offline
• Added timeout to known bots list api call
• Pasting a previously copied effect multiple times gives each copy the same id
• $userRoles not available for some triggers
• Twitch Connected event fires before bot account is connected to chat
• Dashboard sometimes has empty space at bottom
• User metadata not saving when username in database mismatches twitch username

⚙️ Under the Hood

• Updated to Electron 31 and Node 20
• Improvements for custom scripts:
  • Script js files can now be nested within folders within the /scripts dir
  • Script description, param titles, and param descriptions now support markdown
  • Support for more param types
  • ReplaceVariableFactory, EventFilterFactory, and NotificationManager modules now passed to scripts
  • Added showToast IPC event for showing a toast message that scripts can trigger
• Switched to prebuilt firebot-nutjs (#2615)
• Added support for variable aliasing (#2613)
• Fixed api/v1/viewers to return proper username and displayName (#2607)
• Added guard against effectOutputs being null
• Fixed log requestor IP for API calls (#2534)
• Resolve create preset list promise on cancel, pass back fully saved preset list object
• Expanded support for OAuth host configurations
• Expanded replace-variable-manager definition
• Added /api/v1/viewers/export end point to retrieve entire viewer db in json format
• Added event API over websockets (#2641)
• Fix: Corrected JsonDbManager event typo
• Fix: Manual metadata being null instead of empty object (#2648)

Windows Install

• Download and run Firebot-v5.63.0-setup.exe

MacOS Install

• Download Firebot-v5.63.0-macos-x64.dmg
• Right click the .dmg and select "Open"
• In the dialog that appears click "Cancel"
• Right click the .dmg again and select "Open"
• In the dialog that appears click "Open"

Note: Mac OS does not receive auto-updates

Linux Install

• Download Firebot-v5.63.0-linux-x64.tar.gz
• Unpack Firebot-v5.63.0-linux-x64.tar.gz
• Change into the directory where you unpacked the archive
• Run the Firebot v5 executable.
  • This must either be done via a terminal window, or you will need to create a shortcut that includes the correct path for the unpacked archived as the "working directory".

Note: Linux does not receive auto-updates

Release v5.63.1

v5.63.1 Hotfix Notes

• Fixed $overlayInstance always showing as Default

v5.63.0 Update Notes

✨New

• Ranks System (#1898)
  • Automated ladders to move viewers through ranks based on view time or currency
  • Manual ladders that you control fully with the new Update Viewer Rank effect
• $variable Macro System
  • Reuse complicated variables easily.
• Run Random Effect now supports weighted chances (#1971).
• Added ability to convert any effect list into to Preset Effect Lists (#2624)
• Added Activity Feed Alert effect (#2667)
• New Variables:
  • $userProfileImageUrl as alias for $userAvatarUrl
  • $userBio to retrieve user's Twitch bio/about (#2612)
  • $obsIsConnected for OBS connection state (#2608)
  • $chatMessageTextOnly returns chat message without URIs or emotes (#2598)
  • $effectQueueLength for effect queue length (#2533)
  • $randomUUID for random IDs
  • $chatMessageId to grab the chat message ID
  • $unixTimestamp variable to return number of seconds since unix epoch (#2644)
• New Events: Chat Message Deleted, Twitch Chat Cleared
• OBS Integration:
  • Added Transform OBS Source effect (#2664)
  • Support for OBS Groups
  • New events: OBS Connected and OBS Disconnected (#2618)
  • Support for OBS chapter markers (#2616)
  • Added support for OBS GDI+ v3 Text Sources (#2638)
• Channel Rewards: Events for when a Channel Reward is accepted or rejected (#2572)
• User Interaction: Mark user active on channel point redemption (#2542)
• Dashboard Feedback: Added feedback for slash command use (#2527)
• Twitch Viewer Card: Link added to viewer info popup.
• Graphics: Firebot Graphics provided by nxbs (#2585)
• Ability to abort running effects and effect lists, either manually or via automatic timeout
• TTS support on Linux (#2705)
• Add Control Hue Light effect

🛠️ Improved

• Single-line text inputs can now be expanded
• Edit Effect modal header is now sticky, allowing constant access to the Test Effects button
• Subcommands can now inherit the base command cooldowns
• Added add/edit tags button to sort tag popover (#2690)
• Added searching to Create New Setup components (#2599)
• OBS Color Picker, Raw/Variable Color Entry (#2708)
• Timeout option for HTTP Request effect
• $effectOutput now supports propertyPath and defaultData arguments (#2709)
• Added case-insensitive 'contains' to conditional effect
• New selectable image types: .bmp, .apng, .webm
• Input box changed to a multiline textarea for preset list args (#2399, #2626)
• UI improvements: padding, whitespace, and scrolling (#2602, #2597, #2490)
• Skip null/empty username values on custom role import (#2489)
• Aria support for preset effect lists and add/edit event modal (#2642, #2640)
• Edge-case handling of $chatMessageTextOnly (#2649)
• Improved index-referencing for $arrayElement and $arrayRemove (#2651)
• Reduced logging spam (#2653)
• Added max age and featured only Twitch clip options to the Play Video effect
• Improved rounded corners of inputs that have a title
• Improved copy and corrected typos throughout the app
• Philips Hue integration now has improved bridge discovery
• Clickable link added to feature stream setting
• Aria labels added to settings where missing (#2623)
• Improved Effect Modal Test Effect Aria accessibility (#2604)

✅ Fixed

• $randomActiveViewer variable filtering (#2627)
• Fuzzy matching for array-related searching (#2605)
• $readFile example description fixed (#2603)
• Windows resize with display scaling (#2578)
• /me not triggering from commands.
• Show Image effect not respecting specified duration.
• Run Command Effect arg returning undefined.
• Perform ad check on startup.
• Time input not saving seconds (#2494)
• $ensureNumber ignoring string empty
• Reward filters not having display description
• Can't use effect output variables in Preset Effect List arguments (#2444)
• Searching commands with "!" in Create Setup modal returns incorrect results (#2643)
• Streamer account logged out after putting host PC to sleep or when a network issue is encountered (#2646)
• Viewer Rank event filter not functioning correctly (#2654)
• Viewer Rank commands sending incorrect chat messages after rank up
• Channel rewards creating invalid default color codes (#2682)
• Export setup file extension on linux (#2677, #2678)
• Cooldown search negation (#2676)
• Corrected data output types for OBS variables
• Sort tag menu overflowing under modal footer
• Clip effect failing because it thinks streamer is offline
• Added timeout to known bots list api call
• Pasting a previously copied effect multiple times gives each copy the same id
• $userRoles not available for some triggers
• Twitch Connected event fires before bot account is connected to chat
• Dashboard sometimes has empty space at bottom
• User metadata not saving when username in database mismatches twitch username

⚙️ Under the Hood

• Updated to Electron 31 and Node 20
• Improvements for custom scripts:
  • Script js files can now be nested within folders within the /scripts dir
  • Script description, param titles, and param descriptions now support markdown
  • Support for more param types
  • ReplaceVariableFactory, EventFilterFactory, and NotificationManager modules now passed to scripts
  • Added showToast IPC event for showing a toast message that scripts can trigger
• Switched to prebuilt firebot-nutjs (#2615)
• Added support for variable aliasing (#2613)
• Fixed api/v1/viewers to return proper username and displayName (#2607)
• Added guard against effectOutputs being null
• Fixed log requestor IP for API calls (#2534)
• Resolve create preset list promise on cancel, pass back fully saved preset list object
• Expanded support for OAuth host configurations
• Expanded replace-variable-manager definition
• Added /api/v1/viewers/export end point to retrieve entire viewer db in json format
• Added event API over websockets (#2641)
• Fix: Corrected JsonDbManager event typo
• Fix: Manual metadata being null instead of empty object (#2648)

Windows Install

• Download and run Firebot-v5.63.0-setup.exe

MacOS Install

• Download Firebot-v5.63.0-macos-x64.dmg
• Right click the .dmg and select "Open"
• In the dialog that appears click "Cancel"
• Right click the .dmg again and select "Open"
• In the dialog that appears click "Open"

Note: Mac OS does not receive auto-updates

Linux Install

• Download Firebot-v5.63.0-linux-x64.tar.gz
• Unpack Firebot-v5.63.0-linux-x64.tar.gz
• Change into the directory where you unpacked the archive
• Run the Firebot v5 executable.
  • This must either be done via a terminal window, or you will need to create a shortcut that includes the correct path for the unpacked archived as the "working directory".

Note: Linux does not receive auto-updates