Skip to content
All devices

Which AWTRIX do you have?

The Hub then shows only what runs on it.

Show

Devices

Sign in

New Share your ideas with the AWTRIX community. Keep your creations together in your account.

Sign in

Which AWTRIX do you have? Choose it once and the Hub shows what runs on it.

ScriptAWTRIX NG

WaterLevel

by fshero10 Oct 2026
On an AWTRIX display
WaterLevel shown on an AWTRIX display
WaterLevel · by fshero

On your display

An interactive water level app that visualizes cistern or tank levels received via MQTT through a smooth fullscreen water-wave and bubble animation with customizable text layouts.

Which AWTRIX do you have? See below where it runs, or choose your device.
Topic
Smarthome
Includes
Script

Runs on

  • Does not run on 32×8 (TC001 & DIY) Made for 52×16 (TC002).
  • Runs on 52×16 (TC002)
  • Does not run on 32×8 with AWTRIX 3 (TC001 & DIY) Made for AWTRIX NG.

Choose your display in the next step.

↓ Download script
Send to AWTRIX

Choose your AWTRIX

WaterLevelAWTRIX NG script

Install this script on your AWTRIX NG. Its icons and sounds are installed with it.

Your AWTRIX’s local address, for example 192.168.178.39 or awtrix.local.

The name shown in your AWTRIX script list. Use letters, digits, hyphens or underscores.

Connection & device login

Connect your phone or computer to the same network as your AWTRIX. Allow local network access if your browser asks.

Use the device’s IP address, without a page path such as /#/apps.

If your AWTRIX requires a login, the username and password fields will appear when you connect.

Sign in to the Hub to install scripts. Attached files are installed separately.

Script description

Overview

This WaterLevel app connects to your local smart home setup via MQTT to display current liquid levels—such as rainwater cisterns, water tanks, or pools—through a live-rendered, organic water wave animation across the entire display.

Key Features

  • Dynamic Fullscreen Animation: Real-time sinusoidal waves and rising air bubbles that adapt dynamically to the current fill percentage (0–100%).
  • Live MQTT Integration: Subscribes to any custom MQTT topic, automatically handling both raw numbers and JSON payloads (e.g., {"percent": 75} or {"level": 75}).
  • Clean No-Data State: When waiting for initial sensor data, the display gently ripples at a low baseline and shows --% in amber instead of misleading values.
  • Dual Display Modes:
    • Large Centered Text: High-visibility 10-pixel bitmap font rendered dead-center for easy reading from a distance.
    • Standard Text with Free Alignment: Compact font with full control over horizontal and vertical positioning.
  • Dynamic Text Shadow: Subtle ambient drop-shadow effect rendered behind text and numbers to ensure high contrast and maximum readability against moving water waves and bubbles.
  • Native Web UI Configuration: Fully configurable via the AWTRIX-NG App settings menu.

Configuration Options

Setting Type Default Description
MQTT Topic Text (empty) MQTT topic publishing the level data.
Wave Speed Number (1–10) 3 Adjusts wave oscillation and bubble speed.
Large Centered Text (ignores alignment) Select (no / yes) no Displays large 10px numbers centered on screen. When enabled, alignment options are bypassed.
Text Shadow Select (no / yes) yes Soft drop-shadow behind text to enhance contrast and readability over moving waves.
Horizontal Alignment Select left Small text alignment: left, center, or right.
Vertical Alignment Select top Small text alignment: top, middle, or bottom.

More scripts in Smarthome

Something wrong with this script? Report it.