Pomodoro Pro Timer ++ for OBS
A fully customizable Pomodoro timer for OBS with focus/break cycles, hotkeys, auto-start per scene, sounds, logs, and advanced display options.
Perfect for streamers, productivity sessions, and live coaching.

Features
Reliability

Checks audio file existence before playing.

Non-blocking audio playback (no freezing).

Prevents invalid settings (minimums enforced).

Controls & Comfort

ON/OFF toggle for sounds.

Mappable hotkeys in OBS: Start, Pause, Resume, Reset, Skip.

Auto-start when a specific scene is active.

Session logs & statistics.

Option to hide mode labels for a clean, timer-only display.

Display & Customization

Estimated end time (“End at”) on the same line or below.

Customizable “End at” text and separator.

Per-state colors (Focus / Short Break / Long Break) configurable.

12h / 24h time format.

Custom session label (e.g., “Cycle”, “Pomodoro”, “Set”).

Required Text Sources in OBS
To display the timer and status correctly, you must create two separate Text (GDI+ / FreeType 2) sources in OBS:

Main Timer Source

Name it exactly: Pomodoro

This will show the countdown timer (and optional “End at” text).

You must use the exact name or the script will not update it.

Status Source

Name it exactly: Pomodoro Status

This will display the current mode (Focus, Short Break, Long Break) if enabled.

You can hide this text in the script settings if you only want the timer visible.

Installation
Download the .lua script.

In OBS, go to Tools → Scripts.

Click +, select the .lua file.

Create your Pomodoro and Pomodoro Status text sources (exact names).

Configure all options in the script settings panel.

Map your hotkeys in Settings → Hotkeys.

How to Use
Press Start or use your hotkey to begin.

The timer will automatically handle focus/break cycles.

Use Pause, Resume, Reset, or Skip anytime.

Optionally set auto-start for a specific scene.

Requirements
OBS Studio 28 or later.

Windows, macOS, or Linux.

Support & Custom Versions
I create custom OBS scripts on request—tailored to your needs.
If you want a personalized Pomodoro timer with unique features, DM me directly.

📸 Follow me on Instagram for updates and direct requests:
instagram.com/animalshadow
I always reply.