home-assistant-awtrix
Manage AWTRIX 3 devices via HTTP filesystem and utility endpoints. Use when listing/uploading/renaming/deleting files, checking flash usage, configuring Wi-Fi, controlling LiveView, or importing LaMetric icons.
How do I install this agent skill?
npx skills add https://github.com/bradsjm/hassio-addons --skill home-assistant-awtrixIs this agent skill safe to install?
- Gen Agent Trust Hubwarn
The skill manages AWTRIX devices via HTTP and includes functionality to dynamically install Python dependencies (Pillow) at runtime. It also suggests shell command patterns for bulk file operations that are potentially vulnerable to indirect prompt injection if device filenames are malicious.
- Socketpass
No alerts
- Snykpass
Risk: LOW · No issues
- Runlayerwarn
5/5 files flagged
- ZeroLeakspass
Score: 93/100 · 2 sections analyzed
What does this agent skill do?
AWTRIX
Workflow
- Use the bundled
awtrix_fs.pyscript 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.mdfor 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
How can the creator link this skill?
Add the canonical catalog link to the repository README so users can inspect current installs and available audits. The publishing guide covers the complete discovery path.
<a href="https://skillzs.dev/skills/bradsjm/hassio-addons/home-assistant-awtrix">View home-assistant-awtrix on skillZs</a>