Skip to content

BLL Coding

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

BLL coding

Home · Flow actions · App settings

Better Logic Library (BLL) can evaluate expressions embedded in supported text fields. It is optional: ordinary text and Homey Flow tokens work without BLL.

Where BLL coding works

  • The Message field on Simple (Sys) Log's log and Timeline Flow actions marked * BLL supported.
  • The Excel, CSV and JSON export filename fields in the settings panel.

Other text fields are not automatically decoded. In particular, use plain text or Flow tokens in the Syslog client device action unless its field is explicitly marked as BLL-supported.

Expression format

Put an expression between {[ and ]}. BLL evaluates the expression when the Flow action runs or the export is requested, then inserts its result into the surrounding text.

For example, enter this in a supported message field:

Door opened on {[date("dddd")]}.

The date expression is replaced with the current weekday; the rest of the message stays as written.

Export filenames can use the same format. For example:

Homey-log_{[date('yyyy-MM-dd_HH-mm-ss')]}.csv

This adds a timestamp to the filename. Simple (Sys) Log uses this date-based pattern for its default Excel, CSV and JSON export filenames.

You can also insert Homey Flow tokens in supported message fields using Homey's token picker. BLL expressions can be part of the same text as those tokens.

Requirements and troubleshooting

BLL must be installed and available to Homey for expressions to be evaluated. If it is unavailable, the app leaves the expression text unchanged; a coded filename or message may therefore retain the {[...]} text. Plain text and Flow tokens continue to work without BLL.

If an expression is not evaluated:

  1. Confirm that BLL is installed and running.
  2. Confirm that the field is marked * BLL supported.
  3. Check the expression syntax and that the function is available in BLL.

See the BLL user guide for more about its expressions and available functions.

Clone this wiki locally