# Pomodoro Timer

A simple focus timer that runs in your terminal. It follows the
"Pomodoro" technique: work for **25 minutes**, take a **5 minute break**,
repeat. While it runs you'll see a countdown and a progress bar, and your
terminal beeps when each focus session or break is over.

It's a single Python file with nothing extra to install.

## What you need

- Python 3.7 or newer (already on most Macs and Linux computers; on Windows,
  get it from [python.org](https://www.python.org/downloads/)).

## How to start it

1. Download `pomodoro.py`.
2. Open a terminal (on Windows: Command Prompt or PowerShell) in the folder
   where you saved it.
3. Run:

   ```
   python3 pomodoro.py
   ```

   On Windows, use `python pomodoro.py` (or `py pomodoro.py`) instead.

The timer keeps going (focus, break, focus, break...) until you press
**Ctrl+C**. When you stop, it tells you how many focus sessions you finished.

## Options

You can change the times if you want:

| Option | What it does | Example |
| --- | --- | --- |
| `--focus MINUTES` | Length of each focus session (default 25) | `--focus 50` |
| `--break MINUTES` | Length of each break (default 5) | `--break 10` |
| `--rounds N` | Stop after N focus sessions (default: keep going) | `--rounds 4` |
| `--quiet` | Don't beep | `--quiet` |

For example, four rounds of 50 minutes work with 10 minute breaks:

```
python3 pomodoro.py --focus 50 --break 10 --rounds 4
```

Run `python3 pomodoro.py --help` to see all options.

## Not hearing a beep?

The beep is the terminal's built-in "bell". Some terminals have it turned
off or show a visual flash instead. Check your terminal's settings for
"bell" or "audible bell" if you'd like to hear it.