How do I install the Home Assistant Awtrix skill?

Run npx skillmds@latest add tomevault-io/home-assistant-awtrix in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Home Assistant Awtrix safe to use?

This skill has not completed SkillMD's automated safety review yet. Independent scanners report: SkillSpector: CAUTION, Skill Scanner: PASS. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Home Assistant Awtrix?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Home Assistant Awtrix free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Home Assistant Awtrix?

tomevault-io (@tomevault-io) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Home Assistant Awtrix by tomevault-io

Name: Home Assistant Awtrix
Author: tomevault-io

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. Use when this capability is needed.

tomevault-io Updated Sep 17, 2026

File contents

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

Converted and distributed by TomeVault — claim your Tome and manage your conversions.

---name: home-assistant-awtrixdescription: 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. Use when this capability is needed.---# 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 startAll script and reference files are relative to the location of this SKILL.md file.```bashpython3 scripts/awtrix_fs.py --host <ip> statuspython3 scripts/awtrix_fs.py --host <ip> icons listpython3 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:```bashpython3 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`---> Converted and distributed by [TomeVault](https://tomevault.io/claim/bradsjm) — claim your Tome and manage your conversions.

Frequently asked questions