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

  • Runs on 32×8 (TC001 & DIY)
  • Runs on 52×16 (TC002) 52×16 (TC002) version
  • 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

The 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 animation with rising bubbles across the entire LED matrix.

Key Features

  • Dynamic Liquid Animation: Real-time water level visualization (0–100%) with animated rising air bubbles.
  • Silky Smooth Subpixel Bubbles: Continuous vertical subpixel anti-aliasing and gentle horizontal sine-wobble for fluid, realistic bubble motion.
  • Consistent Bubble Frequency: Fixed virtual cycle height ensures bubble frequency and spawn rate stay perfectly steady and calm, even at low water levels.
  • Configurable Auto-Hide: Optional setting to automatically skip and hide the app from the AWTRIX carousel rotation when the water level reaches or exceeds a configurable threshold (e.g. 100% or custom percentage).
  • 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 rests at a low baseline and shows --% in amber instead of misleading values.
  • Adaptive Text Shadow: Subtle ambient drop-shadow effect rendered behind text and numbers to ensure maximum contrast and legibility against water and bubbles.
  • Display Modes:
    • 52×16 Variant: Supports both high-visibility 10-pixel large bitmap font and standard font with free positioning (left, center, right / top, middle, bottom).
    • 32×8 Variant: Clean, compact standard font permanently centered horizontally and vertically for optimal readability on the 8-pixel matrix.
  • Native Web UI Configuration: Fully configurable via the AWTRIX-NG App settings menu.

Configuration Options

52×16 Variant
Setting Type Default Description
MQTT Topic Text (empty) MQTT topic publishing the level data.
Wave & Bubble Speed Number (1–10) 3 Adjusts wave oscillation and bubble rise 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.
Hide above Threshold Select (no / yes) no Automatically hides the app from the rotation when the water level reaches or exceeds the threshold.
Hide above Level (%) Number (0–100) 100 Water level percentage threshold at or above which the app is hidden.
Horizontal Alignment Select left Small text alignment: left, center, or right.
Vertical Alignment Select top Small text alignment: top, middle, or bottom.
32×8 Variant
Setting Type Default Description
MQTT Topic Text (empty) MQTT topic publishing the level data.
Bubble Speed Number (1–10) 3 Adjusts the rise speed of the air bubbles.
Text Shadow Select (no / yes) yes Soft drop-shadow behind text to enhance contrast over the water.
Hide above Threshold Select (no / yes) no Automatically hides the app from the rotation when the water level reaches or exceeds the threshold.
Hide above Level (%) Number (0–100) 100 Water level percentage threshold at or above which the app is hidden.

More scripts in Smarthome

Something wrong with this script? Report it.