smarthomejunkie/Ulanzi-Awtrix-BluePrints

Manual for the Ulanzi Clock - Awtrix Firmware BluePrints

Ulanzi-Awtrix-3-BluePrints

Manual for the Awtrix 3 Firmware BluePrints (and the Ulanzi Desktop Clock)

Click the image to watch the video. (It will open in this browser window)

Table of Contents:

• Ulanzi-Awtrix-BluePrints
• Where to get the Blueprints and firmware?
• How to install or update
• How to use
  • 1. Awtrix Create Notification
  • 2. Awtrix Create Sensor App
  • 3. Awtrix Rain Forecast
  • 4. Awtrix Set Transition Time
  • 5. Awtrix Toggle Stock App
  • 6. Toggle Indicators
  • 7. Awtrix Weather App
  • 8. Awtrix Moodlight
  • 9. Awtrix List Calendar
• FAQ
• Release Notes

Where to get the Blueprints and firmware?

1. You can download the Home Assistant Blueprints by sponsoring me on this Ko-Fi page. You will get lifetime updates, and you can download new versions by logging in to Ko-Fi when a new update is released.

2. You can get the Awtrix 3 firmware on this site.

3. You can find the Awtrix 3 Repository here.

4. Check the manual of Awtrix 3 here.

How to install or update

1. Upload (or overwrite) the smarthomejunkie folder into the /config/blueprints/automations folder in Home Assistant.
2. After uploading the Blueprints, go to Developer Tools > YAML tab and click AUTOMATIONS. Your existing automations will still work.
3. You can upload the weather icons in the ICONS folder using the file manager in the Awtrix web interface.
4. You can upload the notification file alert.txt in the MELODIES folder using the file manager in the Awtrix web interface.

How to use

There are 9 Blueprints to control your Ulanzi Desktop Clock using Awtrix. Each automation that you create with a Blueprint needs a toggle helper to turn the notification or app on or off. Don't forget to create a toggle (or number) helper for each automation that you create with these Blueprints!

1. Awtrix Create Notification

With this Blueprint, you can send a notification to the clock. It's also possible to use template code in the message

Fields:

Name	Type	Default	Example	Description
Awtrix Displays	dropdown		awtrix_d6b064	Select the target Awtrix displays
Toggle Helper	dropdown		input_boolean.display_power	Select the Toggle Helper that will toggle the notification on or off
Notification Text	string		Examples: Dinner is Ready! The electricity price is now {{ states('sensor.electricity_price',rounded= True,with_unit=True) }}	Enter the notification text. Template code is allowed.
Icon	string		1234	Enter the Icon Name or ID of the icon that you like to show.
Push Icon	dropdown	2	0=Icon doesn't move 1=Icon moves with text and will not appear again 2=Icon moves with text but appears again when the text starts	Icon behavior
Text Case	dropdown	0	0=Use global setting 1=Force Uppercase 2=Show as you entered it	Select how you would like your text to display
Background Color	color_rgb	[0, 0, 0]	[255, 255, 0]	Select the Background color
Text Color	color_rgb	[0, 0, 0]	[255, 255, 0]	Select the Text color
Gradient 1	color_rgb	[0, 0, 0]	[255, 255, 0]	Select the first Gradient color if you want to use a gradient color for the text. This will be ignored if both gradient colors are the same.
Gradient 2	color_rgb	[0, 0, 0]	[255, 255, 0]	Select the second Gradient color if you want to use a gradient color for the text. This will be ignored if both gradient colors are the same.
Rainbow Colors	boolean	false	true	Should the notification be shown in Rainbow colors? This overwrites the Gradient setting.
Play Alert Tone	boolean	false	true	Should an alert tone be played? Make sure you have copied the alerts.txt file into the MELODIES folder in Awtrix
Hold Notification	boolean	true	false	Should the notification stay on the display until it's manually dismissed? (Overrides Repeat & Duration)
Repeat	number	-1	5	Sets how many times the text should be scrolled through the matrix before the app ends. If the value is -1, the duration will be taken into account instead.
Duration (in seconds)	number	0	30	Sets how long the app should be displayed. 0 is global app time
Stack	boolean	true	false	Defines if the notification will be stacked. False will immediately replace the current notification.
Scroll	boolean	true	false	Enables text scrolling.
Scroll Speed Percentage	number	100	50	Modifies the scrollspeed. You need to enter a percentage value.
Effect	string	None	Ripple	Shows a background effect. If you only want to show the effect in a notification, then simply do not enter a text in the notification.

2. Awtrix Create Sensor App

With this Blueprint, you can create a sensor App on the clock that is part of the app cycle.

Fields:

Name	Type	Default	Example	Description
Awtrix Displays	dropdown		awtrix_d6b064	Select the target Awtrix displays
Toggle Helper	dropdown		input_boolean.display_power	Select the Toggle Helper that will toggle the notification on or off
Sensor	dropdown		sensor.netto_power	Select the Sensor, Text helper, or Media Player for which you want to show the state on the Ulanzi clock. The app value will change when the value of this sensor changes
Template (Optional)	string		{{ state_attr('media_player.chromecast_audio','media_artist') }} - {{ state_attr('media_player.chromecast_audio','media_title') }}	Enter a template to format your sensor the way you like it. (Advanced mode)
Icon	string		1234	Enter the Icon Name or ID of the icon that you like to show.
Push Icon	dropdown	2	0=Icon doesn't move 1=Icon moves with text and will not appear again 2=Icon moves with text but appears again when the text starts	Icon behavior
Text Case	dropdown	0	0=Use global setting 1=Force Uppercase 2=Show as you entered it	Select how you would like your text to display
Background Color	color_rgb	[0, 0, 0]	[255, 255, 0]	Select the Background color
Text Color	color_rgb	[0, 0, 0]	[255, 255, 0]	Select the Text color
Use Threshold value	boolean	false	true	If set to true, the color of your text will adapt based on whether the value of your sensor is below or above the threshold value.
Threshold Value	number	0	200	Enter a value that can be used as a threshold to switch colors
Low-value Text color	color_rgb	[0, 0, 0]	[255, 255, 0]	Select the color when the value of the sensor is lower than the threshold value
High-value Text color	color_rgb	[0, 0, 0]	[255, 255, 0]	Select the color when the value of the sensor is equal to or higher than the threshold value
Gradient 1	color_rgb	[0, 0, 0]	[255, 255, 0]	Select the first Gradient color if you want to use a gradient color for the text. This will be ignored if both gradient colors are the same.
Gradient 2	color_rgb	[0, 0, 0]	[255, 255, 0]	Select the second Gradient color if you want to use a gradient color for the text. This will be ignored if both gradient colors are the same.
Rainbow Colors	boolean	false	true	Should the text be shown in Rainbow colors? This overwrites the Gradient setting.
Repeat	number	-1	5	Sets how many times the text should be scrolled through the matrix before the app ends. If the value is -1, the duration will be taken into account instead.
Duration (in seconds)	number	0	30	Sets how long the app should be displayed. 0 is global app time.
Lifetime (in seconds)	number	0	30	Sets how long the app should stay alive before it gets removed from the app cycle automatically. 0 is infinite lifetime. This only works if App cycling is enabled
Switch to app on value change	boolean	true	false	Should the clock switch to the app immediately when the value of the sensor changes? BEWARE: Setting this to On for a sensor that changes very frequently might flood your clock with MQTT messages and might cause reboots of the clock!
Scroll	boolean	true	false	Enables text scrolling.
Scroll Speed Percentage	number	100	50	Modifies the scrollspeed. You need to enter a percentage value.
Effect	string	None	Ripple	Shows a background effect.

3. Awtrix Rain Forecast

With this Blueprint, you can create a bar or line chart that shows the rain forecast

Fields:

Name	Type	Default	Example	Description
Awtrix Displays	dropdown		awtrix_d6b064	Select the target Awtrix displays
Toggle Helper	dropdown		input_boolean.display_power	Select the Toggle Helper that will toggle the notification on or off
Sensor	dropdown		sensor.netto_power	Select your Weather Sensor
Graph Type	dropdown	bar	Select bar chart or line chart
Graph Color	color_rgb	[255, 255, 255]	[255, 255, 0]	Select the Graph color
Background Color	color_rgb	[0, 0, 0]	[255, 255, 0]	Select the Background color
Autoscale	boolean	true	false	Enables or disables autoscaling for bar and linechart
Custom Text	string	No rain expected	There will be no rain	Text to show when no rain is expected
Text Case	dropdown	0	0=Use global setting 1=Force Uppercase 2=Show as you entered it	Select how you would like your text to display
Rainbow Colors	boolean	false	true	Should the notification be shown in Rainbow colors?
Duration (in seconds)	number	0	30	Sets how long the app should be displayed. 0 is global app time
Lifetime (in seconds)	number	0	30	Sets how long the app should stay alive before it gets removed from the app cycle automatically. 0 is infinite lifetime. This only works if App cycling is enabled
Switch to app on value change	boolean	true	false	Should the clock switch to the app immediately when the value of the sensor changes?

4. Awtrix Set Transition Time

With this Blueprint, you can set the global time that each app is visible in seconds.

Fields:

Name	Type	Default	Example	Description
Awtrix Displays	dropdown		awtrix_d6b064	Select the target Awtrix displays
App Time Number Helper	dropdown		input_number.app_time	Select the App Time Number Helper that stores the App time. The number helper should be set in seconds.

5. Awtrix Toggle Stock App

With this Blueprint, you can toggle the stock apps Time, Clock, Temperature, Humidity, Battery. Eyes

Fields:

Name	Type	Default	Example	Description
Awtrix Displays	dropdown		awtrix_d6b064	Select the target Awtrix displays
Toggle Helper	dropdown		input_boolean.display_battery	Select the Toggle Helper that will toggle the App on or off
Sensor	radiobutton		Battery	Select the stock app that you'd like to toggle

6. Toggle Indicators

With this Blueprint, you can set up the two indicators to indicate a certain event.

Fields:

Name	Type	Default	Example	Description
Awtrix Displays	dropdown		awtrix_d6b064	Select the target Awtrix displays
Right Top Indicator Toggle Helper	dropdown		input_boolean.indicator_1	Select the Toggle Helper that will toggle the right top indicator
Right Top Indicator color	color_rgb	[255, 255, 255]	[255, 255, 0]	Select the Right Top Indicator color
Blink Speed Top Indicator	number	0	1000	Select the blink speed in milliseconds. (0 = no blinking)
Right Bottom Indicator Toggle Helper	dropdown		input_boolean.indicator_1	Select the Toggle Helper that will toggle the right bottom indicator
Right Bottom Indicator color	color_rgb	[255, 255, 255]	[255, 255, 0]	Select the Right Bottom Indicator color
Blink Speed Bottom Indicator	number	0	1000	Select the blink speed in milliseconds. (0 = no blinking)

7. Awtrix Weather App

With this Blueprint, you can set up the weather app

Fields:

Name	Type	Default	Example	Description
Awtrix Displays	dropdown		awtrix_d6b064	Select the target Awtrix displays
Toggle Helper	dropdown		input_boolean.display_power	Select the Toggle Helper that will toggle the notification on or off
Sensor	dropdown		weather.openweathermap	Select your Weather Sensor
Show Weather Text	boolean	true	false	Should the weather condition be shown as text?
Language	dropdown	English	Dutch	Show the weather condition in this language
Show temperature	boolean	true	false	Should the temperature be shown?
Show windspeed	boolean	true	false	Should the windspeed be shown?
Show Humidity	boolean	true	false	Should the humidity be shown?
Push Icon	dropdown	2	0=Icon doesn't move 1=Icon moves with text and will not appear again 2=Icon moves with text but appears again when the text starts	Icon behavior
Text Case	dropdown	0	0=Use global setting 1=Force Uppercase 2=Show as you entered it	Select how you would like your text to display
Background Color	color_rgb	[0, 0, 0]	[255, 255, 0]	Select the Background color
Text Color	color_rgb	[0, 0, 0]	[255, 255, 0]	Select the Text color
Rainbow Colors	boolean	false	true	Should the notification be shown in Rainbow colors?
Repeat	number	-1	5	Sets how many times the text should be scrolled through the matrix before the app ends. If the value is -1, the duration will be taken into account instead.
Duration (in seconds)	number	0	30	Sets how long the app should be displayed. 0 is global app time
Lifetime (in seconds)	number	0	30	Sets how long the app should stay alive before it gets removed from the app cycle automatically. 0 is infinite lifetime. This only works if App cycling is enabled
Switch to app on value change	boolean	true	false	Should the clock switch to the app immediately when the value of the sensor changes?
Scroll	boolean	true	false	Enables text scrolling.
Scroll Speed Percentage	number	100	50	Modifies the scrollspeed. You need to enter a percentage value.
Effect	string	None	Ripple	Shows a background effect.

8. Awtrix Moodlight

With this Blueprint, you can turn your Awtrix clock into a moodlight

Fields:

Name	Type	Default	Example	Description
Awtrix Displays	dropdown		awtrix_d6b064	Select the target Awtrix displays
Toggle Helper	dropdown		input_boolean.display_power	Select the Toggle Helper that will toggle the moodlight on or off
Brightness	number	100	200	WARNING: This function causes much higher current draw and heat, because every pixel is lit. Keep the brightness value low (between 0 and 200). The clock may turn off if the brightness level is too high when running on battery power!
Color	color_rgb	[255, 255, 255]	[255, 255, 0]	Select the Moodlight color
Kelvin value	number	0	4000	Enter a Kelvin value. Typically choose a value between 1000 and 10000. A value of 0 disables Kelvin. Kelvin overwrites the color.

9. Awtrix List Calendar

With this Blueprint, you can create a calendar App on the clock that is part of the app cycle. It shows the calendar events for the next 24 hours of a chosen calendar

Fields:

Name	Type	Default	Example	Description
Awtrix Displays	dropdown		awtrix_d6b064	Select the target Awtrix displays
Toggle Helper	dropdown		input_boolean.display_power	Select the Toggle Helper that will toggle the notification on or off
Calendar	dropdown		yourname@gmail.com	Select the calendar for which you want to show the items on the Ulanzi clock. The app value will change when the value of this sensor changes
Hours ahead	number	24	8	How many hours in advance should agenda items be shown? (default 24).
Show Timeline	boolean	true	false	Do you want to cycle the whole timeline for the upcoming hours?
Show Whole Day Events	boolean	true	false	Do you want to show events that last the whole day?
Show Alerts	boolean	true	false	Do you want to show an alert when the calendar event starts
Play Alert Tone	boolean	false	true	Should an alert tone be played 15 minutes before the event starts?
Stack	boolean	true	false	Defines if the notification will be stacked. False will immediately replace the current notification.
Icon	string		1234	Enter the Icon Name or ID of the icon that you like to show.
Push Icon	dropdown	2	0=Icon doesn't move 1=Icon moves with text and will not appear again 2=Icon moves with text but appears again when the text starts	Icon behavior
Custom Text	string	Yay! You have no appointments!	No events	Text to show when there are no upcoming calendar events
Show Empty Calendar	boolean	true	false	Show the custom text when there are no events. If set to false, the calendar will not show when there are no events after the lifetime has ended. This might take a minute or two to take effect.
Prefix	string		Ed's Calendar:	Enter an optional prefix text. For instance, show the Calendar name if you use multiple calendars in front of the list of events.
Today Text	string		Text to show for events that occur today.
Tomorrow Text	string		Text to show for events that occur tomorrow.
Text Case	dropdown	0	0=Use global setting 1=Force Uppercase 2=Show as you entered it	Select how you would like your text to display
Background Color	color_rgb	[0, 0, 0]	[255, 255, 0]	Select the Background color
Text Color	color_rgb	[0, 0, 0]	[255, 255, 0]	Select the Text color
Rainbow Colors	boolean	false	true	Should the notification be shown in Rainbow colors?
Repeat	number	-1	5	Sets how many times the text should be scrolled through the matrix before the app ends. If the value is -1, the duration will be taken into account instead.
Duration (in seconds)	number	0	30	Sets how long the app should be displayed. 0 is global app time
Lifetime (in seconds)	number	0	30	Sets how long the app should stay alive before it gets removed from the app cycle automatically. 0 is infinite lifetime. This only works if App cycling is enabled
Switch to app on value change	boolean	true	false	Should the clock switch to the app immediately when the value of the sensor changes? BEWARE: Setting this to On for a sensor that changes very frequently might flood your clock with MQTT messages and might cause reboots of the clock!
Scroll	boolean	true	false	Enables text scrolling.
Scroll Speed Percentage	number	100	50	Modifies the scrollspeed. You need to enter a percentage value.
Effect	string	None	Ripple	Shows a background effect.

FAQ

What's the password for the Access Point when the clock is in AP Mode?

The AP Mode password is: 12345678

I cannot see my clock in Home Assistant

Flash your clock again and make sure you tick the "erase" checkbox. This should hard reset the clock. If this didn't work, then go to Blueforcer's Discord server to ask for support about this issue.

My display does not show notifications or apps as soon as I trigger them

Make sure the MQTT prefix in Awtrix 3 is exactly the same as the name of the device in Home Assistant. Don't use spaces in the name.

Will my existing automations still work after I've updated the Blueprints to a new version?

Yes

Will the display update as soon as a sensor value updates?

If you enable the "Switch to app on value change" option, changes will take effect immediately. Conversely, if the option is disabled, the updated value will be displayed when the app appears in the cycle.

How can I toggle a notification when a sensor value changes? For instance when a door sensor gets opened?

Set the toggle helper for your Awtrix notification to "on" in the automation that detects if the door gets opened. This way, the Awtrix notification automation that you've created will also be triggered. I call this technique "daisy-chaining" of automations and explain this in this video: https://youtu.be/sNmonuw4EHo

How can I automatically turn off a notification toggle helper, so that I can turn it on again after a while?

When you've set the notification to turn off after a delay time in the blueprint, the toggle helper will not turn off automatically because Home Assistant cannot see the status of the notification. So, if you use a notification in an automation, you have to switch off the toggle helper after a duration in the automation that triggers that toggle helper to on. Alternatively, you can use the sensor app blueprint instead. You can enter a custom message in the template field so that it behaves a lot like the notification app.

How many custom apps can I run simultaneously on this clock?

You can run up to 20 custom apps simultaneously.

I only see one app on the clock, even when I configured more than one. How can I fix this?

You probably entered a high number for the transition time. This time is in seconds nowadays. In the past, it was in milliseconds.

The icons are not showing on the display.

Upload the icons to your clock first using the Awtrix interface. Go to your Ulanzi URL, Icons tab, fill in the icon ID, and click on Preview to check it. Use the download button to upload the icon to the Ulanzi clock.

How can I show the Artist and Song every time a new song starts playing?

Follow these steps:

1. Create an automation with the Awtrix Create Sensor App Blueprint.
2. Select a toggle helper that you've created for the Awtrix media player app.
3. Select the Media Player as the Sensor.
4. Add code to the template field to show the artist and title. For example: {{ state_attr('media_player.chromecast_audio','media_artist') }} - {{ state_attr('media_player.chromecast_audio','media_title') }}
5. Set the lifetime to 5 minutes
6. Make sure the toggle helper is set to on.

How can I disable the stock apps so that they do not reappear after a reboot of the clock?

You can turn them off on the device itself. Long press the middle button to get into the menu and disable them one by one in the menu-option APPS.

How can I change the order of the apps?

The apps show in the order that you activate them.

How can I download an updated version of the Blueprints for free?

• If you've ordered the Blueprints before, log in to Ko-Fi and go to the menu.
• Select "Payments History" and go to your previous payment.
• You can download the new version by clicking on "View Details > View Content > Download".
• Or, open the e-mail that you got at the time of the purchase and click the link in the e-mail to download the latest version.

Where can I ask questions or report a bug?

Join my Discord server to ask questions in the Ulanzi-display channel: https://discord.gg/pP53uDEgUw

My Ulanzi clock dies after a couple of hours. What can I do to fix this?

Unfortunately, there has been a bad hardware batch released by Ulanzi. They pinpointed the issue and fixed it in new batches. Contact your seller and/or Ulanzi and they will send you a new device. Be sure not to tell you've flashed the device, although Ulanzi promotes flashing it on their website.

The colors on the clock do not look the same as the colors that I've selected in the Blueprint

The colors on the clock are determined by the color code and the brightness setting of the clock. The clock has a color correction function to correct the colors. Mostly bright colors work best. "In-between" colors might not work well.

The update button in Home Assistant does not work. How can I update the firmware?

There are two ways:

1. Long press the middle button on the clock to access the clock menu on the clock itself. You can navigate to the update menu item using the left and right buttons on the clock. Short press the middle button on the clock to enter the menu item of your choice.
2. Download the iPhone or Android App for Awtrix 3 and update your clock using that app.

How can I change the Language of the Weather Forecast Blueprint?

You can create a template sensor that translates the names of the weather states and use that template sensor in the Custom App blueprint.

How can I show a different icon based on the value of a sensor?

You can add template code in the icon field like this:

{% if states('sensor.yoursensor') | int < 0 %}55738{% else %}55742{% endif %}

Replace the entity with your own and replace the icon numbers with the icon numbers of your choice.

How do I make sure that my calendar is not shown when there are no events scheduled for the upcoming hours?

1. Set the Show Empty Calendar option to off.
2. Set the Lifetime (in seconds) option to a number higher than 60. For instance: 120.

Release Notes

V2.14

• Updated all Blueprints to make them compatible with Home Assistant 2024.10 and higher. This is a backward incompatible change. This version will not work with lower versions of Home Assistant!

V2.13

• Added text gradient options to the Notification and Sensor Blueprints
• Added sections for Text and Advanced options to the Notification and Sensor Blueprints.

V2.12

• Added correct Polish translations

V2.11

• Added some code to suppress messages in the log files.

V2.10

• Fixed a bug that in some cases apps couldn't be closed using an automation.

V2.09

• Rolled back the interval option because it causes issues.

V2.08

• Added Danish language for the Weather Blueprint
• Fixed a "bug" that showed a warning message in the log files when a sensor was still running.

V2.07

• Added compatibility for Awtrix 3
• Added an interval option for the sensor app to prevent flooding of your MQTT broker
• Added a text file that contains the version number

V2.06

• Optimized code for the Calendar app
• Re-introduced the possibility to show or disable Whole Day events
• Fixed Spanish translation in the Weather app.

V2.05

• Implemented an option to hide the calendar when there are no events scheduled for the upcoming hours specified in the "hours ahead" option.

V2.04

• Fixed a bug in the event notification

V2.03

• Optional Today and Tomorrow options are now also working correctly after a refresh of the app on the clock.

V2.02

• Today and Tomorrow options are now optional for the list calendar app

V2.01

• New functionalities and bug fixes in the list calendar app:
  • Added the option to enter a prefix for your calendar. If you use multiple calendars, you can now show for what calendar the events are shown.
  • Added the option to enter a Today and Tomorrow text. A personalized message labeled "Today" precedes the schedule of events for the current day, while a corresponding message labeled "Tomorrow" precedes the list of events for the following day.
  • Fixed a bug where finished events were still shown after the event ended.

V2.0

• Major update! This is something that a lot of you were eagerly anticipating: Multi-language support for the Weather App. It currently supports, English, Dutch, French, German, Polish, Portuguese, and Spanish

V1.82

• Made Blueprints for Weather Forecast and Calendar compatible with Home Assistant 2023.12. Only use V1.82 if you have Home Assistant 2023.12 or higher installed!

V1.81

• Fixed bug where custom text was not shown if no calendar events were present.
• Added snowy-rainy.gif for the weather app. Make sure you upload it to your ICONS folder on your clock(s).

V1.80

• Added the option to show a custom text when there are no upcoming calendar events.
• Full-day appointments now do not show the time "00:00" anymore.

V1.79

• Bugfix in the sensor app blueprint that fixes an issue that occurs in some cases when users make use of a custom template.

V1.78

• Added a fix so that the threshold value works regardless if your template value contains a string.

V1.77

• Added a Threshold option to the Sensor App Blueprint, so that you can change the color of the sensor value if it's below or above a certain threshold value.

V1.76

• Made Rain Forecast Blueprint backward compatible to support custom weather integrations

V1.75

• Bugfixes in the Rain Forecast Blueprint

V1.74

• The Rain Forecast Blueprint is now compatible with Home Assistant 2023.9 and up. This now makes use of the new weather.get_forecast service instead of the forecast attribute.
• BREAKING CHANGE: Make sure you run Home Assistant 2023.9 or higher to use the updated Rain Forecast Blueprint. It won't work with a Home Assistant version before 2023.9.

V1.73:

• Blueprints are now compatible with Awtrix 3 V0.84. Make sure you read the release notes of Awtrix 3 0.84 before you install these blueprints.
• You HAVE TO open each native/stock app automation and select the stock apps (time, date, humidity, temperature, battery) again in your automation and save the automation to make enabling and disabling of stock automations work for this version.
• Fixed a bug in the rain forecast blueprint.

V1.72:

• Huge improvements on the Calendar Blueprint:
  • Added the possibility to enable or disable showing the complete timeline.
  • Added the possibility to get a notification alert on your clock 15 minutes before an event starts.
  • Added the possibility to enable or disable whole-day events.
  • Added the possibility to enable or disable the alert tone for an event warning.
• Fixed a bug in the weather forecast Blueprint. Message when no rain is expected will not be shown on top of the graph anymore.

V1.71:

• Fixed refresh bug in calendar Blueprint. Now retrieves new data every 15 minutes.

v1.70:

• Weather Blueprint: added the option to show humidity
• Weather Blueprint: added the option to hide the weather condition text so that you only see the icon with conditions
• Calendar Blueprint: added the option that you can enter how many hours in advance the agenda items should be shown
• Calendar Blueprint: delimiter will not be shown after the last calendar item anymore
• Calendar Blueprint optimization: value will only change when the calendar items change

V1.69:

• Added the HorizontalLine effect
• Added a new Blueprint: Awtrix List Calendar that shows the calendar events for your chosen calendar for the next 24 hours.

V1.68:

• Added the effects option to show a background effect on Notifications and Apps. If you only want to show the effect in a notification, then simply do not enter a text in the notification.
• Bugfixes

V1.67:

• Removed the possibility to select the eyes app because it's removed from Awtrix 3 V0.71

V1.66:

• You can now choose MULTIPLE clocks
• BREAKING CHANGE: You need to edit all your existing automations that are based on these blueprints and select the clocks for each automation.

V1.65:

• Added the Repeat option for Custom Apps and Notifications
• Added the Scroll option for Custom Apps and Notifications
• Added the Scroll Speed option for Custom Apps and Notifications

V1.64:

• Added the possibility to select an input text helper as a sensor for the Sensor App Blueprint. It's now possible to trigger the automation based on a Text Helper value as well.

V1.63:

• Added stack option to notrifications. Defines if the notification will be stacked. "Off" will immediately replace the current notification. Compatible with Awtrix 3 v0.66 and above.

V1.62:

• Now three indicators are supported in the Indicators Blueprint. Note: the Indicators blueprint assumes that you created three toggle helpers: input_boolean.awtrix_display_indicator_1, input_boolean.awtrix_display_indicator_2, and input_boolean.awtrix_display_indicator_3. This is needed to make sure your already created automations that use the Indicators Blueprint will not break. You don't need to create these helpers and can still use any toggle helper you like. Compatible with Awtrix 3 v0.63 and above.

V1.61:

• The new stock App Eyes can now be enabled and disabled using the Toggle Stock App Blueprint

V1.60:

• Added a blink speed number selector for the indicators in the indicator blueprint. Supports Awtrix firmware 0.62 or higher.

V1.59:

• Added a new Blueprint to convert your Awtrix Clock into a moodlight. Awtrix 3 Firmware 0.61 or higher is needed for this to work.

V1.58:

• If you have multiple clocks in your house, you can target a specific clock in the notification Blueprint, so that the middle button for that specific clock will dismiss the notifcation when pressed. This fix is created to prevent tools as Watchman to report errors for non used entity ids.
• BREAKING CHANGE: If you already had multiple clocks in your house, the middle button of the extra clocks will not work automatically anymore. You have to go through all the notification automations for each extra clock to select that specific clock to make it work again.

V1.57:

• Added a toggle to the Indicators Blueprint to toggle an alert sound on and off. Make sure you've uploaded the alert.txt file to the MELODIES folder to make this work.

V1.56:

• Re-added the Lifetime option. This option resulted in errors in older Awtrix firmware. Make sure you have at least Awtrix 3 firmware version 0.58 installed to let this work properly.
• Up to 3 Ulanzi displays now support the middle button to dismiss a notification for you people with multiple clocks in your home.
• Streamlined some code to make it future-proof.

V1.55:

• The middle button of the Ulanzi clock now dismisses a notification and sets the corresponding toggle helper to Off. NOTE: This uses the default entity ID for the middle button of the Ulanzi clock which is binary_sensor.button_select. If you renamed this entity ID, this function will not work!

V1.54:

• Removed the lifetime setting from the Blueprints. This setting causes the device to reboot every now and then.

V1.53:

• Added the option to toggle if the clock should switch to the app immediately when the value of the sensor changes.

V1.52:

• Fixed bug in Forecast Blueprint that pointed hardcoded to OpenWeatherMap.

V1.51:

• An alert tone can now be played when a notification is triggered. Make sure you copy the provided alert.txt file into the MELODIES folder of Awtrix 3 to make this work.

V1.50:

• Added the possibility to select media players in the Awtrix Create Sensor App. It's now possible to show the artist and song on the clock when a new song starts playing on the selected media player.
• Added a Template field. You can now format your sensors so that they look exactly like you want them to look!

V1.43:

• Renaming the prefix in Awtrix 3 and in Home Assistant to the same name will not break the apps anymore.

V1.42:

• Added option to select a background color for notifications and custom apps.
• Fixed rain forecast bug that in some cases did not show a graph.

V1.41:

• Fixed new App Time setting so that it matches the new API variable.

V1.4:

• Added Blueprint for the Rain Forecast Graph. It will show a bar chart or line chart for the Rain Forecast. If no rain is expected in the next couple of hours it will show a custom message instead.

V1.3:

• Added app lifetime option to sensor app and weather app Blueprints. This removes the custom app when there is no update after the given time in seconds.

V1.2:

• Some textual changes in the indicator blueprint.

V1.1:

• It's now possible to select to show temperature and windspeed optionally in Weather app. After uploading the new weather blueprint, go to Developer Tools > YAML and refresh the automations.
• Added new Blueprint to toggle indicators.