> For the complete documentation index, see [llms.txt](https://monthly-calender-widgets.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://monthly-calender-widgets.gitbook.io/docs/utilities/stopwatches.md).

# Stopwatches

Stopwatches are count-up utilities that track elapsed time from when you started them. Unlike countdown timers, they have no target end time -- they just keep counting.

## Key concepts

### Multiple stopwatches

You can create and manage several stopwatches in the app. Each stopwatch tracks its own elapsed time independently with a name and custom color.

### Active stopwatch

The **active stopwatch** is the one displayed in Lock Screen widgets. Only one stopwatch is active at a time.

### Persistent timing

Once started, a stopwatch continues running even if you close the app. State is stored in the shared App Group container so the app and Lock Screen widget stay in sync.

## Creating a stopwatch

1. Open the app and go to the **Widgets** tab.
2. Scroll to the **Stopwatches** section.
3. Tap **+** to create a new stopwatch.
4. Give it a name (e.g., "Workout", "Study Session", "Cooking").
5. Pick a **color**.
6. Tap **Save**.

## Starting and stopping

Control stopwatches from multiple places:

* **In the app** -- Start, stop, and reset buttons in the Widgets tab.
* **Lock Screen widget** -- View elapsed time at a glance (display only).

## Lock Screen widget

### Stopwatch Detailed (Rectangular)

Shows elapsed time with full precision. The display scales automatically:

* Starts showing seconds and minutes.
* Scales to hours, days, months, and even years as elapsed time grows.

Also shows the stopwatch name and running/stopped status.

## Use cases- **Workouts** -- Track exercise duration, rest periods, or total gym time.

* **Study sessions** -- Monitor how long you've been studying.
* **Cooking** -- Time recipes or multiple dishes.
* **Work tracking** -- Log time spent on tasks or projects.
* **Personal challenges** -- Track streaks or personal records.## Tips- Use descriptive names for your stopwatches. <<<<<<< Updated upstream
* The active stopwatch is shared between app surfaces and Lock Screen widgets.
* Combine with dual stopwatches to track two activities at once.## Pro requirementStopwatch widgets are a **Pro feature**. =======
* The active stopwatch is shared between all surfaces (app, Lock Screen, Control Center).
* Combine with dual stopwatches to track two activities at once.## Pro requirementStopwatch widgets are a **Pro feature**.

> > > > > > > Stashed changes


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://monthly-calender-widgets.gitbook.io/docs/utilities/stopwatches.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.