Skip to content

BLL Coding

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

BLL coding

Home · Flow examples · Flows

Better Logic Library (BLL) can replace expressions inside supported text fields with their results. For example, it can add today's date to an announcement without a separate formatting Flow.

Before you start

Install Better Logic Library alongside Google Services. First make a plain-text announcement or translation work. BLL does not configure Google credentials, generate a voice, or play the audio for you.

Supported fields

  • Text in the cloud Text-to-Speech actions and conditions.
  • Text in the Non-Cloud Text-to-Speech actions.
  • Text in the Google Translate actions, including the token-returning Advanced Flow version.

The Translate condition and YouTube search cards currently pass their text directly rather than evaluating BLL expressions. Voice, language, speed, pitch and volume selectors are not general-purpose BLL text fields. Use ordinary values in those inputs.

Speak the current time

  1. Open the speech action in your working announcement Flow.

  2. Replace its Text with:

    The time is {[date("HH:mm")]}.
    
  3. Run the Flow. The generated speech should contain the current clock time rather than the expression.

  4. Check that your player receives and plays the generated URL as before.

Put expressions between {[ and ]}; keep the surrounding sentence outside them. Formatting follows the locale used by the speech device or selected voice. Selecting a different voice does not translate your surrounding sentence.

Non-Cloud speech has a 200-character limit checked both before and after expression evaluation. Keep test messages short.

Translate dynamic text

Use an action from Google Translate Flowcards, not its Translate condition. A supported Text input can contain:

The time is {[date("HH:mm")]}.

BLL first inserts the time, then Google translates the resulting sentence. Choose suitable source and target languages and check the Translation output or updated device value.

If the expression appears as text

Check that BLL is installed and running, the input is listed above, and the brackets and expression are correct. Test with Hello first to separate speech or translation problems from expression problems.

See BLL coding and examples for syntax, and the Google Services integration examples for date announcements and other ideas. Do not put passwords or other private information in speech text.

Clone this wiki locally