Your chat, overlays, alerts and supporter tools—running on your own computer.
TDSBLive is a local-first companion for Streamer.bot, Speaker.bot and OBS Studio. Bring incoming events together, create graphics for your stream, track supporters and configure speech, sounds and actions from a browser-based editor.
Download TDSBLive · Read the user guide · Get help
v1.0.1 is the cumulative release, including the editor redesign and desktop tray controls. There is no separate public v1.0.0 download. Use the application files under Assets on the release page.
Official releases provide self-contained Windows x64 builds. You do not need to install .NET separately or build the source code to use them.
| Download | Best for |
|---|---|
Windows installer — TDSBLive-<version>-win-x64-setup.exe |
A guided, per-user installation with an application shortcut. |
Application ZIP — TDSBLive-<version>-win-x64.zip |
Managing the application folder yourself. Extract the entire ZIP, then run TDSBLive.exe. |
Linux launcher bundle — TDSBLive-1.0.1-linux-x64-wine.tar.gz |
A native Linux tray and setup window with the Windows backend. Install Wine or UMU/Proton, extract everything, then open TDSBLive. |
SHA256SUMS.txt |
Checking that your downloaded files match the release's published checksums. |
Get these files from the latest release. The Source code archives are for developers, rather than ordinary installation. Each application download includes an offline user guide and the supplied Streamer.bot import. Start-at-login is optional and off by default.
See Windows installation for full instructions.
For Linux compatibility setups, see the Wine/Bottles guide
or Proton/UMU guide. These use the
Windows backend. The v1.0.1 Linux download bundles it with a native Linux
launcher, tray and setup window in TDSBLive-1.0.1-linux-x64-wine.tar.gz.
It supports installed Wine or UMU/Proton and keeps your chosen settings folder.
A fully native Linux backend remains deferred.
- Install or extract the application and start TDSBLive.
- Wait for the editor to open in your normal browser. To return later, choose Open editor from the blue T tray icon.
- Follow guided setup and connect only the services you use. Streamer.bot handles its supported platform connections and actions; Speaker.bot is optional for speech.
- Configure combined chat or an overlay, then test it with sample events.
- Copy its viewing URL into an OBS Browser Source. Use the streamer chat page as a browser dock if you want a separate chat view for yourself.
Keep TDSBLive running while using its pages in OBS. Closing the editor tab does not quit the application. Local HTTP works without HTTPS certificates.
Start with First setup, then Chat and OBS or Overlays and alerts.
v1.0.1 adds a blue T icon near the Windows clock or in the Linux desktop panel. Starting it normally opens the editor in your usual browser. Optional start-at-login stays quiet; use Open editor when you need it.
- Find the blue T near the clock. Click the hidden-icons arrow if it is tucked away.
- Right-click it and choose Open editor, Restart, or Quit.
- When you finish streaming, save changes in the editor, choose Quit, then confirm Quit. Your OBS overlays stop until you start TDSBLive again.
Restart and Quit first show a confirmation with Cancel selected. Closing the browser or the TDSBLive is running control window keeps the app running. If the icon is unavailable, that control window provides the same actions. Tray actions do not save unfinished forms.
For screenshots and missing-icon help, read Tray and desktop controls. Older v0.1.0 downloads use the editor's application controls; follow their bundled guide if you keep an older version.
On Linux, extract the complete Linux archive and open TDSBLive. Its first-run window lets you choose Wine or Proton (UMU), your existing Windows settings folder and your saved setup. Leave Start a new empty TDSBLive setup unchecked when updating. The optional applications-menu shortcut does not enable automatic sign-in startup. See the Wine guide or UMU guide for each field.
- Bring chat together: display combined chat in OBS and use a separate streamer view, with platform indicators, supported badges and emotes.
- Create overlays and alerts: arrange text, images, chat and supporter widgets; customize alert wording, media, timing and playback queues.
- Choose different alert designs: named triggers, donation/quantity conditions and ordered first/all matching alert sets.
- Customize and share designs: advanced arrangement, sandboxed custom widgets and portable overlay/widget packages.
- Connect Rumble events: use the Rumble live API with persistent repeat-event protection and connection diagnostics.
- Understand your support: review contributions, linked supporter identities, leaderboards and stream totals, with reported, estimated and unknown values distinguished.
- Automate your responses: configure speech, overlay sounds and selected Streamer.bot actions, with simulations and execution history.
- Protect your setup: recover overlay revisions, export configuration and create or restore application backups.
Release notes and the bundled guide describe the version you downloaded. The repository can later contain newer work. See version guidance if a control is missing from an older build.
Linux memory/CPU overhead and KDE panel recovery have accepted limitations. Read known issues and test your setup before a show. This is the last planned feature release for a while; bug/security fixes and a future fully native Linux backend remain possible.
The GitHub wiki and
repository user guide provide illustrated instructions
for setup, chat, overlays, automation, supporter totals and recovery.
For offline reading, open guide/Home.html in your installed or extracted
application folder; keep the guide's images beside its pages.
Before updating, save your editor changes, make an application backup and quit
TDSBLive. Wait for it to stop before replacing application files. Run the new
installer, or extract the new ZIP into a separate folder. Check your connections
and OBS sources before your next broadcast. Your application data normally lives
under %LOCALAPPDATA%\TDSBLive on Windows, separately from the program files.
Start with Troubleshooting. If you need to report a problem, include your TDSBLive version, operating system, installation method, what you expected and the steps that reproduce the issue.
Keep credentials, private Rumble API URLs, access tokens and backups out of public issues and screenshots. Optional authenticated LAN access is disabled by default; follow the LAN guide before enabling it. HTTP does not encrypt network traffic.
Contributions are welcome. See Contributing, Development, Architecture and Testing. Technical requirements and acceptance evidence are maintained in the implementation plan and requirements matrix.
Build and test from source
Use the exact SDK in global.json, Node in .nvmrc, npm in package.json, and
Python 3.14.7. The SonarQube CLI 1.9.0 is required by evidence tooling's mandatory
secrets-on-read safeguards. Windows CI installs its pinned binary automatically.
Scan files before reading them, as specified in AGENTS.md. Then:
dotnet restore TDSBLive.slnx --locked-mode
npm ci
npm run build
dotnet build TDSBLive.slnx --configuration Release --no-restore
dotnet test TDSBLive.slnx --configuration Release --no-build --settings coverage.runsettings --collect:"XPlat Code Coverage" --logger trx --results-directory TestResults
npm run lint
npm run typecheck
npm run test:coverage
python tools/rumble_evidence.py verify
python -m unittest discover -s tests/replay -v
python tools/verify_coverage.pyRun the host with dotnet run --project src/ExtensionSuite.Host and open
http://127.0.0.1:17474/editor. Build frontend assets before the host so they are
copied to its output. Use npm run dev --workspace @tdsblive/editor for frontend
development. See the foundation API guide for bootstrap
configuration, DPAPI credentials, authenticated LAN and generated contracts, and
the security guide for permission and isolation boundaries.
TDSBLive is free and open source under the MIT License.