Pomodoro To-Do List Overlay for Twitch Co-Working Streams
Last updated: November 2026 · 9 min read
A co-working stream works because everyone in chat is working alongside you. A countdown alone cannot show that. "18:32" in the corner does not say what you are doing, and it says nothing about what anyone else is doing.
A Pomodoro to-do list overlay closes that gap. Your current task sits under the timer, free on every plan. With Focusdoro Pro, viewers add their own task from chat with !task add, and the list shows on your overlay. No second window, no manual text-source updates, no reading tasks out loud.
This is the actual overlay, running right now. In OBS it is a Browser Source pointed at your personal URL, so it updates on stream as you start, pause and finish sessions.
All five themes are free.
Why a Countdown Alone Is Not Enough
Most stream overlays, and most Pomodoro apps built for solo use, treat the timer as the entire product. That works fine at a desk where you already know what you are doing. It works less well the moment an audience is watching.
- New viewers have zero context. Someone who joins mid-session sees a number counting down and nothing else. They do not know if you are deep in a task or about to take a break.
- You end up narrating the same thing repeatedly. Without a visible task label, "I'm working on X right now" becomes a sentence you repeat every time someone new shows up or asks in chat.
- Session structure gets lost in VODs and clips. A clip of just a countdown means nothing out of context. A clip with "23:00, fixing the login bug" is self-explanatory.
None of this requires a second overlay or a manual text source you have to babysit. It just requires a timer that was built to hold a task label in the first place.
How Task Display Works in Focusdoro
Focusdoro's overlay has a task field built into the same component as the countdown, not bolted on as a separate OBS source you have to keep in sync yourself.
- One field, one place to update it. Type the task once, in the same view where you start the Pomodoro session. It appears on the overlay automatically.
- Updates without resetting the timer. Changing the task mid-block does not interrupt the countdown or reset your streak.
- Survives across sessions. Start a new Pomodoro block and the overlay keeps showing the current task until you change it, so you are not re-typing it every 25 minutes if the task has not changed.
Get your free OBS overlay
Sign up free and drop a live timer into OBS in 60 seconds.
Let viewers add their own tasks (Pro)
Viewer tasks turn the overlay into a shared to-do list. A viewer types a command in your Twitch or YouTube chat, the Focusdoro chat bot saves it, and the task appears next to your timer. Each viewer has one task at a time.
- devon_w: !task add inbox zero
- Focusdoro | @devon_w added: inbox zero
- tom_codes: !task add fixing the login bug
- Focusdoro | @tom_codes added: fixing the login bug
- ana: !task done
- Focusdoro | @ana done: chapter 4 notes
| Who | Command | What it does |
|---|---|---|
| Viewers | !task add <task> | Adds your task. Adding again replaces it. |
| Viewers | !task edit <task> | Changes your task text. |
| Viewers | !task done | Marks your task done. It shows a tick, then fades after 20 seconds. |
| Viewers | !task remove | Removes your task. |
| Mods | !task clear | Clears everyone's tasks. |
| Mods | !task remove @name | Removes one viewer's task. |
A plain !task still replies with the task you are working on, and !focusdoro lists the commands. The rest of the chat bot, including !timer and !vote, is covered in the Twitch Pomodoro timer guide.
Under the timer or in a separate panel
You choose where the list shows. There are two modes besides off.
- Under the timer. One browser source. The list sits below the clock in the same overlay, so there is nothing new to add in OBS.
- Separate panel. A second browser source that shows only the list. Its URL is your overlay URL with
?view=taskson the end, and Focusdoro has a button that copies it. Place and crop it anywhere in the scene. The panel does not play the end-of-phase sound, so that sound plays once, from the timer source.
On a busy co-working scene with two cameras and a music widget, the panel is usually the better fit. The study stream layouts section shows three scene patterns to place it in. The overlay shows the five most recently active tasks, so a long list does not take over the screen.
Turn on viewer tasks
- Upgrade to Pro, then open Chat integration settings. Connect your Twitch account or YouTube channel and switch the bot on. Viewer tasks need the bot.
- In the same settings, or in the Viewer tasks card in Overlay settings, choose Under the timer or Separate panel.
- For the panel, copy the panel URL and add it to OBS as a second browser source. OBS updates within a few seconds of saving.
- Ask chat to try
!task addwith their task. Free accounts can preview the list with sample viewers in Overlay settings before upgrading.
If you stream on YouTube, viewers' own task commands get no reply in chat, and the list on your overlay still updates. Twitch viewers get a short confirmation.
What keeps the list clean
- Short text, no links. A task is cut to 60 characters. A task that contains a link is rejected, not trimmed.
- One task per viewer. A new
!task addreplaces the old one. - Anti-spam lock. A viewer who changes their list three times within 10 seconds is locked out for 60 seconds. On Twitch they get one reply asking them to slow down. Mods and the broadcaster are not locked out.
- Done tasks fade. A finished task shows a tick, then leaves the list after 20 seconds.
- It resets itself. After six hours with no activity the list empties, and mods can type
!task clearat any time.
How to Set Up a Task Display Overlay in OBS
The setup is the same browser-source flow used for any Focusdoro overlay, task field included.
- Sign in at focusdoro.app. Your personal overlay URL is generated automatically, no separate task-display link needed.
- Type your task before starting the session. The task field sits directly next to the start button. Keep it short, see the labeling tips below.
- Add a Browser source in OBS. In the Sources panel, click +, choose Browser, and paste your overlay URL.
- Size it to fit both the timer and the task text. A task label adds a little vertical space compared to a bare countdown. 240x160px is a reasonable starting point, adjust based on your theme and scene layout.
- Update the task whenever it changes, without touching OBS. Everything happens from the Focusdoro tab. OBS never needs to be reopened or the source refreshed.
For scene placement, transparency, and multi-scene setup beyond the task field itself, see the OBS Pomodoro setup guide.
Writing Task Labels Viewers Actually Read
A task label is a glance, not a status report. A few things separate a label that works from one that gets ignored:
- Two to four words, not a sentence. "Refactoring auth middleware" reads instantly. "Working on fixing the bug where the auth middleware fails on token refresh" does not, especially at overlay size.
- Concrete over vague. "PR review" beats "coding stuff." "Chapter 4 problem sets" beats "studying."
- Update it when the task actually changes, not every block. If you are still on the same feature across three Pomodoro cycles, leave the label alone. Constant churn is noise, not information.
- Skip internal jargon on a public stream. "Fixing ticket FD-482" means nothing to a viewer. "Fixing the login bug" does.
For streamers running a coding-focused channel specifically, the Twitch Pomodoro overlay guide covers overlay setup end to end, task field included. For study-with-me channels, the study with me overlay guide covers the same setup from a study-stream angle, where the task field usually carries more of the "what is happening right now" weight than the timer itself.
Also try the Focusdoro desktop widget
The same timer, native on macOS, Windows, and Linux. Free download, no signup required.
Task Display: What Each Option Actually Shows
Here is what a viewer actually sees from the common overlay choices, beyond the countdown.
| Option | Countdown | Task display | Updates without OBS restart |
|---|---|---|---|
| Focusdoro | Yes, 25/5 default, configurable | Yes, built into the same overlay | Yes |
| StreamElements countdown widget | Yes, single countdown | No task field | N/A, no task field to update |
| Streamlabs countdown overlay | Yes, single countdown | No task field | N/A, no task field to update |
| Separate OBS text source, manually typed | Depends on what else you run | Manual, you type and re-type it yourself | No, edit the source properties each time |
A separate manually-typed text source can technically show a task label, but it means opening OBS source properties every time the task changes, which most streamers stop doing after the first week. A task field built into the timer itself is the only option here that survives daily use. For a broader look at overlay options beyond task display specifically, see the best Pomodoro timers for streamers roundup or the Pomodoro timer for OBS overview. Lo-fi and aesthetic streamers should also check the lo-fi Pomodoro overlay guide, which covers keeping the task label visually quiet on an ambience-driven scene.
Try Focusdoro free
Join streamers who use Focusdoro to keep their audience engaged during focus sessions.