mcpField
H
home-assistant-awtrix

home-assistant-awtrix

github.com/bradsjmその他46556 回インストール16 週間前に更新
リポジトリ

home-assistant-awtrix について

AWTRIX デバイスのファイルやアイコンを管理するスキルです。Python スクリプトに加え、HTTP エンドポイントや MQTT/Home Assistant の制御パターンを参照できます。

主な機能

  1. 01決定的なファイルシステム操作
  2. 02ファイルの一覧・アップロード・改名・削除
  3. 03LaMetric アイコンのインポート
  4. 04AWTRIX HTTP ファイルシステム資料
  5. 05MQTT と Home Assistant の制御ガイド

活用シーン

  1. 01デバイス状態の確認
  2. 02デバイスアイコンの管理
  3. 03LaMetric アイコンのインポート
  4. 04MQTT/Home Assistant 制御パターンの適用

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/bradsjm/hassio-addons --skill home-assistant-awtrix

インストール後、Claude Code で/home-assistant-awtrixを入力して読み込まれたか確認します。

同梱ファイル

SKILL.md と一緒にインストールされる参考資料やスクリプト。

references/
AWTRIX_HTTP_FILESYSTEM.md
AWTRIX.md
upstream-api.md
scripts/
awtrix_fs.py

詳細

AWTRIX

ワークフロー

  • 決定的なファイルシステム操作と LaMetric アイコンのインポートには、付属の awtrix_fs.py スクリプトを使用します。
  • ファームウェアのパスエラーを避けるため、デバイスの絶対パス（先頭が /）を使用します。
  • エンドポイントの動作と MQTT/HA の統合パターンについては、参考資料を参照します。

クイックスタート

すべてのスクリプトと参考資料のファイルは、この SKILL.md ファイルの場所からの相対パスです。

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>

タスク

ID で LaMetric アイコンをインポートする
  • 実行：python3 scripts/awtrix_fs.py --host <ip> icons import-lametric <id>
  • 読む：エンドポイントの詳細については references/AWTRIX_HTTP_FILESYSTEM.md を参照します。
デバイス上のアイコンを一覧表示する
  • 実行：python3 ~/.codex/skills/home-assistant-awtrix/scripts/awtrix_fs.py --host <ip> icons list
ファイルをアップロード／名前変更／削除する
  • ローカルファイルをアップロード：... upload ./local.jpg /ICONS/9999.jpg
  • 名前変更：... rename /ICONS/old.gif /ICONS/new.gif
  • 削除：... delete /ICONS/bad.gif
すべてのアイコンを安全に削除する（404 ループのバグを回避）

icons list で返された多数のファイルを削除する場合、空白がつぶれるコマンド置換のループは避けます。各ファイル名を個別に削除するため、行を安全に扱えるループを使用します。

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

参考資料

  • HTTP エンドポイント、ファイルシステム API、LaMetric のインポートの詳細：references/AWTRIX_HTTP_FILESYSTEM.md
  • MQTT/HA の制御パターン（カスタムアプリ、通知、設定）：references/AWTRIX.md
  • 上流の MQTT API リファレンス：references/upstream-api.md

コメント

Markdown 対応