Home Assistantをカスタマイズする方法
この文書は AI によって翻訳されています。内容に不正確な点や改善すべき点がございましたら、文書下部のコメント欄または以下の Issue ページにてご報告ください。
https://github.com/Seeed-Studio/wiki-documents/issues
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を使用してスマートセンサーと接続したり、Google DriveにHome Assistantの自動バックアップを行ったりすることができます。
統合は、Home Assistantを他のサービスと接続することができます。例えば、スマートライトやCCTVカメラと接続することができます。
HACS (Home Assistant Community Store)は、Home Assistant内でカスタムフロントエンド統合のコンポーネントを追加することができます。例えば、新しいハードウェア/センサーのサポートや新しいテーマなどです。
このWikiでは、上記の機能について簡単に説明します。ただし、さらに詳しく知りたい場合は、Home Assistantに関するオンラインリソースが豊富にあります。以下のYouTubeチャンネルは非常に役立つ情報を提供しています。
- EverythingSmartHome
- TheHookUp
- PaulHibbert
- MakeItWorkTech
- MarkWattTech
- SmartHomeSolver
- mostlychris
- KPeyanski
アドオン
デフォルトでは、すべてのアドオンが有効になっているわけではありません。そのため、すべてのアドオンを有効にするには「Advanced Mode」を有効にする必要があります。
- ステップ1. ユーザー名をクリックしてAdvanced Modeを有効にします。

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

- ステップ3. ADD-ON STOREをクリックします。


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. 前述のようにAdd-on Storeにアクセスします。
ステップ2. アドオンを選択するか検索バーに入力します。例えば、ここではTerminal & SSHアドオンを選択します。

- ステップ3. INSTALLをクリックします。

- ステップ4. Start on boot、Watchdog、Auto update、Show in sidebarなどの設定をさらに構成します。すべてオンにすることもできます。その後、STARTをクリックします。

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

- ステップ5. アドオンが開始された後、Logタブをクリックしてアドオンが正しく開始されたかどうかを確認します。

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


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

注意: Protection mode が無効になっていることを確認してください。そうでない場合、Glances は起動しません。

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

- ステップ 2. 空欄に https://github.com/sabeechen/hassio-google-drive-backup をコピーして貼り付け、ADD をクリックします。

以下のように表示されれば、正常に追加されています。

- ステップ 3. Settings > System に移動し、RESTART をクリックして Home Assistant を再起動します。

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

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

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

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

これで Google Drive Backup の設定が完了しました。

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

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

- ステップ 2. + 統合を追加をクリックします。

ここでは、多くの統合を見つけることができます!
スマートライト統合
Xiaomi Smart Light統合を追加して、スマートライトのオン/オフを切り替えられるようにしましょう。進む前に、Xiaomi Smart Lightにアクセスできることを確認してください。もし別のスマートライト(例: Philips Hue)をお持ちの場合は、Philips Hue統合を追加することができ、手順はほぼ同じです。
- ステップ 1. Yeelightを検索して選択します。

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

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

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

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

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

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

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

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

- ステップ 10. これでライトをオンにしたり、明るさを調整したりすることができます。

- ステップ 11. 3点アイコンをクリックすると、色や色温度を変更するなど、ライトの詳細な制御が可能になります。

CCTV IPカメラ統合
ここでは、RTSPプロトコルを介してCCTVカメラのリアルタイムビデオストリームを表示できるようにカメラ統合を追加します!進む前に、IP機能を持ち、RTSPを介してストリームを提供できるCCTVカメラにアクセスできることを確認してください。
- ステップ 1. 統合ページで、新しい統合を設定の下にある汎用カメラを検索して選択します。

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

- ステップ 3. 概要ページで、以前と同様に+ カードを追加ページに移動し、画像エンティティカードをクリックします。

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

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

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

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

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

- ステップ 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-dotsをクリックしてReboot Hostを選択します。

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

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

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

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

- ステップ 4. 保存ボタンをクリックします。

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

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

- ステップ 6. RESTARTをクリックしてHome Assistantを再起動します。

- ステップ 7. HACSウィンドウ内でFrontendをクリックします。

- ステップ 8. + EXPLORE & DOWNLOAD REPOSITORIESをクリックします。

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

- ステップ 10. DOWNLOADをクリックします。

- ステップ 11. プロンプトで再度DOWNLOADをクリックします。

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

これで新しいテーマが読み込まれた状態でOverviewページが次のように表示されます!

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

- ステップ 4. APIキー名を入力し、Generate をクリックします。

- ステップ 5. 生成されたAPIキーをコピーします。

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

- ステップ 7. コピーした APIキー を貼り付け、Latitude and Longitude を自分の位置に合わせて変更します(これは簡単なGoogle検索で見つけることができます)。モードを hourly に変更し、SUBMIT をクリックします。

- ステップ 8. Finish をクリックします。

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

- ステップ 10. weather と入力し、Weather Card をクリックします。

- ステップ 11. DOWNLOAD をクリックします。

- ステップ 12. プロンプトで再度 DOWNLOAD をクリックします。

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

- ステップ 14. 以前入力した Latitude and Longitude に基づいて City Name を入力し、SAVE をクリックします。

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