Pomodoro Timer

WHAT IT DOES

Pomodoro Timer implements the popular Pomodoro Technique for focused work sessions. The timer alternates between work intervals (default 25 minutes) and break intervals (default 5 minutes), with a longer break (default 15 minutes) after every 4 work sessions. A visual countdown timer shows the remaining time, and notifications alert you when sessions transition. The tool tracks completed sessions and displays them as you work. You can start, pause, reset, and toggle the timer at any time. All intervals are fully customizable, and a floating timer can be displayed in any corner of your screen.

WHERE IT RUNS

The extension runs entirely within your browser's local environment using the BotGentz framework. All timer counting, session tracking, and notification handling occur on your machine without any network requests. No timer data, session history, or user activity is ever transmitted, uploaded, or stored externally. The tool works on any website and respects the browser's security boundaries, operating within the isolated extension sandbox. The timer uses the browser's setInterval with one-second precision.

HOW TO USE

Click the extension toolbar icon to open the Pomodoro Timer panel. The panel shows the countdown timer, current mode (Work or Break), session number, and completed session count. Click "Start" to begin the timer. Click "Pause" to pause the timer. Click "Toggle" to switch between start and pause. Click "Reset" to reset the timer to the start of a work session and clear session count. Toggle "Show timer" to display a floating timer in the corner of your screen. Toggle "Enable notifications" to receive flash messages when sessions transition. Change the timer position using the dropdown (Bottom Right, Bottom Left, Top Right, Top Left). Adjust the "Work Duration" (1-120 minutes) to set how long each work session lasts. Adjust the "Short Break" (1-30 minutes) to set break duration between work sessions. Adjust the "Long Break" (1-60 minutes) to set the extended break after multiple sessions. Adjust the "Sessions Before Long Break" (2-10) to control how many work sessions before a long break.

THE POMODORO ENGINE — WHY IT WORKS

Most Pomodoro timers rely on complex state machines or external libraries. This tool uses a simple but robust state engine with three primary states: isRunning (boolean), isWork (boolean), and timeLeft (seconds). The timer ticks every second, decrementing timeLeft and updating the display. When timeLeft reaches zero, the engine evaluates the current state: if in work mode, it increments the session counter, determines whether to use a short or long break based on sessions completed, and switches to break mode. If in break mode, it switches back to work mode. The notification system uses P.flash for visual feedback. The floating timer is a fixed-position element that updates in real time via the same interval. The session counter persists in memory until reset, providing a running total of completed Pomodoro sessions. This architecture is lightweight, responsive, and works across all pages without external dependencies.

THE PANEL

The Pomodoro Timer panel is fully draggable by its title bar and remembers its position on screen per website. It snaps to the edges of your browser window for clean alignment. Collapse the panel to a compact icon strip using the minimize button, restoring it with a single click. Resize the panel by dragging any edge or corner; the timer display and controls adjust proportionally. Press the Escape key to close the panel instantly. The panel maintains independent state for each browser tab, allowing you to run separate timers in multiple tabs simultaneously.

PLEASE NOTE

This extension requires the free BotGentz extension framework to be installed and enabled. The timer runs in the current browser tab; switching tabs or minimizing the browser does not pause the timer. The timer continues running even when the panel is closed. The session counter tracks completed work sessions only; break sessions are not counted. All timer data is processed locally and is never transmitted, logged, or shared. The extension requests no network permissions and functions entirely offline. The source code is fully auditable and available for review.