streamtoolset
DocsChecking session…

Overlays · alpha

A per-viewer task list overlay driven entirely from chat. Each chatter who types !task gets their own column on screen. !done crosses tasks off, !focus highlights the current one. Coworking, body-doubling, and challenge-stream friendly.

Status

Scaffolded. The catalog tile, the docs page (this page), and the settings stub at /tools/task-list are live, but the overlay surface, chat handler, and the per-stream Durable Object backing the list are not built yet. Ships after Phase 1 of the multi-platform chat plan lands — Task List will be one of the first tools to support Twitch + Kick + YouTube Live out of the gate rather than getting retrofitted later.

Planned chat commands

Mirrors the upstream convention so people coming from other task-list overlays don't have to relearn:

  • !task <text> / !add <text> — append a new task to your column.
  • !done [n] — cross off task #n. Defaults to the focused task.
  • !focus <n> — highlight task #n as the one you're working on.
  • !edit <n> <text> — replace task #n's text in place.
  • !delete <n> — remove task #n.
  • !check — whisper your full list back to you in chat.
  • Mod commands: !clearlist, !cleardone, !clearuser @name.

Use cases

  • Coworking / study-with-me streams. Every viewer has their own task tracker on screen. Less "look at chat for the todo," more "see your progress in the overlay."
  • Body-doubling streams. Chat-driven accountability is the point. Adding a task is a low-friction commitment that persists on screen.
  • Speedrun / challenge streams. Viewers track their parallel runs alongside the broadcaster — splits, restart counts, specific bosses.
  • Long-form gaming sessions. "Beat boss → loot chest → save → break" as a public to-do every viewer can mirror.

What it borrows, what it doesn't

The command surface and the per-user-column UX take direct inspiration from jujoco/twitch-multitask-task-list-overlay. The implementation is built from scratch on the toolset's infrastructure: shared OAuth at auth.deutschmark.online, Durable-Object-backed state that survives overlay reloads, hot-swap config from the dashboard, and the planned multi-platform ChatBackend interface so the same tool works on Twitch, Kick, and YouTube Live with no per-platform forks.

See how to add a browser source in OBS for the OBS setup once the overlay surface ships.