Home Assistantをカスタマイズする方法

はじめに
以前のwikiでは、reTerminal、ODYSSEY-X86にHome Assistantをインストールし、PC、スマートフォン、タブレット、およびreTerminal LCDのキオスクモードでダッシュボードUIを表示する方法について説明しました。
このwikiでは、必要な設定を行ってダッシュボードを構築する方法と、Home Assistantに付属する重要なアドオンの使用方法について、ステップバイステップで説明します。それでは始めましょう!
アドオン、HACS、インテグレーション
Home Assistantは主に3つの方法でその機能を拡張できます:
- アドオン
- インテグレーション
- HACS(Home Assistant Community Store)
アドオンを使用すると、追加のアプリケーションをインストールしてHome Assistant周辺の機能を拡張できます。例えば、ESPHomeでスマートセンサーと接続したり、Home AssistantをGoogle Driveに自動バックアップしたりできます。
インテグレーションを使用すると、Home Assistantを他のサービスと接続できます。例えば、スマートライト、CCTVカメラなどと接続できます。
HACS(Home Assistant Community Store)を使用すると、Home Assistant内でカスタムフロントエンドインテグレーション用のコンポーネントを追加できます。例えば、新しいハードウェア/センサーサポート、新しいテーマなどです。
このwikiでは、上記の機能について簡単に説明します。ただし、詳しく学びたい場合は、Home Assistantに関するオンラインリソースが豊富にあり、以下のYouTubeチャンネルが良いガイドとなります。
- EverythingSmartHome
- TheHookUp
- PaulHibbert
- MakeItWorkTech
- MarkWattTech
- SmartHomeSolver
- mostlychris
- KPeyanski
アドオン
デフォルトでは、すべてのアドオンが有効になっているわけではありません。すべてのアドオンを有効にするには、「アドバンスドモード」を有効にする必要があります。
- ステップ1. ユーザー名をクリックしてアドバンスドモードを有効にします

次に、アドオンパネルにアクセスする必要があります
- ステップ2. 設定 > アドオンに移動します

- ステップ3. アドオンストアをクリックします


Home Assistantのデフォルトアドオンに加えて、コミュニティが開発したサードパーティアドオンを追加できます。ただし、これらはHome Assistant開発者によって保守されていません。後でこれらのサードパーティアドオンを追加する方法を説明します。
アドオンの使い始め
それでは、いくつかのアドオンを設定してみましょう。ここでは、以下のアドオンの設定方法を説明します。
- Terminal & SSH
- File editor
- Glances
- Google Drive Backup
Node-RED、ESPHome、Adguard Home、BitWarden、Samba Share、Mosquitto broker、BookStack、Uptime Kuma、Cloudflared Tunnelなどのアドオンも設定できます。
アドオンのインストール
アドオンのインストールプロセスは、すべてのアドオンに共通です。ここで説明します。
-
ステップ1. 前述の通りアドオンストアにアクセスします
-
ステップ2. アドオンを選択するか、検索バーに入力します。例えば、ここではTerminal & SSHアドオンを選択します

- ステップ3. インストールをクリックします

- ステップ4. 起動時に開始、ウォッチドッグ、自動更新、サイドバーに表示などの詳細設定を行います。お好みですべてをオンにして、開始をクリックします

アドオンが開始され、実行されている場合、この緑色のドットが表示されます

- ステップ5. アドオンが開始された後、ログタブをクリックして、アドオンが正常に開始されているかどうかを確認します

File editorアドオン
設定の下のユーザーインターフェースから直接Home Assistantのほとんどを設定できますが、一部ではconfiguration.yamlなどのファイルを編集する必要があります。このファイルには、読み込まれるインテグレーションとその設定が含まれています。この設定ファイルにコードスニペットを追加して、特定の機能を有効にできます。
ただし、これらの設定ファイルにアクセスするには、ファイルエディターが必要です。そこでFile editorアドオンが役立ちます。
-
ステップ1. アドオンストア内でFile editorアドオンを探し、インストールして開始します。
-
ステップ2. WEB UIを開くをクリックするか、左側のナビゲーションペインのFile editorをクリックしてアクセスできます


Glancesアドオン
Home Assistantをインストールした後、ホストデバイスのハードウェアリソース使用量を確認したい場合があります。Glancesアドオンは、使用されているすべてのハードウェアリソースの概要を提供します。
-
ステップ1. アドオンストア内でGlancesアドオンを探し、インストールして開始します。
-
ステップ2. WEB UIを開くをクリックするか、左側のナビゲーションペインのGlancesをクリックしてアクセスできます

注意: 保護モードが無効になっていることを確認してください。そうでなければGlancesは開始されません

Google Drive Backupアドオン
前述したように、Home Asssitantにサードパーティのアドオンをインストールでき、Google Drive Backupはそのようなアドオンの一つです。Home Assistantをニーズに合わせて設定するために多くの時間と労力を投資した後、システムが壊れてしまうと、すべてが無駄になってしまいます。ここでバックアップが役に立ちます。
デフォルトでは、Home Assistantにはバックアップを行い、Home Assistantを実行しているホストデバイス上にオフラインで保存する機能があります。しかし、ホストデバイスが応答せず、アクセスすることさえできない場合、以前のバックアップからどのように復元するのでしょうか?
Google Drive Backupアドオンを使用すると、自動バックアップを設定でき、毎日Google Driveにバックアップをアップロードします。ホストデバイスにアクセスできない場合、Google Driveから保存されたバックアップをダウンロードして、デバイス上で復元できます。
- ステップ1. アドオンストアにアクセスし、右上角の3つの点をクリックしてリポジトリをクリックします


正常に追加されると以下のように表示されます

- ステップ3. 設定 > システムに移動し、再起動をクリックしてHome Assistantを再起動します

-
ステップ4. アドオンストアにアクセスし、Home Assistant Google Drive Backupアドオンを探し、インストールして開始します。
-
ステップ5. WEB UIを開くをクリックするか、左側のナビゲーションペインのバックアップをクリックしてアクセスできます

- ステップ6. GOOGLE DRIVEで認証をクリックすると、新しいウィンドウが開きます。Googleアカウントでサインインし、アクセスを許可します

- ステップ7. コピーをクリックして認証文字列をコピーします

- ステップ8. Home Assistant UIに戻り、コピーした文字列を貼り付けて保存をクリックします

これでGoogle Drive Backupsの設定が正常に完了しました。

バックアップ頻度、保持するバックアップ数などの追加設定を構成したい場合は、設定をクリックして設定ページに入ることができます

インテグレーション
それでは、Home Assistantのインテグレーションを探索してみましょう!ここでは、以下のインテグレーションの設定方法を紹介します。
- スマートライト制御
- CCTVカメラストリーム
Philips Hue、Shelly、Tuya、Sonos、Z-Wave、HomeKit、WLEDなどのインテグレーションも設定できます。
- ステップ 1. 設定 > デバイスとサービスに移動します

- ステップ 2. + インテグレーションを追加をクリックします

ここでたくさんのインテグレーションを見つけることができます!
スマートライトインテグレーション
スマートライトのON/OFFができるように、Xiaomiスマートライトインテグレーションを追加してみましょう。進める前に、Xiaomiスマートライトにアクセスできることを確認してください。Philips Hueなどの異なるスマートライトをお持ちの場合は、Philips Hueインテグレーションを追加でき、手順はほぼ同様です。
- ステップ 1. Yeelightを検索して選択します

- ステップ 2. スマートライトのIPアドレスを入力し、送信をクリックします

- ステップ 3. 完了をクリックします

- ステップ 4. 概要ページで、左上の3点ドットをクリックし、ダッシュボードを編集をクリックします

- ステップ 5. ここではユーザー名のカードは不要です。3点ドットをクリックし、カードを削除をクリックして削除します

- ステップ 6. 削除を確認します

- ステップ 7. + カードを追加をクリックし、ライトカードをクリックします

- ステップ 8. 名前を変更し、保存をクリックします

- ステップ 9. 完了をクリックします

- ステップ 9. これでライトをONにして、明度も制御できます

- ステップ 10. 3点ドットをクリックすると、色や色温度を変更する機能など、ライトをより詳細に制御できます。

CCTV IPカメラインテグレーション
ここでは、RTSPプロトコル経由でCCTVカメラからのリアルタイム映像ストリームを表示できるように、カメラインテグレーションを追加します!進める前に、IP機能を持ち、RTSP経由でストリーミングできるCCTVカメラにアクセスできることを確認してください。
- ステップ 1. インテグレーションページの新しいインテグレーションを設定で、generic cameraを検索して選択します。

- ステップ 2. RTSPストリームURLを追加し、必要に応じてユーザー名、パスワードを入力し、フレームレートを変更して送信をクリックします

- ステップ 3. 概要ページで、前と同様に**+ カードを追加**ページに移動し、Picture Entityカードをクリックします

- ステップ 4. エンティティの下にcameraと入力すると、前に設定したカメラが表示されます。それをクリックします。

- ステップ 5. 名前を変更し、カメラビューをliveに変更して保存をクリックします

これでダッシュボードにライブ映像ストリームが表示されます!

HACS (Home Assistant Community Store)
それでは、Home AssistantでHACSを探索してみましょう!HACSは多数の統合機能とフロントエンドのカスタマイズオプションを提供します。ここでは以下の設定方法を紹介します
- Home Assistantテーマの変更
- ダッシュボードへのWeatherカードの追加
HACSのインストール
- ステップ 1. 以前にインストールしたTerminal & SSHアドオンを開きます

- ステップ 2. ターミナルウィンドウ内で以下のコマンドを入力してHACSをインストールします
wget -O - https://get.hacs.xyz | bash -

- Step 3. HACS のインストールが完了したら、以下のコマンドで Home Assistant を再起動します
ha ha restart
- ステップ 4. Integrations ページで、Set up a new integration の下で HACS を検索して選択します。

- ステップ 5. すべてのオプションを選択してすべてに同意し、SUBMIT をクリックします

- ステップ 6. 認証コードをコピーし、リンクをクリックして GitHub にサインインします。

- ステップ 7. GitHub にサインインし、コピーしたコードを貼り付けて Continue をクリックします

- ステップ 8. Authorize HACS をクリックします

- ステップ 9. FINISH をクリックします

HACS がインストールされました!
- ステップ 10. Settings > System > Hardware に移動し、右上角の 3つの点 をクリックして Reboot Host をクリックして、システムを再起動することをお勧めします

- ステップ 11. システムが再起動された後、左側のナビゲーションペインに HACS が表示されます

Home Assistant テーマの変更
それでは HACS を使用してデフォルトテーマを変更しましょう!標準では、Home Assistant は単一のダークモードテーマのみが付属しています。しかし、これをカスタマイズしたい場合は、以下の手順に従う必要があります
- ステップ 1. カスタムテーマをインストールする前に、configuration.yaml ファイルにいくつかのコードを追加する必要があります。File editor を開き、フォルダアイコン をクリックしてファイルシステムを参照します

- ステップ 2. configuration.yaml をクリックします

- ステップ 3. このファイルの最後に以下を追加します
frontend:
themes: !include_dir_merge_named themes

- Step 4. 保存ボタンをクリックします

- Step 5. 作成した設定が有効かどうかを確認することがベストプラクティスです。そうしないと、次回Home Assistantの起動に失敗します。Developer Toolsに移動し、CHECK CONFIGURATIONをクリックします

**Configuration valid!**というメッセージが表示されれば、すべて正常です!

- Step 6. RESTARTをクリックしてHome Assistantを再起動します

- Step 7. HACSウィンドウ内で、Frontendをクリックします

- Step 8. + EXPLORE & DOWNLOAD REPOSITORIESをクリックします

- Step 9. ここでは多くのテーマが表示されます。例として、iOSテーマをインストールします。iOSを検索し、iOS Themes - Dark Mode and Light Modeを選択します

- Step 10. DOWNLOADをクリックします

- Step 11. プロンプトに対して再度DOWNLOADをクリックします

- Step 12. ダウンロードが完了したら、ユーザー名をクリックし、Themeの下でios-dark-mode-blue-redを選択します。お好みに応じて、このテーマの他の色も選択できます

新しいテーマが読み込まれると、Overviewページは次のようになります!

注意: テーマが正しく読み込まれない場合は、Home Assistantを再起動してください。
ダッシュボードに天気カードを追加
次に、HACSを使用して天気カードをインストールし、ダッシュボードに追加します!
この天気カードをインストールする前に、天気情報を取得するためにopenweathermapに接続する必要があります。そして、openweathermapに接続する前に、openweathermapからAPIキーを取得する必要があります。
-
Step 1. このリンクにアクセスして、openweathermapアカウントにサインアップします
-
Step 2. このリンクにアクセスして、新しく作成したアカウントにサインインします
-
Step 3. アカウント名の下で、My API keysをクリックします

- Step 4. APIキー名を入力し、Generateをクリックします

- Step 5. 生成されたAPIキーをコピーします

次に、このAPIキーを追加します
- Step 6. Home Assistantで、Settings > Devices & Services > Integrations > + ADD INTEGRATIONに移動し、OpenWeathermapを検索してクリックします

- Step 7. コピーしたAPI keyを貼り付け、あなたの場所に応じてLatitude and Logitudeを変更し(これは簡単なGoogle検索で見つけることができます)、Modeをhourlyに変更してSUBMITをクリックします

- Step 8. Finishをクリックします

次に、HACSから天気カードをインストールします
- Step 9. HACS > Frontend > + EXPLORE & DOWNLOAD REPOSITORIESに移動します

- Step 10. weatherと入力し、Weather Cardをクリックします

- Step 11. DOWNLOADをクリックします

- Step 12. プロンプトに対して再度DOWNLOADをクリックします

- Step 13. Overviewページで、以前と同様に**+ ADD CARD**ページに移動し、Custom: Weather Cardをクリックします

- Step 14. 以前に入力したLatitude and Logitudeに応じてCity Nameを入力し、SAVEをクリックします

完成したダッシュボードは以下のようになります
