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 制御パターン（カスタムアプリ、notify、設定）: references/AWTRIX.md
• アップストリーム MQTT API リファレンス: references/upstream-api.md