Skip to content
Arie J. Godschalk edited this page Nov 15, 2026 · 11 revisions

Chronograph manual

Chronograph adds named stopwatches, timers and transitions to Homey. Use them in Flows to schedule actions, measure elapsed time, or gradually change a value. You can monitor and control them from app settings, a Homey device, or a dashboard widget.

I want to… Start here
Understand the three chronograph types Getting started
Create a timer, stopwatch or transition Getting started
Follow a complete Flow example Examples
React when something starts, finishes or reaches a point Flow triggers
Test whether something is running or has passed a duration Flow conditions
Start, pause, adjust, resume or stop a chronograph Flow actions
Browse every current Flow card Flows
Calculate a duration using MathJS expressions and Flow tokens Math expressions
Use Better Logic Library code in supported Flow fields BLL coding
Monitor chronographs or change app settings App settings
Add a Homey device to monitor and control a chronograph Devices
Add and configure a dashboard widget Widgets
Create a widget design or color scheme Widget designer
Integrate with scripts or another Homey app API reference
Fix a problem with a Flow, device or widget Troubleshooting

What can I build?

  • A stopwatch: measure how long an activity takes, or react when it reaches a threshold.
  • A timer: turn on a fan for 10 minutes and notify yourself when it finishes.
  • A transition: gradually change a light's brightness using values produced at each step.

For Homey app developers

The chronograph-npm package helps another Homey app retrieve Chronograph data and listen for realtime updates. Install it with npm install chronograph-npm and add the homey:app:nl.fellownet.chronograph permission to your app. See the package on npm and its documentation and examples.

Chronographs are identified by their type and name. For example, a timer and a stopwatch can both be called Kitchen without being the same chronograph. They are created by Flow actions; a separate setup step is not required.

Before you start

Install Chronograph on Homey and use its Flow cards in a Flow or Advanced Flow. For dashboard widgets, this app requires Homey software 12.3.0 or later; widgets are not supported on Homey Cloud. Card names can differ in other languages and between app versions.

This manual follows the current Chronograph app source. Features available to you may differ depending on the app version installed on your Homey.

Clone this wiki locally