Pomodoro
A pomodoro widget is a focus timer that alternates between work sessions (typically 25 minutes) and short breaks to sustain attention over longer work blocks. WidgetCraft's Pomodoro widget lets you customize work, break, and long-break durations via URL parameters, tracks your completed session count, and embeds in Notion, Obsidian, or any iframe-capable website.
WidgetCraft's Pomodoro widget implements the full Pomodoro Technique cycle: a configurable work session (default 25 minutes) followed by a short break (default 5 minutes), with a longer break (default 15 minutes) after every 4 completed work sessions. The timer display shows minutes and seconds in large tabular-numeral text, a thin progress bar fills as the session elapses, and three mode buttons — Focus, Break, Long Break — let you jump between phases manually. A session counter at the bottom tracks how many focus blocks you've completed since the last reset. All durations are configurable: append `?work=50&break=10&longbreak=20` to the URL for a 50/10/20 split. Because the timer runs entirely in the browser with no backend, it keeps ticking even if you switch tabs — though the audio bell is not yet implemented (the session auto-advances silently on completion). Embed it in an Obsidian daily note alongside your task list, or in a Notion project page to keep sprint focus blocks visible.
Questions, answered.
Can I customize the work and break intervals?
Yes. Add `?work=50&break=10&longbreak=20` to the embed URL to set your own durations in minutes. The builder also exposes sliders for all three intervals.
Does it ring a bell at the end of each session?
Not in the current version — the session ends silently and the timer automatically advances to the next phase. Audio notification support is planned for a future release.
Can I link the pomodoro to my Spotify so music plays during work sessions?
Direct cross-widget linking is not yet supported. Run the Pomodoro and Spotify widgets side by side in the same page or Notion view — they operate independently.
What happens after 4 pomodoros?
After every 4 completed work sessions, the timer automatically queues a long break instead of a short one. The session counter increments with each completed focus block.
Can I pause and resume the timer?
Yes. The Start/Pause button toggles the timer. Pausing stops the countdown where it is; clicking Start again resumes from the same point.
Does the pomodoro timer work if I switch to another tab?
Yes. The timer runs via a JavaScript interval in the iframe, which continues ticking in the background even when the tab is not in focus.
How do I reset the timer back to the beginning?
Click the Reset button. This stops the timer, clears the session count, and returns to the work phase with the full configured duration.