Skip to content

Getting Started

Arie J. Godschalk edited this page Nov 19, 2026 · 12 revisions

Getting started

Home · Flows · Syslog devices · App settings

Install Simple (Sys) Log from the Homey App Store; the app requires Homey v12.3.0 or newer. Install Better Logic Library as well if you want daily log files, the full log grid and exports, or the dashboard viewer. The first entry below works in the basic view without BLL.

Add your first log entry

  1. Create a Flow and choose the event that should be recorded, such as a device state change.
  2. Add the Add Something to the Log action.
  3. Enter My first log entry in Message. Later, you can insert Flow tokens to include values from earlier cards.
  4. Save and enable the Flow, then trigger it once.
  5. Open Simple (Sys) Log's app settings and look for My first log entry.

Flow action for adding the first message to the log

To keep entries easy to find, use a consistent group name. The group is shown as the App value in the log viewer. If you also want severity and facility metadata, choose an action that has those optional fields.

Example: record a door event

  1. In When, choose the door sensor's opened trigger.
  2. In Then, choose Add Something to the Simple Log.
  3. Enter a message such as Front door opened, set the group to Entry, and choose a severity such as Notice.
  4. Save the Flow, open the door to test it, and filter the settings view by Entry to find the entry.

Flow action for recording a door event

Choose where the message goes

  • Log only: use Add Something to the Log.
  • Log and Timeline: use Add Something to the Timeline and the Log.
  • Timeline only: use Add Something to the Timeline.
  • Grouped log: use Add Something to the Simple Log and fill in the optional group, severity and facility fields.

Flow actions for choosing whether a message goes to the log, Timeline, or both

The grouped Timeline-and-log action adds the group to both destinations. The app setting Show group in Timeline controls whether the group is prefixed to that Timeline message.

To start a second Flow when an entry is written, use A log is generated in the When section. For example, filter it to group Entry and severity Warning, then add a notification action that includes the trigger's log token. The trigger reacts to new entries; it does not replay entries that were already in the log.

Flow trigger for starting a Flow when a matching log entry is created

Severity and category

Grouped actions can assign an optional severity and category. Leave either field empty when the distinction is not useful. See the full severity-level list and category list.

Keep and export entries

With BLL running, open the app settings to filter the log or export it. You can also add Flow actions to clear the complete log, clear entries older than a number of days, retrieve the log as a token, or generate a local download link. See Flows and App settings.

For an in-Homey automation, the Flow cards are usually the simplest way to record or retrieve data. Scripts and other Homey apps can use the app API.

Fields marked * BLL supported can optionally include BLL expressions. Ordinary text and inserted Flow tokens do not require BLL. See BLL coding for supported fields and examples.

To exchange messages with other Syslog systems, pair a Syslog client to send messages out or a Syslog server to receive messages. See Syslog devices for setup details and network requirements.

Next: check the first entry, add it to a dashboard, or try a notification Flow.

Clone this wiki locally