Question 1

How does the Pomodoro timer work?

Accepted Answer

The classic Pomodoro Technique alternates 25-minute focus sessions with 5-minute short breaks. After every 4 work sessions, take a longer 15-minute break. Start the timer, work until it beeps, take the suggested break, then start the next session. The session counter shows your progress (e.g. 3/8). All timing runs locally in your browser — no network needed.

Question 2

Can I customize the durations?

Accepted Answer

Yes. Set the work duration (default 25 min), short break (5 min), long break (15 min), how often to take a long break (default every 4 work sessions), and the total number of work sessions planned (default 8). Or pick a preset: Classic (25/5/15), Long (50/10/30), Short (15/3/10), or Custom.

Question 3

How does the beep work? Does it need an audio file?

Accepted Answer

No external audio file is used. The beep is synthesized on-the-fly using the Web Audio API — an oscillator running at one of three preset frequencies (low 220 Hz, medium 440 Hz, high 880 Hz). This keeps the tool 100% client-side with zero asset downloads. You can mute the beep entirely with the sound toggle.

Question 4

What extra features does this tool have compared to others?

Accepted Answer

(1) 4 session presets (Classic, Long, Short, Custom). (2) Phase calculator (work / short-break / long-break). (3) Time formatter/parser (MM:SS ↔ seconds). (4) Phase sequence generator (full plan for totalSessions). (5) Total time estimator (work + breaks). (6) 3 beep frequency presets. (7) Beep parameter builder (Web Audio plays the actual sound in the UI). (8) Text report generator (session breakdown). (9) CSV report generator (session_num, phase, duration_min). (10) History (localStorage, max 20 completed runs). (11) Shareable URL (settings in hash). (12) Summary stats (total work/break/overall time, sessions completed). (13) Circular progress indicator. (14) Auto-start next phase toggle.

Question 5

Is my data sent anywhere?

Accepted Answer

No. The timer runs entirely in your browser. No audio is downloaded — beeps are synthesized with the Web Audio API. Completed-session history is stored in localStorage on this device only. The share link encodes settings in the URL hash, which never leaves the device unless you copy and send it.

Pomodoro Timer

Plan (15 steps)

How to use

Plan (15 steps)