skills/bradsjm/hassio-addons/home-assistant-awtrix

home-assistant-awtrix

SKILL.md

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
Weekly Installs
120
GitHub Stars
38
First Seen
Feb 3, 2026
Installed on
opencode120
gemini-cli8
cursor8
codebuddy8
github-copilot8
codex8