All systems OKView Status
// STREAMION.BOT DOCS

All about streamion.bot.

Sign-in flow, chat commands, event responses, alerts, music integrations — the full reference for your bot configuration.

Coworking

Coworking turns your stream into a focused work session: a timer / Pomodoro overlay, a to-do list you keep on screen, and a chat to-do list your viewers fill themselves. All three are browser sources you add in OBS, and all three can be driven from chat.

Coworking is a streamion.bot Pro feature. The overlays only render while Pro is active for your channel.

You'll find it under Overlays & Alerts → Coworking (/coworking/configure), with one tab per overlay: Timer, To-Do, and Chat To-Do.

Timer & Pomodoro

The timer overlay shows a big countdown with an optional label above it, in two modes:

  • Plain countdown — a one-off timer, optionally named (e.g. a 25-minute "Deep Work" block).
  • Pomodoro — Focus → Break → … → Long break, looping until you stop it. A row of dots under the countdown shows which round you're in.

Breaks switch the label and dots to a calm green, a paused timer dims, and a finished timer pulses.

Settings (Timer tab)

SectionWhat you set
ControlsShow overlay, plus Start timer / Start Pomodoro / Stop
AppearanceText and accent colour, font (system, Google, or your own upload), weight, font size
TextsThe label per phase — Timer, Focus, Break, Long break, Done — or switch labels off to show just the time
PomodoroWork (default 25 min), Break (5), Long break (15), Rounds before a long break (4), plus the Default timer length (25 min) used by the Start button and !timer start
SoundsA focus sound (start of a work block) and a break sound (start of a break, and when a plain timer runs out) — upload an MP3/OGG or pick one from your Media library

Chat commands

CommandWhoWhat it does
!timer 25ModeratorStarts a 25-minute countdown. Name it: !timer 25 Deep Work
!timer startModeratorStarts a timer with your default length
!timer pause / !timer resumeModeratorPauses / resumes
!timer +5 / !timer -5ModeratorAdds or removes minutes on the fly
!timer stopModeratorStops and hides the timer
!pomodoroModeratorStarts a Pomodoro cycle with your configured cadence. Override it for one run: !pomodoro 50 10
!pomodoro stopModeratorStops the cycle

!countdown and !pomo work as aliases. A timer you started keeps running until it finishes or you stop it — a bot restart clears a running timer, but your settings stay.

To-Do list

Your own session goals, live on stream. Add items in the dashboard or from chat; completed items stay visible with a strike-through, so chat can see what you got done. Each item carries a number — that's what you use in chat.

  • Up to 25 items, 200 characters each.
  • Manage them on the To-Do tab, or with !todo.
CommandWhoWhat it does
!todo add <text>ModeratorAdds an item
!todo done <n> / !todo undone <n>ModeratorChecks an item off / reopens it
!todo remove <n>ModeratorRemoves an item
!todo listModeratorPosts the list in chat (bare !todo does the same)
!todo clearModeratorClears the whole list

Removing an item renumbers the rest, so the numbers always match what's on screen.

Chat To-Do list

The same idea, but your viewers fill it — a shared board where everyone posts what they're working on. Each row shows the viewer's name, their own item number, and the task.

  • Only the viewer who added an item can complete or remove it. Moderators can clear the whole board.
  • Each viewer may have a limited number of open tasks at once (default 3, adjustable 1–20) — completed tasks don't count toward it.
  • Up to 100 tasks on the board, 200 characters each.
CommandWhoWhat it does
!task add <text>EveryoneAdds your own task
!task done <n> / !task undone <n>EveryoneChecks off / reopens your task
!task remove <n>EveryoneRemoves your task
!task listEveryoneShows your tasks (bare !task does the same)
!task clearModeratorClears the whole board

!tasks and !todos work as aliases.

Adding the overlays in OBS

Each tab shows its own Browser source URL with a copy button. For each overlay you want, add a Browser source in OBS and paste its URL:

OverlaySuggested size
Timerabout 400 × 220 — the countdown centres itself in the source
To-Do / Chat To-Doabout 400 × 600 — long entries wrap, and the list scrolls if there are more items than fit

The pages are transparent, so no chroma key is needed — just drag the source where you want it. An overlay that's switched off (or whose list is empty) shows nothing at all.

All coworking overlays use the same overlay token as your alert overlays and Buddies. Regenerating that token invalidates every overlay URL, so if you do, re-paste all of them in OBS. Keep the URLs private.

Custom fonts

On any coworking tab you can choose Custom font and upload your own — OTF, TTF, WOFF, or WOFF2, up to 2 MB. Uploaded fonts land in your Media library and can be reused across the coworking overlays. Otherwise pick a Google font or leave it on the system default.