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
icons import-lametric 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 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