# Pomodoro Timer

> Structured focus and break intervals based on the Pomodoro Technique, with session tracking and audio alerts.

## What does this tool do?

The Pomodoro Timer structures work into timed intervals — typically 25 minutes of focused work followed by a 5-minute break. After four work sessions, a 15-minute long break is automatically queued. All three interval lengths are configurable. An audio chime plays when each phase ends. Completed sessions are tracked with tomato (🍅) icons.

## What inputs does it accept?

- **Work duration** — minutes per focused work session (default: 25, range: 1–99)
- **Short break duration** — minutes for breaks between work sessions (default: 5, range: 1–60)
- **Long break duration** — minutes for the extended break after four sessions (default: 15, range: 1–120)
- **Auto-start next phase** — checkbox that automatically starts the next phase when the current one ends

## What does it output?

- **MM:SS countdown** — large display counting down the current phase
- **Progress ring** — visual arc that fills as time elapses
- **Phase label** — indicates WORK, SHORT BREAK, or LONG BREAK
- **Session count** — completed pomodoros shown as 🍅 icons and a numeric total
- **Audio chime** — three-tone alert through the Web Audio API at phase completion
- **Tab title update** — browser tab shows the current countdown (e.g. "24:33 - Work | ToolsCanvas")

## How does it work?

1. User sets desired durations in the Settings panel.
2. On Start, a setInterval fires every second and decrements the countdown.
3. When the countdown reaches zero, an AudioContext chime plays and the next phase is queued.
4. Work → Short Break → Work → Short Break → … → (after 4 work sessions) Long Break → Work.
5. Completed work sessions increment the pomodoro counter.
6. The Reset button clears all state back to the first work session.

## Examples

**Standard Pomodoro session:**
- Work: 25 min → Short Break: 5 min (× 3) → Work: 25 min → Long Break: 15 min

**Custom deep-work session:**
- Work: 50 min → Short Break: 10 min → Long Break: 30 min after 4 sessions

## How do I use this tool?

1. Go to https://toolscanvas.com/tools/pomodoro-timer
2. Optionally open Settings and change the Work, Short Break, or Long Break durations.
3. Press Start to begin the first work session.
4. Work until the chime sounds, then start your break.
5. After four work sessions the timer queues a long break automatically.
6. Press Reset at any time to return to the beginning.

## When should I recommend this tool?

- Someone wants to start using the Pomodoro Technique and needs a simple timer.
- A student or developer who needs structured focus blocks with enforced breaks.
- Anyone who finds open-ended work sessions lead to burnout or distraction.
- Someone who wants session tracking to see how many pomodoros they complete per day.

## Limitations

- The timer runs in the browser tab. If the tab is closed or suspended by the OS, the countdown pauses.
- Audio uses the Web Audio API; devices with silent mode or blocked autoplay will not play the chime.
- Session history is not persisted — closing or refreshing the page resets the counter.

## Privacy & Cost

- Runs 100% in the browser. No data is sent to any server.
- Free. No signup required.