v2.1.0

THSV StreamBridge 2.1.0

THSV StreamBridge 2.1.0 is a stable release promoting 2.1.0-rc.1 with no code changes, gathering fixes and small additions on top of 2.0.0. It carries no v2 core-contract changes.

Fixed

• Wizard-imported Streamer.bot commands (for example !tips) could look correct in Streamer.bot's own edit dialog — Enabled, correct Sources, correct Mode/Location, correct alias list — and still never fire from chat, while deleting and retyping the identical command by hand worked immediately. Two real structural bugs, found by diffing a real export of a working, hand-typed command against generator output: the wizard joined alias lines with LF instead of the CRLF Streamer.bot's own editor uses, and a hand-typed command carries an internal comma-separated mirror of the alias list in an undocumented property the wizard never emitted. Also fixed a related no-op: the "Ignore Internal Messages" option was being written to a property name that doesn't exist in Streamer.bot's real schema, so it silently had no effect on any generated command. Live-verified: re-importing a wizard-generated command into a real Streamer.bot instance now fires correctly from chat without a manual rewrite.
• A custom-script wizard command whose creator pasted a full Streamer.bot action instead of just the response-method body produced invalid, silently-uncompilable C#. Custom scripts now generate as the body of a dedicated method the real Execute() calls, and the wizard rejects a pasted full action immediately with an explanation instead of generating broken code.
• channelId/channelName on native platform intake, and the {channel} template token in wizard-generated commands, silently resolved to an empty string on YouTube and Kick because of a case-sensitive Streamer.bot argument-name mismatch (broadcastUserName on Twitch vs. broadcastUsername on YouTube/Kick). Every YouTube and Kick chat message or event relayed through native intake was silently rejected as invalid, not merely missing a display value. Native Platform Intake bumped to 1.5.0.

Added

• A live preview pane in the Chat Overlay editor, mirroring the Alerts editor's existing live preview.
• Seven new Command Sync starter templates: Merch, PC specs / gear, VOD / replays, Emotes, Clip, Bot credit, and Timezone.
• Windows toast notifications from the Bridge Launcher's Launch/Shutdown actions, since they intentionally run with no visible console window.

Changed

• The Timed Actions templates (Social rotation, Hydration, Stretch) now set up a complete ready-to-stage timer in one pass, instead of requiring a fresh Streamer.bot inspection before staging.

Safety boundaries

Unchanged from 2.0.0:

• The runtime blocks high-impact operations for events without verified provider-stable IDs, independent of release labeling. A genuine live-stream, real-viewer soak of the high-impact provider-event matrix is still in progress; see production-readiness.
• Do not use TikFinity financial or progression events for production statistics or irreversible actions until provider-stable event identity and simulator provenance are verified live.
• Kick reward mutations remain disabled because Streamer.bot does not document them.
• This is an unsigned portable ZIP. Verify both its adjacent SHA-256 file and GitHub artifact attestation before installation.

Acceptance evidence

• Full automated gate passes from the rc.1 source: lint, typecheck, and the unit + integration suite (401 + 31 tests).
• The wizard-command chat-matching fix, the headline fix in this release, was live-verified: a command generated and imported through the wizard now fires from chat on the first import, confirmed against a real Streamer.bot instance.
• Packaged Windows installer acceptance and Playwright browser checks for this specific candidate have not been separately re-run in this cycle; the release workflow rebuilds from the exact tag and publishes a SHA-256 checksum, CycloneDX SBOM, and provenance attestations.

Install

Download THSV-StreamBridge-2.1.0.zip and its .sha256 file from this release, verify them using RELEASE-VERIFICATION.md, extract the archive, and run Install THSV StreamBridge.cmd.

Normal upgrades preserve creator configuration, secrets, uploads, logs, backups, add-on packages, and add-on state. Default uninstall also preserves creator-owned data.

v2.1.0-rc.1

THSV StreamBridge 2.1.0-rc.1

THSV StreamBridge 2.1.0-rc.1 is a release candidate gathering fixes and small additions on top of the stable 2.0.0 release. It carries no v2 core-contract changes.

Fixed

• Wizard-imported Streamer.bot commands (for example !tips) could look correct in Streamer.bot's own edit dialog — Enabled, correct Sources, correct Mode/Location, correct alias list — and still never fire from chat, while deleting and retyping the identical command by hand worked immediately. Two real structural bugs, found by diffing a real export of a working, hand-typed command against generator output: the wizard joined alias lines with LF instead of the CRLF Streamer.bot's own editor uses, and a hand-typed command carries an internal comma-separated mirror of the alias list in an undocumented property the wizard never emitted. Also fixed a related no-op: the "Ignore Internal Messages" option was being written to a property name that doesn't exist in Streamer.bot's real schema, so it silently had no effect on any generated command.
• A custom-script wizard command whose creator pasted a full Streamer.bot action instead of just the response-method body produced invalid, silently-uncompilable C#. Custom scripts now generate as the body of a dedicated method the real Execute() calls, and the wizard rejects a pasted full action immediately with an explanation instead of generating broken code.
• channelId/channelName on native platform intake, and the {channel} template token in wizard-generated commands, silently resolved to an empty string on YouTube and Kick because of a case-sensitive Streamer.bot argument-name mismatch (broadcastUserName on Twitch vs. broadcastUsername on YouTube/Kick). Every YouTube and Kick chat message or event relayed through native intake was silently rejected as invalid, not merely missing a display value. Native Platform Intake bumped to 1.5.0.

Added

• A live preview pane in the Chat Overlay editor, mirroring the Alerts editor's existing live preview.
• Seven new Command Sync starter templates: Merch, PC specs / gear, VOD / replays, Emotes, Clip, Bot credit, and Timezone.
• Windows toast notifications from the Bridge Launcher's Launch/Shutdown actions, since they intentionally run with no visible console window.

Changed

• The Timed Actions templates (Social rotation, Hydration, Stretch) now set up a complete ready-to-stage timer in one pass, instead of requiring a fresh Streamer.bot inspection before staging.

Safety boundaries

Unchanged from 2.0.0:

• The runtime blocks high-impact operations for events without verified provider-stable IDs, independent of release labeling. A genuine live-stream, real-viewer soak of the high-impact provider-event matrix is still in progress; see production-readiness.
• Do not use TikFinity financial or progression events for production statistics or irreversible actions until provider-stable event identity and simulator provenance are verified live.
• Kick reward mutations remain disabled because Streamer.bot does not document them.
• This is an unsigned portable ZIP. Verify both its adjacent SHA-256 file and GitHub artifact attestation before installation.

Acceptance evidence

• Full automated gate passes from the rc.1 source: lint, typecheck, and the unit + integration suite (401 + 31 tests).
• Packaged Windows installer acceptance and Playwright browser checks for this specific candidate have not been separately re-run in this cycle; the release workflow still rebuilds from the exact tag and publishes a SHA-256 checksum, CycloneDX SBOM, and provenance attestations.

Install

Download THSV-StreamBridge-2.1.0-rc.1.zip and its .sha256 file from this release, verify them using RELEASE-VERIFICATION.md, extract the archive, and run Install THSV StreamBridge.cmd.

Normal upgrades preserve creator configuration, secrets, uploads, logs, backups, add-on packages, and add-on state. Default uninstall also preserves creator-owned data.

Release v2.0.0 stable

THSV StreamBridge 2.0.0

THSV StreamBridge 2.0.0 is the stable release of the revised v2 core and add-on platform, promoting 2.0.0-rc.4 with no code changes. It replaces the 1.x line as the current public Windows release.

Highlights of the v2 line

• Unified Twitch, YouTube, Kick, and TikFinity relay intake through one Streamer.bot WebSocket connection, normalized into one predictable event contract.
• A rebuilt authenticated setup wizard: consistent list-plus-editor panels for Alerts, Command Sync, Timed Actions, and Advanced Blockers; collapsible sections; plain-language explanations on every toggle; and a live Alerts preview.
• Alert media and layout control: per-event background images, animated GIFs, or short videos with their own embedded audio; independent text-layout (Classic/Stacked/Centered) and media-placement (Behind/Below/Inset) presets.
• Wizard-designed Streamer.bot commands with per-platform responses, collision checking against a live inspection, and reproducible package export.
• Session-relative timed actions with per-platform message rotations, activity/live/scene gates, and missed-run policies.
• Durable at-least-once Streamer.bot delivery with restart replay, bounded retry, ordered lanes, and dead letters.
• Approval-gated .thsv-addon packages with scoped permissions, private state, and core-hosted overlay rendering.

Included

• A self-contained Windows x64 archive (THSV-StreamBridge-2.0.0.zip) with pinned Node.js runtime and no global Node.js, npm, Docker, database, or administrator requirement.
• A state-preserving installer, replacement-start handling, upgrade rollback, conservative uninstall, and authenticated local setup wizard.
• SHA-256 archive checksum, CycloneDX SBOM, and GitHub artifact attestations from the release workflow.

Safety boundaries

• The runtime blocks high-impact operations for events without verified provider-stable IDs, independent of release labeling. A genuine live-stream, real-viewer soak of the high-impact provider-event matrix is still in progress; see production-readiness.
• Do not use TikFinity financial or progression events for production statistics or irreversible actions until provider-stable event identity and simulator provenance are verified live.
• Kick reward mutations remain disabled because Streamer.bot does not document them.
• This is an unsigned portable ZIP. Verify both its adjacent SHA-256 file and GitHub artifact attestation before installation.

Acceptance evidence

• 62 test files / 429 tests pass with clean lint, typecheck, build, and configuration validation, plus 6 Playwright browser tests.
• The public CMD installer and uninstaller are exercised through Windows acceptance, including visible completion, self-removal, and creator-data preservation.
• The release workflow rebuilds from the exact tag and publishes a SHA-256 checksum, CycloneDX SBOM, and provenance attestations.

Windows 11 Smart App Control note

Machines with Smart App Control enabled block the unsigned Install THSV StreamBridge.cmd with "dangerous file extension" and no "Run anyway" option. Either unblock the downloaded ZIP before extracting (Properties → Unblock, after verifying it per RELEASE-VERIFICATION.md), or run .\runtime\node.exe .\installer\install.mjs from the extracted folder — the .cmd is only a display wrapper around that command, and the bundled node.exe is signed. See Troubleshooting.

Meld Studio note

Meld Studio is distributed as an MSIX/UWP app, which Windows sandboxes with loopback isolation by default. This blocks the Chat, Alerts, and combined overlay URLs, and the setup wizard if opened from inside Meld's own browser layer, until a one-time exemption is granted. See Troubleshooting for the fix. This is a Windows app-sandboxing restriction, not a StreamBridge defect, and can affect other MSIX-packaged broadcasting apps the same way.

Install

Download THSV-StreamBridge-2.0.0.zip and its .sha256 file from this release, verify them using RELEASE-VERIFICATION.md, extract the archive, and run Install THSV StreamBridge.cmd.

Normal upgrades preserve creator configuration, secrets, uploads, logs, backups, add-on packages, and add-on state. Default uninstall also preserves creator-owned data.

v2.0.0-rc.4: Deep-link the Slothbloom credit to the StreamBridge project page

THSV StreamBridge 2.0.0-rc.4

THSV StreamBridge 2.0.0-rc.4 is the current public Windows release candidate for the revised v2 core and add-on platform. It replaces rc.3 for creator acceptance testing before stable 2.0.0.

New since rc.3

• Alert cards can use an animated GIF or a short uploaded background video (MP4/WebM, up to 5 MB) with the video's own embedded audio replacing the alert's separate sound setting. Uploads are validated by real file signature, and an image and a video cannot be set on the same card at once. Fixing this surfaced and corrected a pre-existing bug: neither the overlay page's nor the wizard's Content-Security-Policy had a media-src directive, which silently blocked all audio and video playback on both pages.
• Alert layout and media placement presets: each alert card now has an independent text layout (Classic, Stacked, or Centered) and media placement (Behind — full-bleed dimmed; Below — an undimmed banner strip; Inset — a small undimmed box in the avatar's spot), combinable freely per alert type.
• A live preview card inside the Alerts editor shows the templates, card color, font, layout, and background media on every keystroke, separate from "Fire test alert" which still sends the real design to a connected overlay.
• The Rewards panel remembers the platform and Reward ID from each successful live operation (locally, in the browser) and offers them back as one-click quick-select chips, with inline explanations of which operations need a Redemption ID.
• A wizard-wide visual pass: a real button hierarchy (primary/ghost/danger), hover and focus transitions, themed scrollbars, rotating chevrons on collapsible sections, and consistent spacing across every panel.
• Long descriptive paragraphs collapse to two lines with a "Show more" toggle, and the Platforms panel's repeated per-card toggle explanations moved to hover tooltips, so panels fit far more on screen.
• A slothbloom.com project link in the wizard header and README. StreamBridge remains entirely local, with no accounts and no hosted component.

Included

• A self-contained Windows x64 archive with pinned Node.js runtime and no global Node.js, npm, Docker, database, or administrator requirement.
• A state-preserving installer, replacement-start handling, upgrade rollback, conservative uninstall, and authenticated local setup wizard.
• Unified Twitch, YouTube, Kick, and TikFinity relay intake through one Streamer.bot WebSocket connection.
• Configurable Chat and Alerts browser sources, commands, timed actions, rewards, diagnostics, backups, and approval-gated add-ons.
• Durable at-least-once Streamer.bot delivery with restart replay, bounded retry, ordered lanes, and dead letters.
• SHA-256 archive checksum, CycloneDX SBOM, and GitHub artifact attestations from the release workflow.

RC safety boundaries

• Do not use TikFinity financial or progression events for production statistics or irreversible actions until provider-stable event identity and simulator provenance are verified live.
• Kick reward mutations remain disabled because Streamer.bot does not document them.
• High-impact events without a provider-stable source ID are rejected instead of being assigned a synthetic replay-unsafe identity.
• This is an unsigned portable ZIP. Verify both its adjacent SHA-256 file and GitHub artifact attestation before installation.

Acceptance evidence

• 62 test files / 429 tests pass with clean lint, typecheck, build, and configuration validation, plus 6 Playwright browser tests.
• New schema, projection, and wizard-HTTP coverage for the media upload endpoint and the layout/media-placement fields, with all layout-and-placement combinations live-verified in a real browser against a running bridge.
• The release workflow rebuilds from the exact tag and publishes a SHA-256 checksum, CycloneDX SBOM, and provenance attestations.

Meld Studio note

Meld Studio is distributed as an MSIX/UWP app, which Windows sandboxes with loopback isolation by default. This blocks the Chat, Alerts, and combined overlay URLs, and the setup wizard if opened from inside Meld's own browser layer, until a one-time exemption is granted. See Troubleshooting for the fix. This is a Windows app-sandboxing restriction, not a StreamBridge defect, and can affect other MSIX-packaged broadcasting apps the same way.

Install

Download THSV-StreamBridge-2.0.0-rc.4.zip and its .sha256 file from this release, verify them using RELEASE-VERIFICATION.md, extract the archive, and run Install THSV StreamBridge.cmd. (Starting with this release the archive name drops the -windows-x64 suffix; Windows x64 remains the only supported target.)

Normal upgrades preserve creator configuration, secrets, uploads, logs, backups, add-on packages, and add-on state. Default uninstall also preserves creator-owned data.

v2.0.0-rc.3

THSV StreamBridge 2.0.0-rc.3

THSV StreamBridge 2.0.0-rc.3 is the current public Windows release candidate for the revised v2 core and add-on platform. It replaces rc.2 for creator acceptance testing before stable 2.0.0.

Corrections since rc.2

• The installer clearly explains its local verification and privacy behavior, reports success or failure, and waits for the creator before closing.
• The uninstaller clearly explains what is removed and preserved, reports success or failure, waits for the creator before closing, and then safely removes its own wrapper; a Windows short-vs-long path mismatch that could make a valid installation look unmanaged is fixed.
• Native Streamer.bot platform intake (Twitch/YouTube/Kick) bug fixes corrected against real Streamer.bot Action History argument dumps: hardcoded item-name fallbacks, missing reward-redemption and YouTube membership-gift source IDs, YouTube monetary-amount parsing, and Kick's "Kicks Gifted" trigger-name mismatch.
• The Windows Bridge Launcher's Streamer.bot actions now wait for the launcher's own result instead of reporting success as soon as a process handle existed, and uploaded overlay assets are anchored to the persistent data root instead of the disposable per-version app folder.
• The setup wizard's Alerts, Command Sync, Timed Actions, Advanced Blockers, and Platforms panels were rebuilt around a consistent list-plus-editor layout with plain-language explanations for every toggle, replacing always-visible forms stacked above flat card lists.

Included

• A self-contained Windows x64 archive with pinned Node.js runtime and no global Node.js, npm, Docker, database, or administrator requirement.
• A state-preserving installer, replacement-start handling, upgrade rollback, conservative uninstall, and authenticated local setup wizard.
• Unified Twitch, YouTube, Kick, and TikFinity relay intake through one Streamer.bot WebSocket connection.
• Configurable Chat and Alerts browser sources, commands, timed actions, rewards, diagnostics, backups, and approval-gated add-ons.
• Durable at-least-once Streamer.bot delivery with restart replay, bounded retry, ordered lanes, and dead letters.
• SHA-256 archive checksum, CycloneDX SBOM, and GitHub artifact attestations from the release workflow.

RC safety boundaries

• Do not use TikFinity financial or progression events for production statistics or irreversible actions until provider-stable event identity and simulator provenance are verified live.
• Kick reward mutations remain disabled because Streamer.bot does not document them.
• High-impact events without a provider-stable source ID are rejected instead of being assigned a synthetic replay-unsafe identity.
• This is an unsigned portable ZIP. Verify both its adjacent SHA-256 file and GitHub artifact attestation before installation.

Acceptance evidence

• 62 test files / 424 tests pass with clean lint, typecheck, build, configuration validation, and zero production dependency audit findings.
• The public CMD installer and uninstaller are exercised through Windows acceptance, including visible completion, self-removal, and creator-data preservation.
• The release workflow rebuilds from the exact tag and publishes a SHA-256 checksum, CycloneDX SBOM, and provenance attestations.
• The published archive and checksum were verified with a real anonymous download from this release; the archive contents were confirmed against the exact tagged commit.

Meld Studio note

Meld Studio is distributed as an MSIX/UWP app, which Windows sandboxes with loopback isolation by default. This blocks the Chat, Alerts, and combined overlay URLs, and the setup wizard if opened from inside Meld's own browser layer, until a one-time exemption is granted. See Troubleshooting for the fix. This is a Windows app-sandboxing restriction, not a StreamBridge defect, and can affect other MSIX-packaged broadcasting apps the same way.

Install

Download THSV-StreamBridge-2.0.0-rc.3-windows-x64.zip and its .sha256 file from this release, verify them using RELEASE-VERIFICATION.md, extract the archive, and run Install THSV StreamBridge.cmd.

Normal upgrades preserve creator configuration, secrets, uploads, logs, backups, add-on packages, and add-on state. Default uninstall also preserves creator-owned data.

v2.0.0-rc.1

THSV StreamBridge 2.0.0-rc.1

THSV StreamBridge 2.0.0-rc.1 is the public Windows release candidate for the revised v2 core and add-on platform. It is intended for creator acceptance testing before the stable 2.0.0 release.

Included

• A self-contained Windows x64 archive with pinned Node.js runtime and no global Node.js, npm, Docker, database, or administrator requirement.
• A state-preserving installer, replacement-start handling, upgrade rollback, conservative uninstall, and authenticated local setup wizard.
• Unified Twitch, YouTube, Kick, and TikFinity relay intake through one Streamer.bot WebSocket connection.
• Configurable Chat and Alerts browser sources, commands, timed actions, rewards, diagnostics, backups, and approval-gated add-ons.
• Durable at-least-once Streamer.bot delivery with restart replay, bounded retry, ordered lanes, and dead letters.
• SHA-256 archive checksum, CycloneDX SBOM, and GitHub artifact attestations from the release workflow.

RC safety boundaries

• Do not use TikFinity financial or progression events for production statistics or irreversible actions until provider-stable event identity and simulator provenance are verified live.
• Kick reward mutations remain disabled because Streamer.bot does not document them.
• High-impact events without a provider-stable source ID are rejected instead of being assigned a synthetic replay-unsafe identity.
• This is an unsigned portable ZIP. Verify both its adjacent SHA-256 file and GitHub artifact attestation before installation.

Acceptance evidence

Validated on Windows on July 19, 2026 from the RC source:

• 62 test files / 406 tests passed with clean lint, typecheck, build, configuration validation, and zero production dependency audit findings.
• All 6 Playwright checks passed for wizard add-ons, command/timed-message configuration, platform-specific events and colors, safe import/export, 1920 x 1080 chat, cropped chat, alert storms, and reconnects.
• Windows replacement-start, custom-port shutdown, stale-build detection, and active-configuration shutdown passed.
• The exact locally built archive passed SHA-256 verification, extraction, bundled-runtime installation without global Node.js, BOM-saved configuration startup, health, shutdown, same-version repair, creator-data preservation, and public CMD uninstall.
• The tag workflow independently rebuilds the archive from the tagged commit and publishes its checksum, SBOM, and provenance attestations. Verify those published assets before installing.

Install

Download THSV-StreamBridge-2.0.0-rc.1-windows-x64.zip and its .sha256 file from the official release, verify them using RELEASE-VERIFICATION.md, extract the archive, and run Install THSV StreamBridge.cmd.

Normal upgrades preserve creator configuration, secrets, uploads, logs, backups, add-on packages, and add-on state. Default uninstall also preserves creator-owned data.

THSV StreamBridge v1.0.1

THSV StreamBridge 1.0.1

THSV StreamBridge 1.0.1 is a release-review hardening patch for the public Windows installer and redistribution documentation.

Changes

• Refuses silent downgrades from a newer installed SemVer to an older release.
• Adds the explicit -AllowDowngrade recovery switch with a warning that it does not migrate state backward.
• Documents Bloom's OpenAI image-generation provenance and licenses the owner's licensable rights in the edited assets under MIT.
• Documents non-uniqueness, copyrightability, third-party-claim, and trademark limitations without overstating AI-output rights.
• Adds direct production dependency notices for ws 8.21.1 and zod 4.4.3, both MIT-licensed.
• Adds a consolidated runtime, application, platform, and optional-module compatibility matrix.
• Surfaces Facebook's unsupported status and relay limitations in first-run and troubleshooting documentation.

Download both release assets, verify the adjacent SHA-256 file, extract, and run scripts\install-release.ps1. Existing v1.0.0 installations upgrade in place with creator data preserved.

THSV StreamBridge 1.0.0

THSV StreamBridge 1.0.0

THSV StreamBridge 1.0.0 is the first stable, open-source release of the local-first cross-platform livestream automation framework.

Included

• Normalized Twitch, YouTube, Kick, and TikTok/TikFinity relay intake through Streamer.bot packages
• Multi-Chat, Multi-Commands, Multi-Alerts, Speaker.bot orchestration, and stream-relative timed actions
• Independent shared-connection browser sources for Chat, Alerts, and Bloom Companion in Meld Studio, OBS Studio, and compatible Streamlabs Desktop Browser Sources
• Unified viewer identity and progression with authenticated local administration
• Bloom Companion interactions, persistent Sleep/Wake state, and fixed eight-frame animations
• Checksummed Windows archive, staged installer, state-preserving upgrades, safe uninstaller, and production-safe simulation helper

Install

Download both THSV-StreamBridge-1.0.0.zip and THSV-StreamBridge-1.0.0.zip.sha256. Verify the archive hash, extract it, and run scripts\install-release.ps1. See docs\release.md inside the archive for prerequisites, upgrades, uninstall behavior, and the full acceptance boundary.

Important boundaries

• Streamer.bot 1.0.5-alpha.31 is the currently verified automation host.
• Twitch, YouTube, and Kick use the included Streamer.bot native relay package; this release does not claim direct platform API transports.
• TikTok/TikFinity provenance remains conservative and defaults unverified activity to simulated until live identity behavior is verified.
• Facebook is not supported.
• Viewer progression is disabled by default and should be enabled only with an appropriate creator disclosure and identity policy.
• Raw event text is denied for speech by default.

Licensed under the MIT License.