Repository navigation
Devices Timer
Home · Devices · Stopwatch · Transition
The Timer device represents one named countdown. It is optional: a Flow can start and react to a timer without a device.
- Create a Flow with Start or replace timer or Start or resume timer.
Enter a fixed name, such as
Kitchen fan, and a positive duration. - Save and enable the Flow so the name is available.
- In Homey, choose Add device → Chronograph → Timer, then select
Kitchen fan. - Run the Flow to start the countdown.
The picker lists configured names for the selected type. A timer named
Kitchen fan is separate from a stopwatch or transition with the same name.
The Duration capability shows the time remaining, in seconds. It updates while the timer is running and stays at the remaining value while paused. The Started indicator means the timer exists; it remains on while paused. When the countdown reaches zero, the timer finishes and is removed.
- Pause / Resume freezes the countdown or continues it from the remaining time.
- Start / Stop stops the current timer or starts it using the arguments retained from its most recent start Flow.
Run the timer from a Flow once before relying on the device Start control. The device does not provide a form for changing the duration. Use a Flow or the timer widget's start form to choose new values.
Chronograph does not add device-scoped Flow cards. These app-level cards address the selected type and exact name; the optional device represents that same chronograph.
| Card | Purpose |
|---|---|
| Timer is started | Starts the Flow when a new timer starts; resuming does not count as a new start. |
| Timer is finished | Starts the Flow when the timer reaches its target duration and finishes. |
| Timer is stopped | Starts the Flow when the timer is explicitly stopped. |
| Timer reached an elapsed duration | Starts the Flow when the selected amount of time has elapsed since the timer started. |
| Timer reached a remaining time | Starts the Flow when the timer reaches the selected remaining-time threshold. |
| Timer is paused | Starts the Flow when the running timer is paused. |
| Card | Purpose |
|---|---|
| Timer is running or not | Tests whether a matching timer is currently running. |
| Timer longer or shorter than | Tests whether the timer has more than the selected time remaining. |
| Card | Purpose |
|---|---|
| Start or replace timer | Creates or replaces the named timer with the supplied start values. |
| Resume timer | Resumes a matching paused timer; it does not create one. |
| Start or resume timer | Starts the timer if absent, resumes it if paused, and leaves it running if already active. |
| Pause timer | Pauses the named timer without removing it. |
| Adjust timer | Adds or subtracts elapsed time on the named timer. |
| Stop timer | Stops and removes the named timer. |
| Get the duration of a timer | Returns elapsed and remaining time in numeric and formatted Flow tokens. |
| Stop all timers | Stops and removes all active timers at once. |
To switch off a fan after 10 minutes, start timer Kitchen fan for 10
minutes in the same Flow that turns the fan on. In a separate Flow, use
Timer is finished for Kitchen fan and
connect it to the fan's Turn off action.
Expected result: the device shows the remaining seconds. The fan turns off when the timer finishes. If you stop the timer early, it does not count as finished; use a separate Timer is stopped Flow if early stopping should also turn off the fan.
For shared pairing and control details, see Devices. For more reproducible Flows, see Examples.
Support development - If Chronograph is useful to you, you can support its
continued development through GitHub Sponsors,
Patreon,
PayPal, or
bunq.
Thank you!