Skip to content
Arie J. Godschalk edited this page Nov 19, 2026 · 16 revisions

Simple (Sys) Log manual

Simple (Sys) Log gives Homey Flows a logbook for messages and events. Add entries from a Flow, optionally show them in Homey's Timeline, then review, filter and export the log from the app settings or read it on a dashboard.

Simple (Sys) Log Flow card example: Simple (Sys) Log manual

Actual Homey card examples, saved but disabled. They have not been run; follow this page for the full setup and connections.

I want to… Start here
Install the app Homey App Store (Homey v12.3.0 or newer)
Add my first message to the log Getting started
Follow a practical Flow example Examples
Use Simple (Sys) Log in Flows Flows
Automatically add or remove logging cards in Flows Flow logging scripts
Send messages to or receive messages from Syslog systems Syslog devices
Look up severity levels or categories Severity levels · Categories
Use dynamic text or export filenames with BLL BLL coding
Review, filter, export or retain log entries App settings
Show the log on a dashboard Log viewer widget
Change the layout or colors Widget designer
Import or share a widget template Widget templates (TWF)
Scroll the log in the Homey app on Android Android Web widget
Pass a download address to another Flow card Get log export URL
Read or write log entries from a script or another app API reference
Fix a logging or settings issue Troubleshooting

What can I do?

  • Add messages from a Flow and store them in daily files with Better Logic Library.
  • Group entries and attach severity and category (Syslog facility) values.
  • Add a message to the log, Homey's Timeline, or both.
  • Start another Flow when a log entry is generated.
  • Optionally use a community script to add logging to selected Flows.
  • Send selected or routine Homey log entries to an external Syslog receiver.
  • Receive Syslog messages from other devices into the Simple (Sys) Log.
  • Review entries in the app settings, including new entries as they arrive.
  • Search and filter recent entries on a dashboard, with optional paging.
  • Export the complete log as CSV, Excel or JSON.
  • Clear the complete log or remove older entries.

Entries can be created by multiple Flows and integrations. Use a consistent group name to make related messages easy to filter, and choose a severity when you want to distinguish errors or warnings from routine events.

Scope: Simple (Sys) Log does not automatically record every Flow run. It records entries sent to it by its Flow cards, API or Syslog devices. Add logging cards where you need them, or use the optional community script to add them to selected Flows.

Privacy first

Logs can reveal routines, device names, network addresses and other private data. Do not log passwords or tokens. Restrict access to exports and receivers. The app exposes a public log-reading route; see API access and privacy. Syslog traffic is not encrypted by these devices.

Before you start

Install Simple (Sys) Log from the Homey App Store; the app requires Homey v12.3.0 or newer. Create and enable a Flow with one of the app's logging actions; see Getting started.

Better Logic Library (BLL) is optional for basic logging. Without its settings assets, the app provides a simpler view of the temporary backlog and basic controls. Installing BLL enables persistent file storage, the full settings interface, the log viewer widget and BLL-coded text fields. You can use ordinary text and Homey Flow tokens without making BLL a prerequisite. See BLL coding for supported fields and examples.

Flow card names may be translated in Homey and can vary between app versions.

Next steps

Write your first entry, then filter or export it or try an example Flow.

Support

Visit the Simple (Sys) Log Homey Community topic or report an issue on GitHub.

Clone this wiki locally