AWTRIX

Workflow

• Use the bundled awtrix_fs.py script for deterministic filesystem operations and LaMetric icon imports.

• Use absolute device paths (leading / ) to avoid firmware path errors.

• Use references for endpoint behavior and MQTT/HA integration patterns.

Quick start

All script and reference files are relative to the location of this SKILL.md file.

python3 scripts/awtrix_fs.py --host <ip> status python3 scripts/awtrix_fs.py --host <ip> icons list python3 scripts/awtrix_fs.py --host <ip> icons import-lametric <id>

Tasks

Import a LaMetric icon by ID

• Run: python3 scripts/awtrix_fs.py --host <ip> icons import-lametric <id>

• Read: references/AWTRIX_HTTP_FILESYSTEM.md for endpoint details

List icons on the device

• Run: python3 ~/.codex/skills/home-assistant-awtrix/scripts/awtrix_fs.py --host <ip> icons list

Upload / rename / delete files

• Upload local file: ... upload ./local.jpg /ICONS/9999.jpg

• Rename: ... rename /ICONS/old.gif /ICONS/new.gif

• Delete: ... delete /ICONS/bad.gif

Delete ALL icons safely (avoid 404 loop bug)

When deleting many files returned by icons list , avoid command substitution loops that collapse whitespace. Use a line-safe loop so each filename is deleted individually:

python3 scripts/awtrix_fs.py --host <ip> icons list
| awk '{print $3}'
| while IFS= read -r f; do python3 scripts/awtrix_fs.py --host <ip> delete "/ICONS/$f" done

References

• HTTP endpoints, filesystem API, and LaMetric import details: references/AWTRIX_HTTP_FILESYSTEM.md

• MQTT/HA control patterns (custom apps, notify, settings): references/AWTRIX.md

• Upstream MQTT API reference: references/upstream-api.md