Repository navigation
darkbot v0.7.1
What's new
Status colors: green = on, red = off, amber = problem
On/off lights (command, timer, event and clip rows, sound pads), ticked
checkboxes, radio choices and OBS track picks were amber, the same color
the dashboard uses for warnings. Now on is green and off is red, as
everyone reads them; amber is left for problems and as the accent of
buttons, tabs and focus. In the activity feed, played is green, not
played amber, errors red, and channel events green.
Bits: channel.bits.use instead of channel.cheer, new event Power-ups
channel.cheer only reports cheers. channel.bits.use v1 reports every
Bits use: cheers, Twitch's Power-ups (giant emote, message effect,
celebration) and the channel's own Power-ups. darkbot now subscribes to
it instead (both would count cheers twice).
- Cheers stay the "Bits" event with their settings.
- New "Power-ups" event with sound, chat, alert and minimum amount;
{powerup} names it (custom ones by their title). - Power-up Bits count into the dashboard. Same scope bits:read, so no
reconnect is needed. - channel.bits.use has no is_anonymous field.
Twitch API audit against the current docs: fixes
Checked every Twitch API darkbot uses against dev.twitch.tv and its
changelog. Nothing is deprecated and all versions are current. Fixed:
- channel.ad_break.begin: the reference's example sends duration_seconds
as a string; accept both forms instead of dropping the event. - stream.online: only type "live" counts (not rerun, premiere, playlist,
watch party), matching Get Streams type=live. - Redemptions revoked as version_removed or refused as deprecated no
longer cause an endless reconnect loop; darkbot logs "update darkbot"
and the rest keeps running. - Corrected the subscription cost comment (cost 0 when the broadcaster
authorized the app).
Shared Chat: darkbot writes nothing in chat during a session
With a user access token, Send Chat Message reaches every channel of a
Shared Chat session and Twitch says this cannot be changed. darkbot has
no app token (a desktop app can't keep a client secret), so it stays
silent in chat while the channel is in a session. Sounds, alerts and
clips keep working, and the log names every message that wasn't sent.
Detected with channel.shared_chat.begin/end v1 (no authorization needed)
and Get Shared Chat Session at start. The Chat tab explains it.
"Events" tab is now "Alerts", with category sub-tabs
Events are grouped into Support, Hype & goals, Polls & predictions and
Channel. A category without events has no tab yet. The number on a tab
counts how many alerts are switched on there. Categories are defined in
Go (twitch.Category) and a test makes sure every kind has one.
New alerts: title/category changes, Twitch's channel point rewards
- channel.update v2: alert when the stream title or category changes.
Language-only or label-only updates are dropped by comparing with the
channel read at connect. Placeholders: {title}, {category}. - Automatic channel point rewards v2 (highlighted message, emote
unlocks, ...): alert with {reward} and the price as {amount}. - Hype train status is read at connect, so a train already running
reports its next level-up instead of using it as the baseline.
None of these needs a new scope.
!marker and !snooze, new Twitch permissions
- Twitch login asks for the permissions of everything in this round at
once: channel:manage:ads, moderator:manage:shoutouts,
channel:manage:broadcast, channel:read:goals, channel:read:polls,
channel:read:predictions. - Helix: Get Ad Schedule, Snooze Next Ad, Send a Shoutout, Create Stream
Marker, Get Creator Goals (its "follower" type is normalized to the
events' "follow"). - !marker sets a stream marker (text after it becomes the description)
and answers with the position. !snooze pushes the next ad back 5
minutes. Both are off by default, moderators only unless opened up. - The Chat tab's built-in commands block lists !clips, !marker and
!snooze with one editor; their names can't clash.
Raid shoutouts and an ad warning
- Raid alert option: give the raider Twitch's shoutout automatically.
- New "Ad coming up" alert. Twitch has no event for it, so while live
darkbot reads Get Ad Schedule every 15 s and warns a set time before
the ad (default 60 s). It warns once per ad, and again after a snooze
moves the ad.
Goals, polls and predictions: alerts and OBS overlays
- EventSub channel.goal., channel.poll. and channel.prediction.* v1.
- New alerts: goal started/reached, poll started/ended, prediction
started/locked/resolved, with {title}, {winner} and {amount}. - Two OBS overlays, switched on in their Alerts tab: goal progress bars
(top left) and the running poll or prediction (top right) with its
result. Goals set before darkbot started are read with Get Creator
Goals. "Test" shows a sample on the overlay. - The OBS browser-source code is now shared by all overlays; Now Playing
is unchanged.
README: Alerts tab, new alerts and overlays, !marker/!snooze, Shared Chat
Download
- Windows 10/11:
darkbot-windows-amd64.exe - macOS, Apple Silicon:
darkbot-macos-arm64.app.zip - macOS, Intel:
darkbot-macos-amd64.app.zip - Linux:
darkbot-linux-amd64
Already installed? darkbot updates itself on the next start.
Full changelog: v0.7.0...v0.7.1