Repository navigation
Home
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.

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 |
- 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.
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.
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.
Write your first entry, then filter or export it or try an example Flow.
Visit the Simple (Sys) Log Homey Community topic or report an issue on GitHub.
Support development - If Simple (Sys) Log is useful to you, you can support its
continued development through GitHub Sponsors,
Patreon,
PayPal, or
bunq.
Thank you!