Weather

Weather for AWTRIX NG (Ulanzi TC002)

Version 6.1 · by Hank_the_Tank / Claude · for the 52×16 panel of the Ulanzi TC002

Current weather, humidity, moon phase and an hourly temperature forecast on a single screen. The weather data comes from Open-Meteo, so you don't need an API key or an account.

┌────────┬──────────────────────────────────────────┐
│weather │        24°      58%                      │  ← big temperature + humidity
│ symbol │                                          │
├────────┤  ·            ·                          │  ← noon / midnight ticks
│  moon  │ ▁▁▂▃▄▅▅▆▆▇▇█▇▆▅▄▃▃▂▂▁▁                   │  ← forecast area, "now" lit up
│ phase  │                                          │
└────────┴──────────────────────────────────────────┘

Features

• Big temperature and humidity side by side. Both use 6×10 px block digits. The temperature is coloured on a scale that runs from violet (frost) through green and yellow to red (heat).
  • If a pair like -12° / 100% doesn't fit, the digits switch to a narrow 5 px form. If that still doesn't fit, the % sign is dropped.
  • Humidity can also alternate with the temperature every 4 s, or be hidden.
• Forecast area. A filled temperature curve with a bright edge and a dimmed fill, coloured by temperature.
  • today: 0–24 h of the current day. A white-topped column marks now and moves across the day.
  • next24: the coming 24 hours from the current hour.
  • auto (default): today until 18:00, then next24, so in the evening you can see the coming night.
  • The area always spans the shown hours' own min/max, so the 5 rows are fully used.
  • Small ticks mark noon and midnight (midnight in the next24 view only).
• Animated weather symbols, drawn in code. No icons to install. Twelve symbols, all moving:
  • a round sun with a glint travelling around its edge
  • a crescent with twinkling stars and the odd shooting star at night
  • drifting clouds, a sun peeking out for partly cloudy and showers
  • drifting fog bands, falling drizzle, rain, hail and swaying snowflakes
  • a dark thunder cloud with a double lightning flash every 3 s
  • wind gusts blowing through
• Which symbol. It follows the WMO weather code, plus three extra rules:
  • For dry weather the actual cloud cover (%) picks clear, partly cloudy or cloudy, because the WMO codes 1–3 are coarse. By day, the cloudy symbol is only shown when the sun is not actually shining (Open-Meteo sunshine duration), so thin or high clouds with sunshine show partly cloudy.
  • The clear-night symbol after sunset (there is no partly-cloudy night symbol).
  • The windy symbol on dry days once the wind reaches a set speed.
• Moon of the day. The exact phase for today is calculated on the device and drawn with a smooth edge, so the crescent grows and shrinks a little every day. No extra request is needed.
• Starts with data. After a reboot the last known values show at once, instead of an empty panel.
• Stale-data warning. A red dot under the moon means no successful update for more than 25 minutes.
• Refresh. Every 15 minutes. Press the middle button while the app is on screen to refresh right away.

Requirements

• An Ulanzi TC002 running AWTRIX NG (tested on firmware 1.1.7).
• A 52×16 display. The layout is written for it and is not meant for 32×8 clocks.
• No icons. All symbols are drawn by the script.

Installation

1. Open the AWTRIX web interface in a browser, using the clock's IP address or http://awtrixng-xxxxxx.local.
2. Go to the Scripts tab and create a new script called Weather.
3. Paste the contents of Weather_share.ax and press Save.
4. Open the Apps tab, click the gear on the Weather row and enter your own latitude and longitude.

The app joins the rotation right away. If the panel shows a red ERR:, the error message is shown next to the script in the Scripts tab. Please include it in your feedback.

Settings

All settings are on the Apps tab, behind the gear on the Weather row. Saving restarts the app.

Symbols

All symbols are 8×8 and animated. The weather symbol sits top left, the moon below it.

Feedback

This is a test release. Useful feedback:

• Something looks wrong: a photo of the panel, plus your location, the time and the weather at that moment.
• The panel shows ERR:: the error text from the Scripts tab.
• A condition shows the wrong symbol: the weather you actually had outside.

Credits

• Weather data: Open-Meteo (CC BY 4.0).
• Firmware: AWTRIX NG by Blueforcer.

Changelog

• 6.1 – Cleaner digit 1: a short flag and a full-width stem without a foot, only as wide as it needs to be. Values with a 1 no longer drop to the narrow digit form as early.
• 6.0 – Weather and moon symbols are now drawn and animated by the script; no Hub icons needed any more. The moon shows the exact phase of the day with a smooth, round edge.
• 5.9 – Previous release with AWTRIX Hub icons.