Skip to content

Log Viewer

Arie J. Godschalk edited this page Nov 18, 2026 · 1 revision

Log viewer widget

Home · Getting started · App settings

Simple Sys Log shows recent log entries on a Homey dashboard. You need Homey Pro, Homey v12.3.0 or newer, and Better Logic Library (BLL) running for the widget to read the file-backed log. The widget is not available on Homey Cloud. A dashboard widget is separate from the log grid in app settings.

Add the widget

  1. Write a test entry and check it in the app settings. If you already have entries, note the message of a recent one.
  2. Edit the Homey dashboard, add a widget, and select Simple Sys Log from Simple (Sys) Log. Start with Default for Design and Theme.
  3. Keep Using scroll on Android? off for the native viewer. Save the widget and confirm the test entry appears. For scrolling in the Homey Android app, use the Web widget setup instead.

Illustration of the steps from a test entry to the dashboard viewer

Illustration: confirm one entry in app settings before looking for it on the dashboard.

Widget settings

Setting Default and effect
Entries per page 25. A positive whole number. Without paging, this caps the number of newest matching entries loaded. With paging, it is the page size.
Height (pixels) 500; accepts 100–5000. The native list scrolls within this height while the toolbar stays at the top.
Light or dark mode Automatic follows the dashboard. Choose Light or Dark to override it.
Design, Theme Default for each. A design controls layout and typography; a theme controls colors. Create custom choices in the designer.
Date and time format Uses the design's timestamp format unless you pick a BLL format here. You can also type a custom BLL format and select it. This does not change the day separator's format.
Search mode Simple. Choose None to hide search or Advanced for combined terms.
Show filters On. Turning it off hides and disables the interactive Level and Date filters, not search or the saved widget settings below.
Enable paging Off. Adds Previous and Next below the entries when enabled.
Minimum severity Debug shows all. For example, Warning shows Warning and more urgent levels by default. An explicit Level selection replaces this threshold until cleared.
Facility All. Choose one category to restrict the list.
App / Group filter, Hostname filter Blank matches all. Enter part of a name; matching ignores case.
Using scroll on Android? Off. Enabling it replaces the native list with links for a Web widget.

Filter and search

  1. Open the filter menu. Under Level, choose one or more exact severity levels. No selected levels means the widget uses Minimum severity again.
  2. Under Date, set From, To, or both. The bounds include the whole selected calendar days. Leave a bound empty for an open-ended range. For one day, choose the same date twice. Select real dates, no later than today, and do not put From after To. Clear the date range to show all dates again.
  3. Search for text such as door opened. Search ignores case and checks message, app/group and hostname within the currently loaded entries. If you don't find an older entry, clear the search and narrow the dates or try another page, then search again.

Illustration of Level and Date narrowing log results before search scans the loaded page

Illustration: Level and Date narrow the log query; search scans only the entries the widget loaded.

Level and Date apply to new entries as well as the initial view. They are remembered per widget instance, independently of widget settings. With Advanced search, use AND, OR, NOT, phrases in double quotes, and parentheses. Adjacent words act like AND. For example:

("front door" OR garage) AND NOT test

Simple search treats the entire input as one text fragment. To search more than the current widget page, use the log grid.

Page through the log

Turn on Enable paging and choose a size such as 10 in Entries per page. With more than ten matching entries, Next opens older results and Previous returns toward newer results. Changing Level or Date returns you to the first page. Live entries are shown on the first page, not inserted into a page of older results. Without paging, the widget keeps only the configured number of matching newest entries. When new entries arrive at the top, the viewer follows them if you are near the top and otherwise tries to keep your current reading position.

Illustration of two ten-entry pages with Previous and Next navigation

Illustration: Next moves to older entries; a new Level or Date filter starts the view at page one.

Next: make a custom design, import a TWF, or set up scrolling on Android.

Clone this wiki locally