Repository navigation
Home
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 |
- 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.
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.
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.
Support development - If Chronograph is useful to you, you can support its
continued development through GitHub Sponsors,
Patreon,
PayPal, or
bunq.
Thank you!