Repository navigation
Devices
Home · Getting started · Flow actions · Widgets
Chronograph provides Stopwatch, Timer, and Transition devices for Homey. A device represents one named chronograph of the corresponding type: it lets you see its status and duration and control it from Homey's device interface. It is a virtual device; no physical timer or sensor is required.
Adding a device is optional. Flows can create and control a chronograph without one, and a widget can display the same named chronograph independently. The device, widget and Flow cards refer to the same underlying instance when their type and name match.
| Device | What it shows | Guide |
|---|---|---|
| Stopwatch | Elapsed time while an activity is running. | Stopwatch device |
| Timer | Time remaining in a countdown. | Timer device |
| Transition | Elapsed time for a transition. Use a Flow to apply its values to another device. | Transition device |
These are virtual Homey devices, not physical equipment. They have no per-device settings. All three expose the same controls; the displayed duration depends on the selected type.
- Create a Flow with a Start or replace or Start or resume action for
the desired type. Enter a fixed name, such as
Kitchen fan, then save and enable the Flow. - In Homey, choose Add device, select Chronograph, and choose Stopwatch, Timer, or Transition.
- Select the corresponding name in the list and complete the add-device steps. The displayed name may be formatted for readability.
- Run the Flow to start the chronograph. Open the added device to monitor and control it.
The device list is built from names in saved start and start-or-resume cards and applicable trigger cards. Use a fixed, specific name for a device, rather than a wildcard or a name supplied dynamically by a Flow token. A selected picker name takes precedence over the text field. Saving a Flow establishes the name for selection; it does not itself start the chronograph.
| Device | Duration shown | When it ends |
|---|---|---|
| Stopwatch | Elapsed time, in seconds | Continues until stopped. |
| Timer | Time remaining, in seconds | Finishes at its target duration or is stopped. |
| Transition | Elapsed time, in seconds | Finishes at its target duration or is stopped. |
The Started indicator means the chronograph exists, including when it is paused; it is not a separate “currently running” indicator. The duration stays at the paused value until resumed. Once stopped or finished, the active instance is removed.
The transition device shows time, not the current interpolated value. To apply transition values to another device, use a transition step Flow.
- Pause / Resume pauses a running instance or resumes a paused one. It has no effect when the chronograph does not exist.
- Start / Stop stops an existing instance. Starting uses the arguments retained from the last start observed by that device; the device does not offer a form to enter a new duration or transition values.
For a reliable first start, add the device and then start the chronograph using its Flow. After that, the device can reuse the retained start arguments. If no start arguments are available, the device's start control cannot create an instance. To use different values, start it with a Flow or use the widget start form, where available.
For type-specific behavior and examples, see the Stopwatch, Timer, and Transition guides.
- Save a Flow that turns on the fan and starts timer
Kitchen fanfor 10 minutes. - Add the Timer device for
Kitchen fan, then run that Flow. - Open the device to see the remaining seconds. Pause and resume the timer if needed, or stop it early.
- In a separate Flow, use Timer is finished for
Kitchen fanto turn off the fan. If stopping early should also turn off the fan, create a separate Timer is stopped Flow: stopping is not finishing.
- The name is not listed when adding a device: check the device type and save an enabled Flow with a fixed name in a start or start-or-resume card.
- The device is unavailable: check that a saved, relevant Flow card still refers to the same type and name. Restore or update the Flow if it was removed or renamed.
- The device does not start: first start the named chronograph from a Flow after adding the device, so the device has start arguments to reuse.
- Pause / Resume does nothing: start the chronograph first. A finished or stopped timer no longer exists to resume.
- A transition does not change another device: add a Flow using its step trigger and value token; adding the transition device alone does not operate the target device.
Support development - If Chronograph is useful to you, you can support its
continued development through GitHub Sponsors,
Patreon,
PayPal, or
bunq.
Thank you!