Skip to content

darkbot v0.7.1

Choose a tag to compare

@github-actions github-actions released this 19 Nov 05:26
· 9 commits to main since this release

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