Repository navigation
Getting Started
Home · Flows · Devices · Widgets
Install Chronograph on Homey. You can create named chronographs with Flow cards; there is no separate setup step. For dashboard widgets, you need Homey software 12.3.0 or later. Widgets are not supported on Homey Cloud.
- Choose the right chronograph
- Your first timer
- Names and the picker
- Time, pausing and restart
- Duration expressions
| Type | How it works | Example |
|---|---|---|
| Stopwatch | Counts elapsed time upwards until you stop it. | Measure a workout. |
| Timer | Counts down from a duration. When it reaches the end, it finishes. | Run a fan for 10 minutes. |
| Transition | Advances through time from a start value to an end value, producing step values for Flows. | Gradually change a light setting. |
A transition does not operate a device by itself. A separate Flow must listen for its steps and use the emitted value in the device action.
- Create a Flow and choose the event that should begin the countdown, such as a button press.
- Add Chronograph's Start or replace timer action.
- Give it a name, such as
Kitchen fan, and set the duration to10minutes. - Save and enable the Flow, then test it.
- Create another Flow with Timer is finished, using the same name, and add an action such as switching off the fan.
Check the timer under Chronograph app settings → Chronographs. To display it as a Homey device or on a dashboard, add a timer device or widget for the same name. See Devices and Widgets.
Most cards have both a Pick field and a Name field. Select or type and select a name in the picker, or enter a name in the text field. If both are filled, the picker takes precedence. Names can appear in the picker after the enabled Flow containing them has been saved. When using a token or a wildcard pattern, use the name field and leave the picker empty.
Use the same type and name across the action and trigger cards that should work together. Starting a chronograph with a name already in use for that type replaces it. A paused chronograph still exists; a stopped or finished one does not.
Supported cards accept * in the name field to match zero or more characters;
for example, Room * can match Room kitchen and Room hall. This is useful
for matching trigger names and for pause, resume-existing, adjust and stop
operations. Running conditions can test whether any matching chronograph of
that type is running. Wildcard matching is case-sensitive. Wildcards are not names
for creating a new chronograph, and are not supported by every card.
Durations can use milliseconds, seconds, minutes, hours or days where offered. Pause freezes elapsed time; resume continues the existing chronograph. Stopping removes it. Timers and transitions also finish and are removed at their target. Chronographs are persisted across Homey restarts.
Starting, adjusting, stopping and pausing have different Flow events. In particular, resuming is not a new start event. The started and finished trigger cards are not interchangeable with stopped.
Supported duration fields on the current start, start-or-resume and adjust cards use a restricted subset of MathJS for arithmetic and selected functions. Examples:
ceil(99.5) / 5
pick(1, 3, 5, 9) * 2
random(10, 30)
abs(-10)
Available functions are abs, ceil, floor, round, random, min,
max and pick. random(min, max) includes the lower bound but excludes
the upper bound. The selected unit applies to the evaluated result. You can
also use Flow tokens in these fields. See
MathJS expressions in Flow cards for supported cards,
functions, limitations and practical examples.
Support development - If Chronograph is useful to you, you can support its
continued development through GitHub Sponsors,
Patreon,
PayPal, or
bunq.
Thank you!