Pomodoro Pro Timer++ for OBS
Elevate your streaming and productivity sessions with a Customizable Pomodoro Timer, exclusively designed for OBS Studio.
This powerful and adaptable script brings the renowned Pomodoro Technique directly into your streams or recordings helping you break work into focused intervals, followed by short breaks, to maximize focus and keep your audience engaged.
Features
- Customizable Durations – Set your own focus, short break, and long break lengths (minutes).
- Live Session Counter – Track how many focus sessions you’ve completed in real time.
- Custom Messages – Personalize the labels for focus, short breaks, and long breaks.
- Start / Pause / Resume / Reset / Skip – Fully controllable via buttons and OBS hotkeys.
- Auto-start by Scene – Optional: start automatically when you switch to a specific scene.
- "End at" Display – Show the exact end time (with customizable separator and text), or hide it entirely.
- Status Source – Optional separate text source for showing the current mode (“Focus”, “Break”, etc.).
- Customizable Colors – Set different text colors for focus, short break, and long break.
- Seamless OBS Integration – Works with Text (GDI+) on Windows and FreeType 2 on macOS/Linux.
Important – Exact Source Names
To work out of the box, you must create two text sources in OBS with these exact names:
- Pomodoro → displays the main timer (and optional "End at").
- Pomodoro Status → displays the current mode/status (optional; can be left blank in settings).
Installation
- Download the Script: Save the .lua file to your computer.
- Open OBS: Go to Tools → Scripts.
- Add the Script: Click +, select the .lua file.
- Configure: Adjust durations, messages, colors, and feature toggles in the script’s settings.
Usage
- Start / Stop / Pause / Resume / Skip from the script window or via configured hotkeys.
- Toggle “Show End at” on/off, change the separator (default: •), or edit the "End at" label text.
- Optional auto-start when switching to a scene (select scene in settings).
- Customize your text source formatting (font, size, style) directly in OBS.
Pro Tips
- Test your configuration in a non-live scene before going public.
- For custom requests, extra features, or help, DM me on Instagram – I always reply:
instagram.com/animalshadow
