> For the complete documentation index, see [llms.txt](https://pahutyakv.gitbook.io/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://pahutyakv.gitbook.io/docs/pomodoro-timer.md).

# Pomodoro Timer

### <mark style="color:$success;">Getting Started</mark>

To open the Pomodoro Timer window, navigate to:

**Tools → PahutyakV → Pomodoro Timer**

In the main window, choose one of the available actions:

* **Work** — start a focus session
* **Short Break** — start a short break
* **Long Break** — start a long break

While the timer is running, you can control it using:

* **Pause** — temporarily stop the countdown
* **Resume** — continue a paused session
* **Stop** — reset the timer

***

### <mark style="color:$success;">Session Display</mark>

The main interface provides clear visual feedback about your current session:

* A **circular timer** shows the remaining time.
* The **header** displays the active session type:
  * Work
  * Short Break
  * Long Break

If no session is active, the header shows: **Pomodoro Timer**

* The progress arc color matches the current session type.
* Colors can be customized in the Settings tab.

***

### <mark style="color:$success;">Statistics Tab</mark>

The Statistics tab provides insights into your productivity.

#### Displays

* **Today**\
  Number of completed work sessions today.
* **Average (Last 30 Days)**\
  Average daily work sessions over the past 30 days.
* **Activity Graph**\
  A 30-day bar chart showing daily session counts.\
  Includes days with zero activity.
* **Max / Min Indicators**\
  Shows your most and least productive days in the last 30 days.

#### Actions

* **Clear Statistics**\
  Resets all recorded session data after confirmation.

***

### <mark style="color:$success;">Settings Tab</mark>

Customize session durations and visual appearance.

#### Configure minutes and arc colors for

* Work
* Short Break
* Long Break

#### Additional Settings

* **Console Log**\
  Enable or disable logging to the Unity Console.
* **Auto Continue**\
  Automatically start the next session when the current one ends.
* **Long Break Interval**\
  Number of completed work sessions required to trigger a long break.
* **Bell Sound**\
  Optional audio clip played when a session finishes.

***

### <mark style="color:$success;">Auto Continue Behavior</mark>

When **Auto Continue** is enabled, session transitions happen automatically.

#### After a Work Session

* If completed sessions today % Long Break Interval == 0 → **Long Break**
* Otherwise → **Short Break**

#### After a Break

* A new **Work** session starts automatically.

#### Notifications

* Popups notify you about session changes.
* Works both when Unity is focused and unfocused.
* Console logging is optional.

***

### <mark style="color:$success;">SceneView Overlay</mark>

You can control the timer directly from the Scene View.

#### Enable Overlay

1. Open **Scene View**
2. Click the **Overlay** menu
3. Enable **Pomodoro Timer**

#### Overlay Controls

If **Buttons In Overlay = true** in Settings:

* **W** — Start Work session
* **S** — Start Short Break
* **L** — Start Long Break

***

### <mark style="color:$success;">Persistence & Editor Behavior</mark>

The Pomodoro Timer handles data automatically:

* Session progress and statistics are saved.
* Active and suspended sessions survive domain reloads.
* The timer resets when the Unity Editor is closed.

***

### <mark style="color:$success;">Built-in To-Do List</mark>

To manage your tasks, open the **To-Do** tab in the Pomodoro Timer window.

Use the task list to organize your current work:

* **Add Task** — enter a task name and click **+**
* **Complete Task** — check the box next to a task to mark it as completed
* **Remove Task** — click **X** to delete a task
* **Clear Completed** — remove all completed tasks from the list

Completed tasks are automatically moved to the bottom of the list, and the header displays your current progress as **Completed: X / Y**.

***

### <mark style="color:$success;">Quick Tips</mark>

* Customize colors to quickly identify session types.
* Enable Console Log for notifications when Unity is in the background.
* Use Long Break Interval to create custom cycles\
  (e.g., every 4 sessions → long break).