Release v5.62.0-beta2

v5.62.0-beta2 Changes

🛠️ Improved

• The Required Additional Arg Count field for subcommands may now be reset to 0 if it was previously set to a higher value
• Firebot now attempts to load and cache all channel moderators/VIPs both at startup and when connecting to Twitch, and will update roles for moderators while connected to Twitch

✅ Fixed

• Fixed an issue from beta1 where some custom role variables were not returning data back in the expected format
• Fixed an issue from beta1 where viewer role checks may take longer than expected in some cases

v5.62.0-beta1 Update Notes

Note

To learn more about the changes to the username variables, Firebot's internal role management, and how this will affect you, please read this wiki article

✨ New

• Custom Roles have been revamped. We now track viewers in custom (and all other) roles by their user ID.
• Users with localized Twitch display names now display their localized variant along with their regular username in most areas of the UI, similarly to how they appear in Twitch chat
• Added new $userDisplayName variable

🛠️ Improved

• Chat messages from Firebot (both streamer and bot accounts) now send via Twitch's REST API instead of IRC
• All viewer roles now track users by user ID instead of username/display name
• The $user/$username variables now return a username, not a display name
• The $useridname variable has been deprecated
• The Cost field of the Update Channel Reward effect now allows variables (#2410)
• When Firebot encounters an unrecoverable issue with Twitch login credentials, it now immediately logs out the affected account(s) and prompts the user to log back in
• The chat settings UI has been refreshed
• The Create Clip effect now only waits to continue to the next effect if the clip is set to be displayed on an overlay and the Wait option is selected (#2428)
• The $convertToJSON now has an option to pretty-print the output (#2422)
• Custom scripts are now signaled to stop when Firebot is closed so that they can perform any cleanup (#2431)

✅ Fixed

• The "Disconnected from chat" message on the Dashboard now properly hides once chat connection has been reestablished (#2423) (#2424)
• Fixed an issue where using Tier 2/Tier 3 subscriber roles for permissions/role checks would not work (#2167)
• Fixed an issue where renaming a Quick Action would result in an error when there was no error (#2419) (#2420)
• The Create Clip effect now correctly returns its effect output (#2428)
• Fixed an issue where the custom variable tooltip in the Create Clip effect would break custom variable settings for the effect
• Fixed an issue where autocomplete on the Dashboard may break in certain scenarios
• Fixed the usage examples for the $textPadStart and $textPadEnd variables (#2416) (#2417)
• Fixed an issue where the ampersand character (&) in an overlay name would cause it to not work
• Fixed an issue where the main window wasn't fully closing correctly behind the scenes

Windows Install

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

MacOS Install

• Download Firebot-v5.62.0-beta2-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.62.0-beta2-linux-x64.tar.gz
• Unpack Firebot-v5.62.0-beta2-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.62.0-beta1

v5.62.0-beta1 Update Notes

Note

To learn more about the changes to the username variables, Firebot's internal role management, and how this will affect you, please read this wiki article

✨ New

• Custom Roles have been revamped. We now track viewers in custom (and all other) roles by their user ID.
• Users with localized Twitch display names now display their localized variant along with their regular username in most areas of the UI, similarly to how they appear in Twitch chat
• Added new $userDisplayName variable

🛠️ Improved

• Chat messages from Firebot (both streamer and bot accounts) now send via Twitch's REST API instead of IRC
• All viewer roles now track users by user ID instead of username/display name
• The $user/$username variables now return a username, not a display name
• The $useridname variable has been deprecated
• The Cost field of the Update Channel Reward effect now allows variables (#2410)
• When Firebot encounters an unrecoverable issue with Twitch login credentials, it now immediately logs out the affected account(s) and prompts the user to log back in
• The chat settings UI has been refreshed
• The Create Clip effect now only waits to continue to the next effect if the clip is set to be displayed on an overlay and the Wait option is selected (#2428)
• The $convertToJSON now has an option to pretty-print the output (#2422)
• Custom scripts are now signaled to stop when Firebot is closed so that they can perform any cleanup (#2431)

✅ Fixed

• The "Disconnected from chat" message on the Dashboard now properly hides once chat connection has been reestablished (#2423) (#2424)
• Fixed an issue where using Tier 2/Tier 3 subscriber roles for permissions/role checks would not work (#2167)
• Fixed an issue where renaming a Quick Action would result in an error when there was no error (#2419) (#2420)
• The Create Clip effect now correctly returns its effect output (#2428)
• Fixed an issue where the custom variable tooltip in the Create Clip effect would break custom variable settings for the effect
• Fixed an issue where autocomplete on the Dashboard may break in certain scenarios
• Fixed the usage examples for the $textPadStart and $textPadEnd variables (#2416) (#2417)
• Fixed an issue where the ampersand character (&) in an overlay name would cause it to not work
• Fixed an issue where the main window wasn't fully closing correctly behind the scenes

Windows Install

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

MacOS Install

• Download Firebot-v5.62.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

• Download Firebot-v5.62.0-beta1-linux-x64.tar.gz
• Unpack Firebot-v5.62.0-beta1-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.61.2

v5.61.2 Hotfix Notes

✨ New

• Preset Effect List arguments may now be accessed via $# in addition to $presetListArgs (e.g. $#someArg is the same as $presetListArgs[someArg])

✅ Fixed

• Fixed an issue where viewers would not accrue watch time

v5.61.1 Hotfix Notes

✅ Fixed

• Fixed an issue where we weren't handling corrupt JsonDB files properly (#2405)

v5.61.0 Update Notes

Caution

Several advanced variables may now work differently or have been deprecated in this release (e.g. any variables that begin with $array, $object, $raw or $regex). PLEASE test and update your setups accordingly to ensure they work as expected. For a full list of related changes, please see this wiki article

✨ New

• Firebot's variable processing engine has been overhauled
• Introducing: Firebot Featured Streams! You may now opt-in to have your stream featured on the Firebot website when you're live. Just go to Settings > General and enable Feature My Stream on Firebot.app
• The top bar now indicates the status of an active Hype Train (#2087)
• Commands, Channel Rewards, Timers, and Scheduled Effect Lists can be enabled/disabled via tag (#576) (#2342)
• Added an option on the Commands tab to manually clear cooldowns on both individual commands and all commands (#1947)
• Custom variables may now be accessed via $$ in addition to $customVariable (e.g. $$myVar is the same as $customVariable[myVar] and $$myVar[path, to, value] is the same as $customVariable[myVar, path.to.value])
• Effect outputs may now be accessed via $& in addition to $effectOutputs (e.g. $&httpRequest is the same as $effectOutputs[httpRequest] and $&httpRequest[path, to, value] is the same as $effectOutputs[httpRequest, path.to.value])
• Added exact matching for the $arrayFind* variables
• Added new $userIsBanned and $userIsTimedOut variables (#2330)
• Added new $pronouns variable (#2187) (#2341)
• Added new $extraLifeInfo, $extraLifeMilestones, $extraLifeDonations, and $extraLifeIncentives variables (#2229) (#2343)
• Added new $arrayRandomItem, $filesInDirectory, $textPadStart, and $textPadEnd variables
• Added new $null, $true and $false variables
• Added default currency option for !steam system command (#2138)
• Added new Before Firebot Closed event (#2332) (#2347)
• Added new Evaluate JavaScript effect and $evalJs variable. These will allow you to run simple, very limited JavaScript functions for advanced processing.
• The Evaluate JavaScript effect and $evalJs variable can now access custom variables via Firebot.getCustomVariable(varName) and effect outputs via Firebot.getEffectOutput(outputName)
• Added --fbuser-data-directory and --fbsecrets-config command line flags

🛠️ Improved

• Clarified the tooltip around storing Twitch clip URLs in a custom variable (#2392)
• Command cooldowns are no longer cleared inadvertently in multiple scenarios, including when switching to the Commands tab or when using the Toggle Command effect (#1947)
• We now better handle usernames in several scenarios, including those with Unicode/international characters in their usernames (#2123) (#2131) (#2390)
• Usernames now get updated when users appear in chat after they change their username (#2198)
• The !commands command now allows for custom chat output (#2339)
• Cleaned up the command data export when using !commands
• The Run Program effect can now read output (#1176)
• Whisper events are no longer cached, meaning they will trigger with each message, just like chat messages
• The known bot list is now loaded when connecting to Twitch if it failed to load previously (#2349)
• The $followCount variable should more consistently return a value (#2368)
• The $subNames variable now includes display names (#2379)
• The Log Message effect now has a multiline editor for the message
• Backups created on Windows will now properly restore on non-Windows systems
• Several internal Firebot systems have been refactored/updated (viewer database, command handlers, currency, in-app notifications, backups)
• Misc improvements/typo fixes

✅ Fixed

• Fixed an issue with 7TV channel emotes
• Fixed an issue with Raid event metadata
• Fixed an issue where quick actions may not import correctly from a Firebot setup (#2376)
• Fixed an issue where quick actions may not show up after being added from the Dashboard (#2401) (#2402)
• Fixed an issue with effect outputs causing an error in Loop Effects effect
• Conditional effects now properly read previous effect outputs
• Fixed an issue where $chatMessage variable does not return the full chat message for a command with a regex trigger (#2394)
• Fixed an issue where variables may unexpectedly return [object Object] (#2323)
• Fixed an issue where HTTP routes registered via custom scripts may erroneously include backslashes

🔗 API Changes

• Added new GET /timers/:timerId/:action API endpoint (#2395) (#2396)
• Custom script parametersUpdated() and stop() functions are now properly called (#2337) (#2338)
• Bumped Electron to 28.2.3

Misc

• Merge pull request #2409 from crowbartools/v5
• 5.61.2
• fix(database): fix viewer watch time accrual
• feat: spoof $#name shorthand variable
• feat: presetListArgs shorthand
• chore: better negative mathing

Windows Install

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

MacOS Install

• Download Firebot-v5.61.2-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.61.2-linux-x64.tar.gz
• Unpack Firebot-v5.61.2-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.61.1

v5.61.1 Hotfix Notes

✅ Fixed

• Fixed an issue where we weren't handling corrupt JsonDB files properly (#2405)

v5.61.0 Update Notes

Caution

Several advanced variables may now work differently or have been deprecated in this release (e.g. any variables that begin with $array, $object, $raw or $regex). PLEASE test and update your setups accordingly to ensure they work as expected. For a full list of related changes, please see this wiki article

✨ New

• Firebot's variable processing engine has been overhauled
• Introducing: Firebot Featured Streams! You may now opt-in to have your stream featured on the Firebot website when you're live. Just go to Settings > General and enable Feature My Stream on Firebot.app
• The top bar now indicates the status of an active Hype Train (#2087)
• Commands, Channel Rewards, Timers, and Scheduled Effect Lists can be enabled/disabled via tag (#576) (#2342)
• Added an option on the Commands tab to manually clear cooldowns on both individual commands and all commands (#1947)
• Custom variables may now be accessed via $$ in addition to $customVariable (e.g. $$myVar is the same as $customVariable[myVar] and $$myVar[path, to, value] is the same as $customVariable[myVar, path.to.value])
• Effect outputs may now be accessed via $& in addition to $effectOutputs (e.g. $&httpRequest is the same as $effectOutputs[httpRequest] and $&httpRequest[path, to, value] is the same as $effectOutputs[httpRequest, path.to.value])
• Added exact matching for the $arrayFind* variables
• Added new $userIsBanned and $userIsTimedOut variables (#2330)
• Added new $pronouns variable (#2187) (#2341)
• Added new $extraLifeInfo, $extraLifeMilestones, $extraLifeDonations, and $extraLifeIncentives variables (#2229) (#2343)
• Added new $arrayRandomItem, $filesInDirectory, $textPadStart, and $textPadEnd variables
• Added new $null, $true and $false variables
• Added default currency option for !steam system command (#2138)
• Added new Before Firebot Closed event (#2332) (#2347)
• Added new Evaluate JavaScript effect and $evalJs variable. These will allow you to run simple, very limited JavaScript functions for advanced processing.
• The Evaluate JavaScript effect and $evalJs variable can now access custom variables via Firebot.getCustomVariable(varName) and effect outputs via Firebot.getEffectOutput(outputName)
• Added --fbuser-data-directory and --fbsecrets-config command line flags

🛠️ Improved

• Clarified the tooltip around storing Twitch clip URLs in a custom variable (#2392)
• Command cooldowns are no longer cleared inadvertently in multiple scenarios, including when switching to the Commands tab or when using the Toggle Command effect (#1947)
• We now better handle usernames in several scenarios, including those with Unicode/international characters in their usernames (#2123) (#2131) (#2390)
• Usernames now get updated when users appear in chat after they change their username (#2198)
• The !commands command now allows for custom chat output (#2339)
• Cleaned up the command data export when using !commands
• The Run Program effect can now read output (#1176)
• Whisper events are no longer cached, meaning they will trigger with each message, just like chat messages
• The known bot list is now loaded when connecting to Twitch if it failed to load previously (#2349)
• The $followCount variable should more consistently return a value (#2368)
• The $subNames variable now includes display names (#2379)
• The Log Message effect now has a multiline editor for the message
• Backups created on Windows will now properly restore on non-Windows systems
• Several internal Firebot systems have been refactored/updated (viewer database, command handlers, currency, in-app notifications, backups)
• Misc improvements/typo fixes

✅ Fixed

• Fixed an issue with 7TV channel emotes
• Fixed an issue with Raid event metadata
• Fixed an issue where quick actions may not import correctly from a Firebot setup (#2376)
• Fixed an issue where quick actions may not show up after being added from the Dashboard (#2401) (#2402)
• Fixed an issue with effect outputs causing an error in Loop Effects effect
• Conditional effects now properly read previous effect outputs
• Fixed an issue where $chatMessage variable does not return the full chat message for a command with a regex trigger (#2394)
• Fixed an issue where variables may unexpectedly return [object Object] (#2323)
• Fixed an issue where HTTP routes registered via custom scripts may erroneously include backslashes

🔗 API Changes

• Added new GET /timers/:timerId/:action API endpoint (#2395) (#2396)
• Custom script parametersUpdated() and stop() functions are now properly called (#2337) (#2338)
• Bumped Electron to 28.2.3

Windows Install

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

MacOS Install

• Download Firebot-v5.61.1-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.61.1-linux-x64.tar.gz
• ?? will need further instructions

Note: Linux does not receive auto-updates

Release v5.61.0

v5.61.0 Update Notes

Caution

Several advanced variables may now work differently or have been deprecated in this release (e.g. any variables that begin with $array, $object, $raw or $regex). PLEASE test and update your setups accordingly to ensure they work as expected. For a full list of related changes, please see this wiki article

✨ New

• Firebot's variable processing engine has been overhauled
• Introducing: Firebot Featured Streams! You may now opt-in to have your stream featured on the Firebot website when you're live. Just go to Settings > General and enable Feature My Stream on Firebot.app
• The top bar now indicates the status of an active Hype Train (#2087)
• Commands, Channel Rewards, Timers, and Scheduled Effect Lists can be enabled/disabled via tag (#576) (#2342)
• Added an option on the Commands tab to manually clear cooldowns on both individual commands and all commands (#1947)
• Custom variables may now be accessed via $$ in addition to $customVariable (e.g. $$myVar is the same as $customVariable[myVar] and $$myVar[path, to, value] is the same as $customVariable[myVar, path.to.value])
• Effect outputs may now be accessed via $& in addition to $effectOutputs (e.g. $&httpRequest is the same as $effectOutputs[httpRequest] and $&httpRequest[path, to, value] is the same as $effectOutputs[httpRequest, path.to.value])
• Added exact matching for the $arrayFind* variables
• Added new $userIsBanned and $userIsTimedOut variables (#2330)
• Added new $pronouns variable (#2187) (#2341)
• Added new $extraLifeInfo, $extraLifeMilestones, $extraLifeDonations, and $extraLifeIncentives variables (#2229) (#2343)
• Added new $arrayRandomItem, $filesInDirectory, $textPadStart, and $textPadEnd variables
• Added new $null, $true and $false variables
• Added default currency option for !steam system command (#2138)
• Added new Before Firebot Closed event (#2332) (#2347)
• Added new Evaluate JavaScript effect and $evalJs variable. These will allow you to run simple, very limited JavaScript functions for advanced processing.
• The Evaluate JavaScript effect and $evalJs variable can now access custom variables via Firebot.getCustomVariable(varName) and effect outputs via Firebot.getEffectOutput(outputName)
• Added --fbuser-data-directory and --fbsecrets-config command line flags

🛠️ Improved

• Clarified the tooltip around storing Twitch clip URLs in a custom variable (#2392)
• Command cooldowns are no longer cleared inadvertently in multiple scenarios, including when switching to the Commands tab or when using the Toggle Command effect (#1947)
• We now better handle usernames in several scenarios, including those with Unicode/international characters in their usernames (#2123) (#2131) (#2390)
• Usernames now get updated when users appear in chat after they change their username (#2198)
• The !commands command now allows for custom chat output (#2339)
• Cleaned up the command data export when using !commands
• The Run Program effect can now read output (#1176)
• Whisper events are no longer cached, meaning they will trigger with each message, just like chat messages
• The known bot list is now loaded when connecting to Twitch if it failed to load previously (#2349)
• The $followCount variable should more consistently return a value (#2368)
• The $subNames variable now includes display names (#2379)
• The Log Message effect now has a multiline editor for the message
• Backups created on Windows will now properly restore on non-Windows systems
• Several internal Firebot systems have been refactored/updated (viewer database, command handlers, currency, in-app notifications, backups)
• Misc improvements/typo fixes

✅ Fixed

• Fixed an issue with 7TV channel emotes
• Fixed an issue with Raid event metadata
• Fixed an issue where quick actions may not import correctly from a Firebot setup (#2376)
• Fixed an issue where quick actions may not show up after being added from the Dashboard (#2401) (#2402)
• Fixed an issue with effect outputs causing an error in Loop Effects effect
• Conditional effects now properly read previous effect outputs
• Fixed an issue where $chatMessage variable does not return the full chat message for a command with a regex trigger (#2394)
• Fixed an issue where variables may unexpectedly return [object Object] (#2323)
• Fixed an issue where HTTP routes registered via custom scripts may erroneously include backslashes

🔗 API Changes

• Added new GET /timers/:timerId/:action API endpoint (#2395) (#2396)
• Custom script parametersUpdated() and stop() functions are now properly called (#2337) (#2338)
• Bumped Electron to 28.2.3

Windows Install

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

MacOS Install

• Download Firebot-v5.61.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.61.0-linux-x64.tar.gz
• ?? will need further instructions

Note: Linux does not receive auto-updates

Release v5.61.0-beta5

v5.61.0-beta5 Changes

Caution

Several advanced variables may now work differently or have been deprecated in this release (e.g. any variables that begin with $array, $object, $raw or $regex). PLEASE test and update your setups accordingly to ensure they work as expected. For a full list of related changes, please see this wiki article

🛠️ Improved

• Reverted a change from beta1 that monitored EventSub connection that was not working as expected

✅ Fixed

• Fixed an issue from beta2 where variables that required specific trigger types would not allow effects to be saved

v5.61.0-beta4 Changes

✅ Fixed

• Fixed an issue from beta1 where variables related to user metadata or currency would not return correct data

v5.61.0-beta3 Changes

🛠️ Improved

• Cleaned up the command data export when using !commands

✅ Fixed

• Fixed an issue from beta2 where variables would not properly validate when editing effects
• Fixed an issue from beta1 where $readFile would not work properly when specifying a line number

v5.61.0-beta2 Changes

✨ New

• Introducing: Firebot Featured Streams! You may now opt-in to have your stream featured on the Firebot website when you're live. Just go to Settings > General and enable Feature My Stream on Firebot.app
• Custom variables may now be accessed via $$ (e.g. $$myVar is the same as $customVariable[myVar] and $$myVar[path, to, value] is the same as $customVariable[myVar, path.to.value])
• Effect outputs may now be accessed via $& (e.g. $&httpRequest is the same as $effectOutputs[httpRequest] and $&httpRequest[path, to, value] is the same as $effectOutputs[httpRequest, path.to.value])
• Added exact matching for the $arrayFind* variables
• The Evaluate JavaScript effect and $evalJs variable can now access custom variables via firebot.getCustomVariable(varName) and effect outputs via firebot.getEffectOutput(outputName)
• Added --fbuser-data-directory and --fbsecrets-config command line flags

🛠️ Improved

• Clarified the tooltip around storing Twitch clip URLs in a custom variable (#2392)

✅ Fixed

• Fixed an issue with 7TV channel emotes
• Fixed an issue from beta1 where custom commands would not refresh immediately when renamed

v5.61.0-beta1 Update Notes

✨ New

• Firebot's variable processing engine has been overhauled
• The top bar now indicates the status of an active Hype Train (#2087)
• Commands, Channel Rewards, Timers, and Scheduled Effect Lists can be enabled/disabled via tag (#576) (#2342)
• Added an option on the Commands tab to manually clear cooldowns on both individual commands and all commands (#1947)
• Added new $userIsBanned and $userIsTimedOut variables (#2330)
• Added new $pronouns variable (#2187) (#2341)
• Added new $extraLifeInfo, $extraLifeMilestones, $extraLifeDonations, and $extraLifeIncentives variables (#2229) (#2343)
• Added new $arrayRandomItem, $filesInDirectory, $textPadStart, and $textPadEnd variables
• Added new $null, $true and $false variables
• Added default currency option for !steam system command (#2138)
• Added new Before Firebot Closed event (#2332) (#2347)
• Added new Evaluate JavaScript effect and $evalJs variable. These will allow you to run simple, very limited JavaScript functions for advanced processing.

🛠️ Improved

• Command cooldowns are no longer cleared inadvertently in multiple scenarios, including when switching to the Commands tab or when using the Toggle Command effect (#1947)
• We now better handle usernames in several scenarios, including those with Unicode/international characters in their usernames (#2123) (#2131) (#2390)
• Usernames now get updated when users appear in chat after they change their username (#2198)
• The !commands command now allows for custom chat output (#2339)
• The Run Program effect can now read output (#1176)
• Whisper events are no longer cached, meaning they will trigger with each message, just like chat messages
• The known bot list is now loaded when connecting to Twitch if it failed to load previously (#2349)
• The $followCount variable should more consistently return a value (#2368)
• The $subNames variable now includes display names (#2379)
• Firebot now monitors and attempts to resubscribe to any EventSub subscriptions that may have become invalid
• The Log Message effect now has a multiline editor for the message
• Backups created on Windows will now properly restore on non-Windows systems
• Several internal Firebot systems have been refactored/updated (viewer database, command handlers, currency, in-app notifications, backups)

✅ Fixed

• Fixed an issue with Raid event metadata
• Fixed an issue where quick actions may not import correctly from a Firebot setup (#2376)
• Fixed an issue with effect outputs causing an error in Loop Effects effect
• Conditional effects now properly read previous effect outputs
• Fixed an issue where $chatMessage variable does not return the full chat message for a command with a regex trigger (#2394)
• Fixed an issue where variables may unexpectedly return [object Object] (#2323)
• Fixed an issue where HTTP routes registered via custom scripts may erroneously include backslashes

🔗 API Changes

• Added new GET /timers/:timerId/:action API endpoint (#2395) (#2396)
• Custom script parametersUpdated() and stop() functions are now properly called (#2337) (#2338)
• Bumped Electron to 28.2.2

Windows Install

• Download and run Firebot-v5.61.0-beta5-setup.exe

MacOS Install

• Download Firebot-v5.61.0-beta5-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.61.0-beta5-linux-x64.tar.gz
• ?? will need further instructions

Note: Linux does not receive auto-updates

Release v5.61.0-beta4

v5.61.0-beta4 Changes

Caution

Several advanced variables may now work differently or have been deprecated in this release (e.g. any variables that begin with $array, $object, $raw or $regex). PLEASE test and update your setups accordingly to ensure they work as expected. For a full list of related changes, please see this wiki article

✅ Fixed

• Fixed an issue from beta1 where variables related to user metadata or currency would not return correct data

v5.61.0-beta3 Changes

🛠️ Improved

• Cleaned up the command data export when using !commands

✅ Fixed

• Fixed an issue from beta2 where variables would not properly validate when editing effects
• Fixed an issue from beta1 where $readFile would not work properly when specifying a line number

v5.61.0-beta2 Changes

✨ New

• Introducing: Firebot Featured Streams! You may now opt-in to have your stream featured on the Firebot website when you're live. Just go to Settings > General and enable Feature My Stream on Firebot.app
• Custom variables may now be accessed via $$ (e.g. $$myVar is the same as $customVariable[myVar] and $$myVar[path, to, value] is the same as $customVariable[myVar, path.to.value])
• Effect outputs may now be accessed via $& (e.g. $&httpRequest is the same as $effectOutputs[httpRequest] and $&httpRequest[path, to, value] is the same as $effectOutputs[httpRequest, path.to.value])
• Added exact matching for the $arrayFind* variables
• The Evaluate JavaScript effect and $evalJs variable can now access custom variables via firebot.getCustomVariable(varName) and effect outputs via firebot.getEffectOutput(outputName)
• Added --fbuser-data-directory and --fbsecrets-config command line flags

🛠️ Improved

• Clarified the tooltip around storing Twitch clip URLs in a custom variable (#2392)

✅ Fixed

• Fixed an issue with 7TV channel emotes
• Fixed an issue from beta1 where custom commands would not refresh immediately when renamed

v5.61.0-beta1 Update Notes

✨ New

• Firebot's variable processing engine has been overhauled
• The top bar now indicates the status of an active Hype Train (#2087)
• Commands, Channel Rewards, Timers, and Scheduled Effect Lists can be enabled/disabled via tag (#576) (#2342)
• Added an option on the Commands tab to manually clear cooldowns on both individual commands and all commands (#1947)
• Added new $userIsBanned and $userIsTimedOut variables (#2330)
• Added new $pronouns variable (#2187) (#2341)
• Added new $extraLifeInfo, $extraLifeMilestones, $extraLifeDonations, and $extraLifeIncentives variables (#2229) (#2343)
• Added new $arrayRandomItem, $filesInDirectory, $textPadStart, and $textPadEnd variables
• Added new $null, $true and $false variables
• Added default currency option for !steam system command (#2138)
• Added new Before Firebot Closed event (#2332) (#2347)
• Added new Evaluate JavaScript effect and $evalJs variable. These will allow you to run simple, very limited JavaScript functions for advanced processing.

🛠️ Improved

• Command cooldowns are no longer cleared inadvertently in multiple scenarios, including when switching to the Commands tab or when using the Toggle Command effect (#1947)
• We now better handle usernames in several scenarios, including those with Unicode/international characters in their usernames (#2123) (#2131) (#2390)
• Usernames now get updated when users appear in chat after they change their username (#2198)
• The !commands command now allows for custom chat output (#2339)
• The Run Program effect can now read output (#1176)
• Whisper events are no longer cached, meaning they will trigger with each message, just like chat messages
• The known bot list is now loaded when connecting to Twitch if it failed to load previously (#2349)
• The $followCount variable should more consistently return a value (#2368)
• The $subNames variable now includes display names (#2379)
• Firebot now monitors and attempts to resubscribe to any EventSub subscriptions that may have become invalid
• The Log Message effect now has a multiline editor for the message
• Backups created on Windows will now properly restore on non-Windows systems
• Several internal Firebot systems have been refactored/updated (viewer database, command handlers, currency, in-app notifications, backups)

✅ Fixed

• Fixed an issue with Raid event metadata
• Fixed an issue where quick actions may not import correctly from a Firebot setup (#2376)
• Fixed an issue with effect outputs causing an error in Loop Effects effect
• Conditional effects now properly read previous effect outputs
• Fixed an issue where $chatMessage variable does not return the full chat message for a command with a regex trigger (#2394)
• Fixed an issue where variables may unexpectedly return [object Object] (#2323)
• Fixed an issue where HTTP routes registered via custom scripts may erroneously include backslashes

🔗 API Changes

• Added new GET /timers/:timerId/:action API endpoint (#2395) (#2396)
• Custom script parametersUpdated() and stop() functions are now properly called (#2337) (#2338)
• Bumped Electron to 28.2.2

Windows Install

• Download and run Firebot-v5.61.0-beta4-setup.exe

MacOS Install

• Download Firebot-v5.61.0-beta4-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.61.0-beta4-linux-x64.tar.gz
• ?? will need further instructions

Note: Linux does not receive auto-updates

Release v5.61.0-beta3

v5.61.0-beta3 Changes

Caution

Several advanced variables may now work differently or have been deprecated in this release (e.g. any variables that begin with $array, $object, $raw or $regex). PLEASE test and update your setups accordingly to ensure they work as expected. For a full list of related changes, please see this wiki article

🛠️ Improved

• Cleaned up the command data export when using !commands

✅ Fixed

• Fixed an issue from beta2 where variables would not properly validate when editing effects
• Fixed an issue from beta1 where $readFile would not work properly when specifying a line number

v5.61.0-beta2 Changes

✨ New

• Introducing: Firebot Featured Streams! You may now opt-in to have your stream featured on the Firebot website when you're live. Just go to Settings > General and enable Feature My Stream on Firebot.app
• Custom variables may now be accessed via $$ (e.g. $$myVar is the same as $customVariable[myVar] and $$myVar[path, to, value] is the same as $customVariable[myVar, path.to.value])
• Effect outputs may now be accessed via $& (e.g. $&httpRequest is the same as $effectOutputs[httpRequest] and $&httpRequest[path, to, value] is the same as $effectOutputs[httpRequest, path.to.value])
• Added exact matching for the $arrayFind* variables
• The Evaluate JavaScript effect and $evalJs variable can now access custom variables via firebot.getCustomVariable(varName) and effect outputs via firebot.getEffectOutput(outputName)
• Added --fbuser-data-directory and --fbsecrets-config command line flags

🛠️ Improved

• Clarified the tooltip around storing Twitch clip URLs in a custom variable (#2392)

✅ Fixed

• Fixed an issue with 7TV channel emotes
• Fixed an issue from beta1 where custom commands would not refresh immediately when renamed

v5.61.0-beta1 Update Notes

✨ New

• Firebot's variable processing engine has been overhauled
• The top bar now indicates the status of an active Hype Train (#2087)
• Commands, Channel Rewards, Timers, and Scheduled Effect Lists can be enabled/disabled via tag (#576) (#2342)
• Added an option on the Commands tab to manually clear cooldowns on both individual commands and all commands (#1947)
• Added new $userIsBanned and $userIsTimedOut variables (#2330)
• Added new $pronouns variable (#2187) (#2341)
• Added new $extraLifeInfo, $extraLifeMilestones, $extraLifeDonations, and $extraLifeIncentives variables (#2229) (#2343)
• Added new $arrayRandomItem, $filesInDirectory, $textPadStart, and $textPadEnd variables
• Added new $null, $true and $false variables
• Added default currency option for !steam system command (#2138)
• Added new Before Firebot Closed event (#2332) (#2347)
• Added new Evaluate JavaScript effect and $evalJs variable. These will allow you to run simple, very limited JavaScript functions for advanced processing.

🛠️ Improved

• Command cooldowns are no longer cleared inadvertently in multiple scenarios, including when switching to the Commands tab or when using the Toggle Command effect (#1947)
• We now better handle usernames in several scenarios, including those with Unicode/international characters in their usernames (#2123) (#2131) (#2390)
• Usernames now get updated when users appear in chat after they change their username (#2198)
• The !commands command now allows for custom chat output (#2339)
• The Run Program effect can now read output (#1176)
• Whisper events are no longer cached, meaning they will trigger with each message, just like chat messages
• The known bot list is now loaded when connecting to Twitch if it failed to load previously (#2349)
• The $followCount variable should more consistently return a value (#2368)
• The $subNames variable now includes display names (#2379)
• Firebot now monitors and attempts to resubscribe to any EventSub subscriptions that may have become invalid
• The Log Message effect now has a multiline editor for the message
• Backups created on Windows will now properly restore on non-Windows systems
• Several internal Firebot systems have been refactored/updated (viewer database, command handlers, currency, in-app notifications, backups)

✅ Fixed

• Fixed an issue with Raid event metadata
• Fixed an issue where quick actions may not import correctly from a Firebot setup (#2376)
• Fixed an issue with effect outputs causing an error in Loop Effects effect
• Conditional effects now properly read previous effect outputs
• Fixed an issue where $chatMessage variable does not return the full chat message for a command with a regex trigger (#2394)
• Fixed an issue where variables may unexpectedly return [object Object] (#2323)
• Fixed an issue where HTTP routes registered via custom scripts may erroneously include backslashes

🔗 API Changes

• Added new GET /timers/:timerId/:action API endpoint (#2395) (#2396)
• Custom script parametersUpdated() and stop() functions are now properly called (#2337) (#2338)
• Bumped Electron to 28.2.2

Windows Install

• Download and run Firebot-v5.61.0-beta3-setup.exe

MacOS Install

• Download Firebot-v5.61.0-beta3-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.61.0-beta3-linux-x64.tar.gz
• ?? will need further instructions

Note: Linux does not receive auto-updates

Release v5.61.0-beta2

v5.61.0-beta2 Changes

Caution

Several advanced variables may now work differently or have been deprecated in this release (e.g. any variables that begin with $array, $object, $raw or $regex). PLEASE test and update your setups accordingly to ensure they work as expected. For a full list of related changes, please see this wiki article

✨ New

• Introducing: Firebot Featured Streams! You may now opt-in to have your stream featured on the Firebot website when you're live. Just go to Settings > General and enable Feature My Stream on Firebot.app
• Custom variables may now be accessed via $$ (e.g. $$myVar is the same as $customVariable[myVar] and $$myVar[path, to, value] is the same as $customVariable[myVar, path.to.value])
• Effect outputs may now be accessed via $& (e.g. $&httpRequest is the same as $effectOutputs[httpRequest] and $&httpRequest[path, to, value] is the same as $effectOutputs[httpRequest, path.to.value])
• Added exact matching for the $arrayFind* variables
• The Evaluate JavaScript effect and $evalJs variable can now access custom variables via firebot.getCustomVariable(varName) and effect outputs via firebot.getEffectOutput(outputName)
• Added --fbuser-data-directory and --fbsecrets-config command line flags

🛠️ Improved

• Clarified the tooltip around storing Twitch clip URLs in a custom variable (#2392)

✅ Fixed

• Fixed an issue with 7TV channel emotes
• Fixed an issue from beta1 where custom commands would not refresh immediately when renamed

v5.61.0-beta1 Update Notes

✨ New

• Firebot's variable processing engine has been overhauled
• The top bar now indicates the status of an active Hype Train (#2087)
• Commands, Channel Rewards, Timers, and Scheduled Effect Lists can be enabled/disabled via tag (#576) (#2342)
• Added an option on the Commands tab to manually clear cooldowns on both individual commands and all commands (#1947)
• Added new $userIsBanned and $userIsTimedOut variables (#2330)
• Added new $pronouns variable (#2187) (#2341)
• Added new $extraLifeInfo, $extraLifeMilestones, $extraLifeDonations, and $extraLifeIncentives variables (#2229) (#2343)
• Added new $arrayRandomItem, $filesInDirectory, $textPadStart, and $textPadEnd variables
• Added new $null, $true and $false variables
• Added default currency option for !steam system command (#2138)
• Added new Before Firebot Closed event (#2332) (#2347)
• Added new Evaluate JavaScript effect and $evalJs variable. These will allow you to run simple, very limited JavaScript functions for advanced processing.

🛠️ Improved

• Command cooldowns are no longer cleared inadvertently in multiple scenarios, including when switching to the Commands tab or when using the Toggle Command effect (#1947)
• We now better handle usernames in several scenarios, including those with Unicode/international characters in their usernames (#2123) (#2131) (#2390)
• Usernames now get updated when users appear in chat after they change their username (#2198)
• The !commands command now allows for custom chat output (#2339)
• The Run Program effect can now read output (#1176)
• Whisper events are no longer cached, meaning they will trigger with each message, just like chat messages
• The known bot list is now loaded when connecting to Twitch if it failed to load previously (#2349)
• The $followCount variable should more consistently return a value (#2368)
• The $subNames variable now includes display names (#2379)
• Firebot now monitors and attempts to resubscribe to any EventSub subscriptions that may have become invalid
• The Log Message effect now has a multiline editor for the message
• Backups created on Windows will now properly restore on non-Windows systems
• Several internal Firebot systems have been refactored/updated (viewer database, command handlers, currency, in-app notifications, backups)

✅ Fixed

• Fixed an issue with Raid event metadata
• Fixed an issue where quick actions may not import correctly from a Firebot setup (#2376)
• Fixed an issue with effect outputs causing an error in Loop Effects effect
• Conditional effects now properly read previous effect outputs
• Fixed an issue where $chatMessage variable does not return the full chat message for a command with a regex trigger (#2394)
• Fixed an issue where variables may unexpectedly return [object Object] (#2323)
• Fixed an issue where HTTP routes registered via custom scripts may erroneously include backslashes

🔗 API Changes

• Added new GET /timers/:timerId/:action API endpoint (#2395) (#2396)
• Custom script parametersUpdated() and stop() functions are now properly called (#2337) (#2338)
• Bumped Electron to 28.2.2

Windows Install

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

MacOS Install

• Download Firebot-v5.61.0-beta2-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.61.0-beta2-linux-x64.tar.gz
• ?? will need further instructions

Note: Linux does not receive auto-updates

Release v5.61.0-beta1

v5.61.0-beta1 Update Notes

Caution

Several advanced variables may now work differently or have been deprecated in this release (e.g. any variables that begin with $array, $object, $raw or $regex). PLEASE test and update your setups accordingly to ensure they work as expected. For a full list of related changes, please see this wiki article

✨ New

• Firebot's variable processing engine has been overhauled
• The top bar now indicates the status of an active Hype Train (#2087)
• Commands, Channel Rewards, Timers, and Scheduled Effect Lists can be enabled/disabled via tag (#576) (#2342)
• Added an option on the Commands tab to manually clear cooldowns on both individual commands and all commands (#1947)
• Added new $userIsBanned and $userIsTimedOut variables (#2330)
• Added new $pronouns variable (#2187) (#2341)
• Added new $extraLifeInfo, $extraLifeMilestones, $extraLifeDonations, and $extraLifeIncentives variables (#2229) (#2343)
• Added new $arrayRandomItem, $filesInDirectory, $textPadStart, and $textPadEnd variables
• Added new $null, $true and $false variables
• Added default currency option for !steam system command (#2138)
• Added new Before Firebot Closed event (#2332) (#2347)
• Added new Evaluate JavaScript effect and $evalJs variable. These will allow you to run simple, very limited JavaScript functions for advanced processing.

🛠️ Improved

• Command cooldowns are no longer cleared inadvertently in multiple scenarios, including when switching to the Commands tab or when using the Toggle Command effect (#1947)
• We now better handle usernames in several scenarios, including those with Unicode/international characters in their usernames (#2123) (#2131) (#2390)
• Usernames now get updated when users appear in chat after they change their username (#2198)
• The !commands command now allows for custom chat output (#2339)
• The Run Program effect can now read output (#1176)
• Whisper events are no longer cached, meaning they will trigger with each message, just like chat messages
• The known bot list is now loaded when connecting to Twitch if it failed to load previously (#2349)
• The $followCount variable should more consistently return a value (#2368)
• The $subNames variable now includes display names (#2379)
• Firebot now monitors and attempts to resubscribe to any EventSub subscriptions that may have become invalid
• The Log Message effect now has a multiline editor for the message
• Backups created on Windows will now properly restore on non-Windows systems
• Several internal Firebot systems have been refactored/updated (viewer database, command handlers, currency, in-app notifications, backups)

✅ Fixed

• Fixed an issue with Raid event metadata
• Fixed an issue where quick actions may not import correctly from a Firebot setup (#2376)
• Fixed an issue with effect outputs causing an error in Loop Effects effect
• Conditional effects now properly read previous effect outputs
• Fixed an issue where $chatMessage variable does not return the full chat message for a command with a regex trigger (#2394)
• Fixed an issue where variables may unexpectedly return [object Object] (#2323)
• Fixed an issue where HTTP routes registered via custom scripts may erroneously include backslashes

🔗 API Changes

• Added new GET /timers/:timerId/:action API endpoint (#2395) (#2396)
• Custom script parametersUpdated() and stop() functions are now properly called (#2337) (#2338)
• Bumped Electron to 28.2.2

Windows Install

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

MacOS Install

• Download Firebot-v5.61.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

• Download Firebot-v5.61.0-beta1-linux-x64.tar.gz
• ?? will need further instructions

Note: Linux does not receive auto-updates