productivity

Pomodoro Timer

A local-first Pomodoro timer with Picture-in-Picture, focus/break cycles, session history, and distraction tracking.

Local processing
About your filesFiles and content selected in this tool are processed in your browser and are not uploaded to a Browser Kitty backend.
Operation demo See the basic workflow in a short video.

About this tool

Pomodoro Timer is a browser-based focus timer for alternating focused work and breaks without taking over your workspace. The default 25-minute focus, 5-minute short break, and 15-minute long break durations can be customized.

On supported browsers, an interactive Document Picture-in-Picture window keeps the timer visible while you work in other tabs or apps. Timer state, the current focus target, settings, and history stay in the browser.

Good for

  • Structure work or study into focused intervals with regular breaks
  • Keep a small timer visible while working in another tab or desktop app
  • Track focus time and distractions without adopting a full task-management system

What it can do

Key capabilities available in this tool.

How to use

  1. Enter one thing you want to accomplish in the current session.
  2. Adjust focus, short-break, and long-break durations if needed.
  3. Start the timer and, on desktop, open Picture-in-Picture if useful.
  4. Record distractions when they happen, or use Flow extension / +5 minutes when you want to keep going.
  5. Complete the session to move to the next break and review today's focus statistics and history.

Supported

  • Timer: focus, short break, and long break with customizable durations.
  • PiP: Document Picture-in-Picture where supported, with Video PiP or normal-page fallback.
  • Stats: today's focus time, completed sessions, distractions, and recent history.
  • Storage: settings, active timer state, and history in LocalStorage, with JSON export/import.

Limitations and notes

  • Document and Video Picture-in-Picture availability depends on the browser and operating system.
  • Desktop notifications require browser permission.
  • Clearing browser site data removes history that has not been exported as JSON.
  • Cloud sync, shared tasks, and full project/ToDo management are intentionally out of scope.

Frequently asked questions

Can I use durations other than the standard 25/5 minutes?

Yes. Focus, short-break, and long-break durations can each be customized.

Can I keep the timer visible while working in another app?

On supported browsers, yes. Picture-in-Picture can keep a small timer visible; when Document PiP is unavailable, Video PiP or the normal page remains usable.

Is timer history uploaded to a server?

No. Settings and history are stored in browser LocalStorage and are not uploaded to Browser Kitty.

What if I want to keep working after the focus timer reaches zero?

Enable Flow extension to keep counting overtime instead of forcing a break when the timer reaches zero.

Offline version and source code

The root-level pomodoro-timer.html on GitHub is a self-contained single HTML file. The timer works locally, while PiP, notifications, and some browser features may depend on the execution environment.

View source on GitHub