A self-hosted YouTube Live assistant: viewers earn points for chatting and spend them on alerts that pop up in OBS.
DyskStream reads the live chat of any public YouTube stream, with no login, API key, or quota: paste the video URL
and it starts. Every comment earns points, and !alert <message> spends them on a Saweria-style alert in OBS.
Replies to chat commands and moderation are left to Nightbot.
The interface is in Indonesian (the dashboard also has English). DyskStream was called Streaming Assistant before it joined DyskLab.
| Alert in OBS | Viewer avatars in OBS |
|---|---|
![]() |
|
| Alert templates | Overlay URLs |
![]() |
![]() |
| Giveaway and trivia | |
![]() |
The Electron app runs the server and the dashboard in one window, with a tray icon. Build it yourself:
git clone https://github.com/DyskLab/dyskstream.git
cd dyskstream/desktop
npm install
npm run dist:mac # or: npm run dist:winThe installer lands in desktop/release/. Data is kept in the app's data folder (an install from before the rename
keeps using its old Streaming Assistant folder).
In production everything runs on one port (4300): the built dashboard, the overlays, and the API.
Docker:
echo "ADMIN_PASSWORD=your-password" > .env
docker compose up -d --buildPM2:
npm i -g pm2
cd dashboard && npm ci && npm run build
cd ../server && npm ci
cp .env.example .env # then set ADMIN_PASSWORD
cd .. && pm2 start ecosystem.config.cjs
pm2 save && pm2 startupOpen http://SERVER:4300. Data (SQLite and uploads) is in ./data with Docker or server/ with PM2.
Requires: Node.js 25 or later (for the built-in node:sqlite).
- Live chat reader for any public channel, through masterchat.
- Points: +1 per comment with a cooldown, bonus commands, and a leaderboard.
!alert <message>: spends points and shows an alert in OBS with your own image, sound, or TTS, queued one at a time so they never pile up.- OBS overlays: alerts, live chat, leaderboard, event ticker, request queue, running text, a goal bar, and viewer avatars (blob and blocky characters).
- Full-screen scenes: starting soon, be right back, and stream ended.
- Dashboard: monitor, leaderboard, rules, a template editor with Test Alert, and a soundboard with hotkeys.
- Open on your phone: sign in to the dashboard from your phone by scanning a QR code.
- Nightbot:
!pointand!rankthrough$(urlfetch). - Public leaderboard page you can share with viewers.
- Monitor: paste the live video URL or ID and press Mulai.
- Points start adding up; check Leaderboard.
- Alert: set up the template and press Kirim Test.
- Aturan: change the
!alertcost, cooldown, banned words, and the rest, then Simpan.
Add each overlay as a Browser source at your canvas size (for example 1920×1080). Its background is transparent. Turn off Shutdown source when not visible so the WebSocket stays connected.
| Overlay | URL |
|---|---|
| Alert | http://localhost:4300/overlay/ |
| Live chat | http://localhost:4300/overlay/chat.html |
| Leaderboard | http://localhost:4300/overlay/leaderboard.html?limit=5&pos=top-right |
| Ticker | http://localhost:4300/overlay/ticker.html |
| Request queue | http://localhost:4300/overlay/requests.html |
| Goal bar | http://localhost:4300/overlay/goal.html |
| Viewer avatars | http://localhost:4300/overlay/avatars.html |
| Scenes | scene-start.html, scene-brb.html, scene-end.html in /overlay/ |
The public leaderboard is at http://localhost:4300/leaderboard/ (add ?overlay for a transparent version).
DyskStream never posts to chat, so commands that need a reply go through Nightbot:
- Make the server public, for example
cloudflared tunnel --url http://localhost:4300. - In Nightbot, add
!point→$(urlfetch https://<your-url>/nb/points?u=$(user))and!rank→$(urlfetch https://<your-url>/nb/rank?u=$(user)).
Reply formats are set in Aturan (nightbot.pointsReply and others).
The dashboard is protected by ADMIN_PASSWORD (default admin, so change it). Every /api/* endpoint needs a
session. Overlays, /nb/*, /uploads/*, the WebSocket, and /health stay public because OBS and Nightbot need them.
Sessions survive restarts and expire after 30 days.
cd server && npm install && npm run dev # http://localhost:4300
cd dashboard && npm install && npm run dev # http://localhost:4301
cd desktop && npm install && npm start # desktop appserver/ Fastify, masterchat, SQLite, uploads
dashboard/ control panel (React, Vite, Tailwind)
overlay/ OBS browser sources
public/ viewer leaderboard
desktop/ Electron app
shared/ types shared by the server and clients
docs/ technical plan (in Indonesian)
masterchat is unofficial and can break when YouTube changes its internals. The reader sits behind a
ChatReaderinterface so it can be swapped for the official YouTube Data API.
If DyskStream helps you, you can buy me a coffee.
DyskStream is part of DyskLab, alongside DyskFlow, DyskFocus, DyskFiles, DyskPOS, and DyskLink for Mac, Android, and Windows and Linux.




