Awtrix NG
The dim level changed
AWTRIX
Connected Smart Clock for your Smart Home
AWTRIX is an open‑source custom firmware for the Ulanzi Smart Pixel clock TC001 or as upgrade for the old AWTRIX 2 Mainboard and even self build matrix clock
It is ready to use straight out of the box, with time, date, temperature, and humidity pages pre-installed. You don't need to do anything other than turning it on to start using these features.
However, for those with more advanced skills, the customization options available with customapps and mqtt commands allows you to take Awtrix to its full potential. Just send all your custom apps from your smarthome via app and update it in realtime. The powerful icon system brings your ideas to life and lets you enjoy a hassle-free experience.
Supported devices
Flow cards
Click on a device above to show related Flow cards only.
When...
Awtrix NG
Left button was pressed
Enable button callbacks in the AWTRIX NG device settings before using this trigger.
Awtrix NG
Middle button was pressed
Enable button callbacks in the AWTRIX NG device settings before using this trigger.
Awtrix NG
Right button was pressed
Enable button callbacks in the AWTRIX NG device settings before using this trigger.
Awtrix NG
Knob was pressed
Enable button callbacks in the AWTRIX NG device settings before using this trigger.
Awtrix NG
Knob was turned
Enable button callbacks in the AWTRIX NG device settings before using this trigger. The turn token is negative to the left and positive to the right.
Awtrix NG
The active application changed
Observed via HTTP every 5 seconds while this card is used. Initial load and reconnection do not trigger. Brief changes between observations may be missed. Uses rotation names, including homey-. Notifications do not change the active app.
Awtrix NG
Audio playback changed
Observed via HTTP every 5 seconds while this card is used. Initial load and reconnection do not trigger. Brief changes between observations may be missed.
Awtrix NG
Radio playback changed
Observed via HTTP every 5 seconds while this card is used. Initial load and reconnection do not trigger. Brief changes between observations may be missed.
Awtrix NG
A new playback error was observed
Observed via HTTP every 5 seconds while this card is used. Initial load and reconnection do not trigger. Brief changes between observations may be missed. The same persistent error is reported once. HTTP connectivity failures are logged separately.
Awtrix3
The battery level changed
Awtrix3
The humidity changed
Awtrix3
The luminance changed
Awtrix3
The temperature changes
Then...
Awtrix NG
Dim to %
Awtrix NG
Set relative dim-level %
Dim or brighten with respect to the device's current dim-level.
Awtrix NG
Create/update application app name message icon color JSON options
Create or update an application. Name must match A-Z, a-z, 0-9, _ or - and be at most 26 characters. Optional options must be device-specific JSON. Use Homey's Add duration option to override the JSON options or the device default duration.
Awtrix NG
Create/update raw application app name raw JSON payload
Create or update an application using a raw JSON payload. Enter the app name without the internal homey- prefix. This card is for advanced users and accepts only fields supported by the selected device.
Awtrix NG
Remove application app name
Remove application from device
Awtrix NG
Set display state
Enable or disable display
Awtrix NG
Show indicator location indicator with color color and effect effect for effect duration
Set an indicator. Effect duration is in milliseconds.
Awtrix NG
Hide indicator location indicator
Disable indicator
Awtrix NG
Send notification message with icon icon and color color
Send a notification. Use Homey's Add duration option to override the device default duration.
Awtrix NG
Dismiss notification
Dismiss permanent notification
Awtrix NG
Send raw notification raw JSON payload
Send a notification using a device-specific raw JSON payload. For AWTRIX NG, use NG-shaped JSON fields such as text and durationMs. For AWTRIX 3, use AWTRIX 3-shaped JSON fields such as text and duration.
Awtrix NG
Send sticky notification message with icon icon and color color
Send sticky notification to device with optional icon and color
Awtrix NG
Play melody melody
Play RTTTL melody
Awtrix NG
Set weather overlay overlay
Set the weather overlay shown on the display.
Awtrix NG
Play synthesized sound bpm 120; inst lead wave=pulse volume=40; lead: c4 e g c5
Play a synthesized sound once. On the new audio API it replaces the current alert; older firmware plays an fx effect.
Awtrix NG
Play MP3 MP3 URL
Download and play an MP3 once, without storing it. Maximum 4 MB and 120 seconds. This action finishes when playback ends and reports download errors. Replaces the current alert.
Awtrix NG
Play Soundboard MP3 Sound
Requires Soundboard and a local Homey address reachable from the clock. Plays once without copying to storage. MP3 only, maximum 120 seconds. Select the sound again if it was deleted and replaced.
Awtrix NG
Stop the current alert sound
Stops the alert group, including a URL or Soundboard sound. Script sounds and radio are controlled separately.
Awtrix NG
Show Icon (optional), Title in Title color above Text below the title, options JSON options
52×16 display: optional icon on the left, colored title above white text. Fitting text stays still; long rows scroll independently at the device scroll settings. Without timing options, long rows complete once. Add duration or JSON durationMs (milliseconds), not both. JSON must contain only timing and notification options such as name, hold, wakeup and sound. Visual fields and layout are rejected; use RAW for a custom layout.
Awtrix NG
Update app App name: Icon (optional), Title in Title color above Text below the title, options JSON options
52×16 display: optional icon on the left, colored title above white text. Fitting text stays still; long rows scroll independently at the device scroll settings. Without timing options, long rows complete once. Add duration or JSON durationMs (milliseconds), not both. JSON must contain only timing and app lifetime options; use the app name without homey-. Visual fields and layout are rejected; use RAW for a custom layout.
Awtrix NG
Set ... volume to Volume (%)%
The master and group levels multiply. Zero silences that group. Radio requires radio support.
Awtrix NG
Stop ... audio
Stops alerts, script sounds, radio or everything. An alert stop also cancels a URL sound being prepared.
Awtrix NG
Play radio station Station
Select a station saved on the clock. Radio continues until stopped. Alerts pause radio and it resumes afterwards.
Awtrix NG
Play radio Stream URL
MP3 streams only; M3U and PLS playlists are supported. Does not save a station. Radio continues until stopped.
Awtrix NG
Save station Station name with URL Stream URL
Adds a station or replaces the URL of the station with this exact name. Keeps the other stations. Up to 32 stations.
Awtrix NG
Send and play audio Audio file URL
Homey downloads and sends the file directly. MP3 or 16-bit PCM WAV, maximum 2 MiB. Plays once without storing. This action finishes when playback starts.
Awtrix NG
Send and play Soundboard file Sound
Requires Soundboard. Homey resolves the current file and sends it directly. MP3 or 16-bit PCM WAV, maximum 2 MiB; no stored copy. Finishes when playback starts.
Awtrix NG
Show script Script
Select a working, enabled script installed on the clock. Starts on-demand scripts. Next or previous app ends an on-demand script. Background scripts and modules are not shown.
Awtrix NG
Set panel brightness to Brightness (%)%
Sets manual brightness. Disables automatic brightness on devices with a light sensor. Does not switch display power.
Awtrix NG
Set Script setting Setting / key to Value
Uses declared settings. Text and select values are plain text; booleans true/false, numbers as numbers, colors #RRGGBB or integers. Out-of-range values fail. Saving restarts the script.
Awtrix NG
Read Script setting Setting / key
Returns a text Value token in Advanced Flow. Numbers and booleans are represented as JSON. A missing setting fails.
Advanced
Awtrix NG
Change Script stored data to JSON changes
Supply a non-empty JSON object. Only these keys change; null removes a key. Declared settings use a separate card. Saving restarts the script.
Awtrix NG
Read Script stored value Setting / key
Returns a text Value token in Advanced Flow. Structured data is JSON. A missing key fails.
Advanced
Awtrix NG
Read shared script value Shared value
Read-only. Returns a text Value token in Advanced Flow. Values disappear after script restart; a missing value fails.
Advanced
Awtrix NG
Dismiss notification Notification name
Removes the named notification even while waiting in the queue. Use the same name as in notification JSON. The reserved name active uses the existing active notification card. A missing name reports an error.
Awtrix3
Create/update application app name message icon color JSON options
Create or update an application. Name must match A-Z, a-z, 0-9, _ or - and be at most 26 characters. Optional options must be device-specific JSON. Use Homey's Add duration option to override the JSON options or the device default duration.
Awtrix3
Remove application app name
Remove application from device
Awtrix3
Set display state
Enable or disable display
Awtrix3
Show indicator location indicator with color color and effect effect for effect duration
Set an indicator. Effect duration is in milliseconds.
Awtrix3
Hide indicator location indicator
Disable indicator
Awtrix3
Send notification message with icon icon and color color
Send a notification. Use Homey's Add duration option to override the device default duration.
Awtrix3
Dismiss notification
Dismiss permanent notification
Awtrix3
Send raw notification raw JSON payload
Send a notification using a device-specific raw JSON payload. For AWTRIX NG, use NG-shaped JSON fields such as text and durationMs. For AWTRIX 3, use AWTRIX 3-shaped JSON fields such as text and duration.
Awtrix3
Send sticky notification message with icon icon and color color
Send sticky notification to device with optional icon and color
Awtrix3
Play melody melody
Play RTTTL melody
Support
Having an issue with this app? Contact the developer via the Homey Community Forum.
What’s new
Version 2.3.5 — Fixed UTF8 in scripts
AWTRIX
AWTRIX is not compatible with the selected Homey.
AWTRIX will install on Homey shortly.
Changelog
We’ll send a thank you to Radovan Kepák!
We’ll let Radovan Kepák know you love the app.
Your suggestion has been sent
We’ll notify Radovan Kepák you’ve sent a suggestion.
Africa
Asia
Europe
Belgium
Deutsch English
Bulgaria
Croatia
Cyprus
Czech Republic
Estonia
Finland
Greece
Hungary
Iceland
Ireland
Latvia
Lithuania
Malta
Moldova
The Netherlands
Portugal
Romania
Slovakia
Slovenia
Türkiye
Ukraine
United Kingdom
