Skip to content

Getting Started

Arie J. Godschalk edited this page Nov 15, 2026 · 6 revisions

Getting started

Home · Flows · Devices · Widgets

Before you start

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.

Contents

Choose the right chronograph

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.

Your first timer

  1. Create a Flow and choose the event that should begin the countdown, such as a button press.
  2. Add Chronograph's Start or replace timer action.
  3. Give it a name, such as Kitchen fan, and set the duration to 10 minutes.
  4. Save and enable the Flow, then test it.
  5. 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.

Names and the picker

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.

Wildcards

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.

Time, pausing and restart

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.

Duration expressions

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.

Clone this wiki locally