AWTRIX 3 Plugin for Indigo

An Indigo plugin for controlling AWTRIX 3 LED matrix clocks (such as the Ulanzi TC001) via MQTT.

Requirements

• Indigo 2025.1 or later
• MQTT broker (e.g. Mosquitto) accessible on your network
• Ulanzi TC001 (or compatible device) running AWTRIX 3 firmware

The plugin automatically installs its Python dependencies (paho-mqtt, cryptography) when first loaded.

Installation

1. Download the latest release from the Releases page
2. Double-click AWTRIX.indigoPlugin to install in Indigo
3. Enable the plugin when prompted

Setup

1. Create an AWTRIX Coordinator

The coordinator manages the MQTT broker connection. You need one coordinator per MQTT broker.

1. Go to Devices > New... and select Type: AWTRIX 3
2. Select Model: AWTRIX Coordinator
3. Configure the MQTT broker connection:
   • MQTT Broker IP - your broker's IP address
   • MQTT Broker Port - typically 1883
   • MQTT Username / Password - if your broker requires authentication (password is encrypted at rest)
   • MQTT Client Prefix - unique prefix for the MQTT client ID (default: indigo_awtrix)
   • MQTT Protocol - MQTTv311 (default) or MQTTv31

2. Create an AWTRIX Clock

Each clock device represents one physical AWTRIX device.

1. Go to Devices > New... and select Type: AWTRIX 3
2. Select Model: AWTRIX Clock
3. Configure:
   • AWTRIX Coordinator - select the coordinator created above
   • AWTRIX MQTT Prefix - the MQTT prefix configured on your AWTRIX device (e.g. awtrix_XXXXXX). You can find this in the AWTRIX web interface under MQTT settings.

Once created, the clock device will show as connecting ... until it receives its first stats update from the AWTRIX device (typically within a few seconds). If the device doesn't come online, check that the MQTT prefix matches exactly.

Device Controls

The clock device appears as a dimmer in Indigo, giving you native on/off and brightness control:

• Turn On / Turn Off - powers the AWTRIX display on or off
• Set Brightness - adjusts display brightness (0-100%, mapped to 0-255 on the device)
• Brighten By / Dim By - relative brightness adjustments

These controls work from the Indigo client, UI+ app (Mac and iOS), and Control Pages.

Device States

The clock device exposes the following states for use in triggers, conditions, and Control Pages:

Offline Detection

The plugin monitors stats updates from each clock. If no stats are received for 60 seconds, the device is marked as offline. It automatically recovers when stats resume.

Button Presses

Physical button presses on the Ulanzi TC001 (left, middle, right) update the lastButtonPress state. You can create Indigo triggers on this state to respond to button events.

Actions

All actions are available under Device Actions when configuring Action Groups, Triggers, or Schedules for an AWTRIX Clock device. Each action can also be called from scripts using executeAction() with the action ID and props shown below.

Send Notification

Display a temporary notification on the clock.

Action ID: sendNotification

Dismiss Notification

Dismiss a held notification. No props required.

Action ID: dismissNotification

Navigate App

Switch to the next or previous app in the app loop.

Action ID: navigateApp

Update Custom App

Create or update a custom app that appears in the app loop.

Action ID: updateCustomApp

Remove Custom App

Remove a custom app from the app loop by name.

Action ID: removeCustomApp

Set Indicator

Set one of three coloured indicator dots on the right side of the display.

Action ID: setIndicator

Clear Indicator

Turn off an indicator dot.

Action ID: clearIndicator

Switch to App

Jump directly to a specific app by name.

Action ID: switchApp

Play Sound

Play a sound on the device's buzzer.

Action ID: playSound

Set Mood Light

Turn the entire LED matrix into a coloured background light.

Action ID: setMoodLight

Update Settings

Change device settings without using the AWTRIX web interface. Only include the settings you want to change. Leave props as empty string or "unchanged" to skip them.

Action ID: updateSettings

Sleep

Put the device to sleep for a specified duration. The device wakes automatically when the timer expires, or when the middle button is pressed. Use Turn Off for indefinite power off.

Action ID: sleepDevice

Reboot Device

Reboot the AWTRIX device. No props required.

Action ID: rebootDevice

Send Raw MQTT JSON

Send any MQTT message to the device for advanced use cases not covered by the built-in actions.

Action ID: sendRawJson

Variable Substitution

All text fields in actions support Indigo variable substitution markup:

For example, a notification text of Indoor: %%d:67890:temperature%%F would resolve at runtime to something like Indoor: 72.5F.

Scripting

All plugin actions are scriptable from Indigo's built-in Python scripting:

awtrix = indigo.server.getPlugin("com.autologplugin.indigoplugin.awtrix3")
if awtrix.isEnabled():
    awtrix.executeAction("sendNotification", deviceId=12345, props={
        "text": "Hello from a script!",
        "icon": "2056",
        "color": "#FF0000",
        "duration": "10"
    })

Available action IDs: sendNotification, dismissNotification, navigateApp, updateCustomApp, removeCustomApp, setIndicator, clearIndicator, switchApp, playSound, sendRawJson, setMoodLight, updateSettings, sleepDevice, rebootDevice

Refer to the action descriptions above for the complete list of available props for each action.

Compatibility

• Indigo: 2025.1 or later (Server API 3.7)
• macOS: Compatible with all macOS versions supported by Indigo 2025.1
• AWTRIX Firmware: AWTRIX 3 (tested with recent releases)
• MQTT: v3.1 and v3.11

Support

• AWTRIX 3 Documentation
• Indigo Domotics Forum

License

This project is licensed under the MIT License. Copyright © 2026 Autolog.