Repository navigation
Widgets
Home · App settings · Devices · Widget designer
Chronograph provides separate Stopwatch, Timer, and Transition widgets for monitoring and controlling a selected chronograph. Homey software 12.3.0 or later is required; Homey Cloud does not support these widgets. Widgets are separate from optional Chronograph devices; neither needs the other to monitor the same named chronograph.
For type-specific design and color previews, see the Stopwatch, Timer, and Transition guides. There is also a guide to the Multiple Chronographs widget.
- Create and save an enabled Flow containing the chronograph name you want to use.
- Add the appropriate Chronograph widget to your Homey dashboard.
- Open its settings and select the stopwatch, timer or transition by name.
- Choose a layout and, optionally, a design, color scheme and icon. Save the widget settings.
- Start the chronograph with your Flow or use the widget's start control.
The widget name must correspond to the same type and name used in the Flow. The optional Alternative name changes the displayed label, not the chronograph being controlled. If a name is missing from the picker, save and enable the relevant Flow and check again.
The Multiple Chronographs widget can display up to ten stopwatches, timers and transitions together. Select each chronograph in its numbered setting and choose its own alternative name, design, color scheme, layout, icon and millisecond display. Empty slots are skipped.
Choose one to three columns for the widget, then set the column span for each selected chronograph. An entry spans at most the available number of columns; entries wrap to the next row when they do not fit. Each tile's controls affect only its selected chronograph.
When no design is selected, each chronograph uses Default when it spans the full widget width. In a two-column widget, a one-column chronograph uses Small. In a three-column widget, a two-column chronograph uses Small and a one-column chronograph uses Tiny. Spans are limited to the available number of columns. An explicitly selected design always takes precedence, including Default. Small and Tiny are also available in the design picker and the widget designer. In Small and Tiny, the progress bar appears below the controls so the other elements can align with a stopwatch displayed alongside them. Each chronograph uses its selected design's height mode independently. A grid row is as tall as its tallest chronograph.
Use Row separation to leave rows unseparated, display each row as a widget-style card, or place a line between rows. In card mode the space between the full-width cards is transparent. Line color chooses the line's color and applies only when line separation is selected.
Unlike the individual widgets, the multiple widget has no settings for default start values. Its start forms use the last saved Flow or API values when available; otherwise enter the missing values before starting.
Depending on the chosen design and state, the widget can show:
- Play / Resume: continue a paused chronograph or open the start form.
- Start: start an inactive chronograph using the form values.
- Pause: pause a running chronograph.
- Stop: remove the active chronograph.
- Cancel: close the start form without starting.
Some designs place start fields directly in the inactive view rather than behind Play. A design can hide controls or elements in particular states; if you cannot see a control, check the selected design and its visibility rules. The stopwatch starts without a duration form. Widget controls operate the selected chronograph, not all chronographs. Focusing a start-form field shows its label near the field, including when a default value is already filled in.
| Setting | Purpose |
|---|---|
| Chronograph | Select the configured name of the widget's type. |
| Alternative name | Display a shorter or friendlier label. |
| Design Style | Select a built-in or custom layout; customize button text per size in the Widget designer. |
| Color Scheme | Select a built-in or custom set of colors independently of the design. |
| Layout | Choose Compact, Normal, or Larger. Each size can have its own layout. |
| Icon | Search for a Font Awesome Free icon, or select None. |
| Show milliseconds | Include milliseconds in the displayed time. |
| Default duration and unit | Timer and transition start-form defaults. |
| Default transition start, end and steps | Transition start-form defaults. |
An empty color selector uses the built-in Default. An empty design selector uses Default for individual widgets; the multiple widget uses the column-dependent defaults described above. Create custom choices in Chronograph app settings → Widgets and save them before selecting them in the widget.
For timers and transitions, a default duration of 0 uses the last available
duration saved by a Flow or API start. Automatic unit uses its saved unit,
or minutes if none is available. If no usable duration is available, enter
one in the form. A widget start needs a duration of at least 1 in its
selected unit.
For transitions, an empty or 0 default start/end value uses the last saved
Flow or API value. Empty or 0 steps similarly use the saved step count; a
valid step count is at least 2. Check the values shown in the form before
starting.
Starting from a widget does not overwrite the saved Flow/API defaults. A start-or-resume Flow action saves its supplied defaults when it creates a new chronograph; resuming an existing one does not replace them.
- The widget asks for a chronograph: select one in the widget settings and verify the type and name.
- Start fails: check the duration and unit, and for transitions the start value, end value and step count.
- A control or field is missing: try another widget size or the Default design, then inspect the design's state and row visibility.
- A transition runs but no device changes: create and enable a Flow that uses its step trigger and value token in the device action.
Support development - If Chronograph is useful to you, you can support its
continued development through GitHub Sponsors,
Patreon,
PayPal, or
bunq.
Thank you!