Moon phases

AWTRIX NG Moon Phase (TC002) – Quick Guide

The blueprint awtrix_ng_moon_phase_tc002.yaml shows the moon phase icon on the left and the phase name on the right (two lines). It finds the icon by name, so the icons must exist on the clock with exactly the right names.

1. Icon names the blueprint expects

The icon ID is <prefix><phase>. With an empty prefix (default) the clock needs these eight icons:

Rules (from the AWTRIX NG docs): the icon ID is the file name without extension, it is case-sensitive, and GIF is recommended (PNG/JPG are converted to GIF on upload). If one icon is missing, AWTRIX NG refuses the whole update and nothing is shown.

With a prefix such as moon_, the names become moon_new_moon, moon_full_moon, etc. Set the same prefix in the blueprint's "Icon name prefix" field.

2. Get the icons onto the TC002

1. Open https://awtrix.de/icons?size=16x16 and use Search icons to find moon phase icons (16×16 fits the 16×16 icon box in the layout; the Hub only hosts GIFs up to 52×16).
2. Open an icon and press Send to AWTRIX (needs a Hub sign-in and your connection key). Your browser copies the icon to the clock over your local network.
   Alternative: download the GIF, then in the clock's web UI go to Icons → Add and drop the file.

Note: Hub icons get a lowercase, hyphenated ID such as moon-new. The blueprint needs underscores and the names above, so renaming is normally required.

3. Rename the icons

Option A – on the clock (web UI):

1. Open the clock's web UI → Icons.
2. Open the ⋯ menu on the icon → Rename.
3. Enter the exact name from the table above (e.g. new_moon) and save.

Option B – before uploading: rename the downloaded file on your PC (new_moon.gif), then upload it via Icons → Add.

4. Set up the blueprint

1. Import awtrix_ng_moon_phase_tc002.yaml and create an automation.
2. Select your display(s) under AWTRIX Displays, or enter your MQTT topic prefix (e.g. Ulanzi) under Extra MQTT prefixes.
3. Select your moon sensor (sensor.moon, from the built-in Moon integration).
4. Choose a Language (Dutch, English, German) or Custom and fill in your own texts.
5. Set Icon name prefix only if you used one in step 3.

5. Troubleshooting

• Nothing shows on the clock: check the icon names (typos, capitals, extension) in Icons, and look at the Log tab in the web UI for a refused update.
• Text but no icon: the icon name doesn't match, or "Show icon" is off.
• Text in the wrong language: with Custom, an empty field falls back to English.