Repository navigation
Home
TDSBLive brings stream chat, on-screen graphics and alerts together on your computer. This guide takes you from downloading the app to using it during a stream. You do not need to know programming to use the ordinary features.
Already installed? Start TDSBLive, then open the editor in your web browser. Keep the application running while OBS uses its pages. Closing the browser tab does not quit the application.
This guide describes 1.0.1. Download the application, then choose Windows installer/ZIP or the Linux launcher bundle under Assets. The Linux bundle needs installed Wine or UMU/Proton. Source code is for developers.
Follow these steps in order. You can leave the optional features until your basic setup works.
- Read Before you begin. It explains what each application does and which download contains which features.
- Install for your computer: Windows, Linux with Wine, or Linux with Proton.
- Follow First setup to connect the services you actually use.
- Follow Chat and OBS to see your first working chat page.
- Try Overlays and alerts when you want graphics or notifications on your stream.
- Use Everyday use as your checklist before and after a stream.
Something did not work? Go to Troubleshooting. If a word is unfamiliar, look in the Glossary.
- Install, update or remove TDSBLive.
- Find TDSBLive and use its tray controls in 1.0.1.
- Understand supporter totals and their dates, currencies and estimates.
- Set up speech and sound, then test rules before enabling them.
- Make a backup or restore one.
- Use another computer on your home network, if you need to.
- Use the adaptive workspace and guided alerts in TDSBLive 1.0.1.
- Arrange more complex overlays.
- Use custom widgets and share packages.
- Try the limited local StreamElements compatibility option.
Every application download includes a guide folder. Open guide/Home.html in your browser. Those pages and their pictures work without the internet. Links to downloads and other projects still require an internet connection. Keep the guide folder and its images together. The bundled guide belongs to the build you downloaded; the current wiki may include newer instructions. Use the bundled guide for your installed version; older downloads retain their original documentation.
Screenshots in this guide show owned examples. Names, ports and example settings are illustrations; use the values in your own applications. Some pictures show an earlier interface, so use the accompanying instructions if your screen differs slightly.
The project has native Windows build, automated test and package checks. It also has live Linux/Wine checks, including local OBS rendering and an audible custom-widget test. These checks do not establish that every Linux distribution, Wine runner or Proton runner behaves the same way.
Linux compatibility testing has exceeded the project's CPU targets. The original MVP also exceeded its memory target in its Wine test. Later managed-host Linux qualification met the memory target, but did not meet the CPU targets; that was a separate workload, not a new Wine performance pass. Native Windows streaming-PC performance testing remains deferred. Check the load on your own streaming computer before relying on it for a show.
The Linux tray's memory overhead and KDE panel-only recovery remain accepted issues. Known issues explains the limits and what to do if the icon disappears.
Actual paid Rumble Rant, Ko-fi donation and Twitch Bits delivery has not been verified. Local examples test behavior without requiring you to spend money. VTube Studio work is on hold; use Streamer.bot's built-in integration for that application.
You do not need these technical documents for ordinary use.