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.
- Installs
- 556
- Last 24h
- —
- Trending rank
- —
- Security
- Not audited
Install
Works with every agent the skills CLI supports.
npx skills add https://github.com/bradsjm/hassio-addons --skill home-assistant-awtrix- 01
Install
Run the command in your project. The CLI asks which agents to install for.
- 02
Describe the task
Ask your agent for something this skill covers. It loads home-assistant-awtrix automatically when relevant.
- 03
Review the result
The agent follows the SKILL.md steps, scripts and references bundled with the skill.
SKILL.md
The instructions your agent reads when the skill is triggered.
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
FAQ
What does the home-assistant-awtrix skill do?
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 home-assistant-awtrix?
Run npx skills add https://github.com/bradsjm/hassio-addons --skill home-assistant-awtrix in your project. The skills CLI detects the agents you use and copies the skill into the right folder. For Claude Code you can also place the skill folder at ~/.claude/skills/home-assistant-awtrix/ (personal) or .claude/skills/home-assistant-awtrix/ (project).
Which AI agents can use home-assistant-awtrix?
Any agent that supports the open Agent Skills format (a folder with a SKILL.md file), including Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf, Cline, OpenCode and more.
Is home-assistant-awtrix safe to install?
No partner security audit is available yet. Skills can run commands and scripts, so read the SKILL.md and any bundled files before installing.
Who maintains home-assistant-awtrix?
It is published by bradsjm in bradsjm/hassio-addons. It has 556 recorded installs.
More from bradsjm/hassio-addons
home-assistant-automation-scripts
bradsjm/hassio-addons
Home Assistant automations, scripts, and blueprints. Use when the user requests automation/script syntax, triggers/conditions/actions, blueprint usage, run modes, or troubleshooting, and when mapping those needs to ha-mcp automation/script tools.
home-assistant-dashboards-cards
bradsjm/hassio-addons
Home Assistant Lovelace dashboards and cards. Use when the user asks about dashboard structure, views/sections, card types, resources, or HACS cards, and when mapping those needs to ha-mcp dashboard tools.
home-assistant-entities-services
bradsjm/hassio-addons
Home Assistant entity discovery, states, helpers, labels, groups, and services. Use when the user asks about entities or services, needs to rename/move/hide/label entities, or requires service calls via ha-mcp tools.
home-assistant-esphome
bradsjm/hassio-addons
ESPHome + Home Assistant workflows for provisioning, adoption, entity naming, encryption keys (noisepsk / api encryption), OTA updates, and troubleshooting offline devices. Use when working with ESPHome Device Builder, the HA ESPHome integration, or when generating ESPHome YAML and validating entities in HA.
home-assistant-integrations-addons
bradsjm/hassio-addons
Home Assistant integrations, add-ons, updates, and system operations. Use when the user asks about config entries, add-ons, updates, reloads/restarts, or system health, and when mapping those needs to ha-mcp tools.
home-assistant-custom-integration
bradsjm/hassio-addons
Example scaffolding and checklists for developing Home Assistant custom integrations. Use when building or reviewing a custom integration based on the included example templates.
Popular other skills
hyperframes-cli
heygen-com/hyperframes
The HyperFrames CLI by job - scaffold, check, look at frames, edit the timeline, preview, render locally or in the cloud, publish, project history - plus reading its JSON and recovering from build or render failures.
triage
mattpocock/skills
Move issues and external PRs through a state machine of triage roles, categorise, verify, grill if needed, and write agent-ready briefs.
ask-matt
mattpocock/skills
Ask which skill or flow fits your situation. A router over the skills in this repo.
to-questionnaire
mattpocock/skills
Turn a decision you can't fully answer into a questionnaire for someone else to fill in.
loop-me
mattpocock/skills
Grill me about specs for the workflows I want to build, within this workspace.