OBS Todo - Official Documentation

OBS Todo is a free, browser-based task dashboard designed specifically for streamers. Display a rotating, auto-scrolling to-do list directly on your stream via OBS, Streamlabs, or Twitch Studio.

✨ Key Features
  • No Installation: Runs entirely in the browser.
  • Animated Overlays: Tasks auto-scroll, rotate, or bounce.
  • Productivity Timers: Built-in Pomodoro & task tracking.
  • Gamification: Level-up animations, fire effects, and confetti.
  • Analytics: Track your daily focus time and streaks.

🚀 Quick Start:

1. Adding to OBS / Streamlabs

You can add OBS Todo to your streaming software in less than 30 seconds.

  1. Open OBS Studio (or Streamlabs).
  2. In the Sources dock, click the + icon and select Browser.
  3. Name it "Todo Overlay".
  4. In the URL field, paste this URL:

    https://obs-todo.com/
  5. Set Dimensions (Recommended):
    • Width: 800
    • Height: 800
  6. Add this code to Custom CSS to make background transparent:
    body { background-color: rgba(0, 0, 0, 0); margin: 0px auto; overflow: hidden; overflow-y: auto !important;} body::-webkit-scrollbar { display: none; }
  7. Click OK.

📺 Video Walkthrough

2. How to Control the Todo List from OBS

To interact with the list (add tasks, check them off, or start timers) without leaving OBS:

  1. Right-click the browser source you created (e.g., "Todo Overlay") in OBS.
  2. Select Interact.
  3. A window will pop up allowing you to type and click just like a normal browser.
  4. Inside this window, you can fully manage your session:
    • Add and complete tasks
    • Use individual task timers or the Pomodoro timer
    • Switch between Static and Auto-scroll modes
  5. Better Look: Scroll down in the Interact window and click Minimal Mode for a cleaner display.
  6. Crop the Window: Hold the Alt key while dragging the red edges in OBS to crop out any empty space.

🎬 Demo: Using Minimal Mode

Minimal Mode hides the buttons for a cleaner look, but you can still control everything.

  1. Stay Functional: Even in Minimal Mode, you can still click the checkboxes to finish tasks.
  2. Control Timers: You can still start or stop the Pomodoro and Task Timers by clicking them directly on the screen.
  3. Clean Setup: This allows you to keep the list active on your stream without any distracting settings or menus showing to your viewers.

🎨 Display Modes (The Conveyor Belt)

OBS Todo features unique "Flow Control" modes to make your task list look dynamic on stream.

Mode Description Best For
📄 Static List A standard vertical list. No movement. Focused, serious working sessions.
⚡ Loop Active Active tasks continuously scroll from bottom to top. Long lists that don't fit in the box.
🔄 Loop All Scrolls both active AND completed tasks. Showing off how much you've done today.
↕️ Auto-scroll The list gently bounces up and down. Short lists (1-3 items) to prevent static burn-in.
📌 Pinned + Loop The top task stays fixed; others rotate below it. Keeping the "Current Objective" visible.

⏱️ Timers & Productivity

The Pomodoro Timer

Located at the top of the dashboard, this is perfect for "Study with Me" or co-working streams.

  • 25+5: Sets a 25-minute work timer followed by a 5-minute break.
  • 50+10: Sets a 50-minute work timer followed by a 10-minute break.
  • When a session finishes, the screen will flash green and play a sound to alert you and your chat.

Individual Task Timers

Every task has a Play (▶) button on the right.

  • Click Play to track exactly how long a specific task takes.
  • The total time spent is saved to your history when you complete the task.

🛠️ Managing Tasks
  • Add Task: Type in the "Add a new task..." box and hit Enter.
  • Edit Task: Double-click any task text to rename it.
  • Priority Move: Long-press (click and hold) a task for 1 second to instantly shoot it to the top of the list.
  • Keywords/Tags: Click "Manage Keywords" to assign tags like "Urgent," "Gaming," or "Work." You can see a pie chart of time spent per keyword in the Reporting tab.

🙈 Privacy & Minimal Mode

Minimal View

If you want the overlay to look cleaner on stream:

  1. Scroll down to the Minimal View toggle at the bottom.
  2. Select Minimal.
  3. This hides the header, add-buttons, and settings, leaving only the task list visible.

Hide User Status

Click the Lock Icon (🔒) in the footer to hide your email address/username from the display, preventing accidental leaks on stream.

❓ FAQ

Q: Do I need to create an account?
A: No! You can use Guest Mode. However, Guest data is stored in your browser's LocalStorage. If you clear your cache, you lose your data. Creating an account saves your tasks and stats to the cloud.

Q: Can I load offline tasks?
A: Yes. In the "Completed Tasks" tab, there is a form to "Log Offline Completed Task" where you can manually input work you did off-stream to keep your stats accurate.

Q: The list isn't moving?
A: Ensure you have selected a mode other than "Static" and that you have active tasks in the list. The animation pauses if you hover your mouse over the list (to make it easier to click).

Q: How do I get AI Insights?
A: Go to the Reporting tab and click Generate AI Insights. This analyzes your completed tasks and time data to give you productivity advice.