Skip to content

Flow Logging Scripts

Arie J. Godschalk edited this page Nov 13, 2026 · 2 revisions

Flow logging scripts

Home · Flows

The community forum topic describes scripts for adding or removing Simple (Sys) Log cards in Homey Flows. These are separate tools, not app features that run automatically. They run in Homey's Web API Playground and edit Flow definitions.

Automatically add logging

The include-logging script can work on selected standard Flows and Advanced Flows. It can add log cards for standard Flow triggers, condition groups and Then/Else branches. In Advanced Flows, it can connect logs to card outputs, including error outputs.

For example, the generated entries can show that a flow started, which condition group passed, whether the Then or Else branch ran, or that an Advanced Flow card executed or produced an error. Exact messages depend on the script version and the Flow.

The script adds an intentional hidden Automater configuration card to each Advanced Flow. Keep this card if you use the script; it stores per-flow settings:

  • Update controls whether a script run refreshes the configuration card.
  • Update Cards controls whether existing generated log cards are synchronized from that configuration.
  • Separate severity settings are available for errors, triggers, conditions and actions.

The forum's example starts error entries at Error (3) severity and trigger, condition and action entries at Info (6). These values can be changed in the script or configuration card; see severity levels.

Before running the script:

  1. Review the script and back up the Flows it may change.
  2. Set its flowNames list to a small test selection. In the forum example, setting flowNames to null selects all Flows.
  3. Check the card placement, logging options, severity values and categories configured at the start of the script.
  4. Run it on the test Flow and verify the resulting cards and log entries before expanding the selection.

The original post describes the script as work in progress, and later replies include revisions. Check the latest version in the forum topic before using it.

Remove Flow cards

The same topic includes a separate cleanup script that removes cards belonging to a selected app from standard Flows and Advanced Flows, along with associated Advanced Flow connections. The topic notes that tokens are not removed.

Review this script especially carefully: its example appId initially targets PaperTrails, not Simple (Sys) Log. Check the app ID and Flow selection before running it. The reallyExecute switch is off by default; keep it off while reviewing, because turning it on applies the removals.

Clone this wiki locally