Skip to content

Latest commit

 

History

History
205 lines (146 loc) · 6.5 KB

README.ja.md

File metadata and controls

205 lines (146 loc) · 6.5 KB

Homebridge Nature Remo TV Remote

License: MIT downloads
Nature Remoに登録したテレビリモコンをhomebridgeに追加します
screenshot

📲 インストール

config-ui-xの「プラグイン」タブからhomebridge-nature-remo-tv-remoteで検索、もしくは下記のコマンドでインストールしてください。

npm i -g homebridge-nature-remo-tv-remote

✅ デバイスの設定

1. Nature RemoのOAuth2アクセストークンを取得

こちらからアクセストークンを取得します。

2. 登録するテレビのAppliance IDを取得

ターミナルを開き、下記のコマンドを実行してください。${access-token}には、1.で取得したトークンを入れてください。

curl -X GET "https://api.nature.global/1/appliances" -H "Authorization: Bearer ${access-token}" > appliance_id.json

保存されたappliance_id.jsonを開いて、Appliance IDを確認してください。

{
  {
    "id": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxx", // <- **Appliance ID**
    "device": {...},
    "model": null,
    "type": "TV",
    "nickname": "テレビ", // <- NatureRemoに登録されている名前
    "image": "ico_tv",
    "settings": null,
    "aircon": null,
    "signals": [...],
    "tv": { ... }
  },
  ...
}

3. homebridgeに登録する

config-ui-xを使用すると、簡単に設定を追加できます。
「プラグイン」タブから「homebridge-nature-remo-tv-remote」の設定を開き、1.,2.で取得したアクセストークンとAppliance IDを入力します。

「保存」を押した後、homebridgeを再起動してください。

homebridge setting

🏠 Homeアプリへ追加

既にhomebridgeをブリッジとして追加している場合でも、新しく追加する必要があります。

Home.appを開き、「アクセサリを追加」→「コードがないか、スキャンできません」→（追加したテレビを選択）→「このまま追加」を押してください。

HomeKit設定コードは、config-ui-xから確認できます。

add-homeapp-step

confirm-setting-code

🔖 Advance setting

Example button name
button name detail
power TV Power
input-terrestrial Select Terrestrial
input-bs Select BS
input-cs Select CS
ch-1 Select 1 channel
ch-2 Select 2 channel
ch-3 Select 3 channel
ch-4 Select 4 channel
ch-5 Select 5 channel
ch-6 Select 6 channel
ch-7 Select 7 channel
ch-8 Select 8 channel
ch-9 Select 9 channel
ch-10 Select 10 channel
ch-11 Select 11 channel
ch-12 Select 12 channel
ch-up Next channnel
ch-down Previous channel
back Back button
ok OK/Select button
vol-up Volume up
vol-down Volume down

In addition, there are various other buttons.
You can check the list of buttons from the appliance_id.json that you got when checking the appliance ID.

{
  {
    "id": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxx",
    "device": {...},
    "model": null,
    "type": "TV",
    "nickname": "テレビ", // <- NatureRemoに登録されている名前
    "image": "ico_tv",
    "settings": null,
    "aircon": null,
    "signals": [...],
    "tv": {
      "button": [
        {
          "name": "power", // <- **button name**
          "image": "ico_io",
          "label": "TV_power"
        },
        {
          "name": "select-input-src", // <- **button name**
          "image": "ico_input",
          "label": "TV_source"
        },
        ...
      ]
    }
  },
  ...
}
Set Input Sources

Allows you to set the input source for the TV.
By setting it, you can select the input source from the Home app.

Open the plugin tab of config-ui-x and go to Settings and open Sources.

In Label, enter the label of the input source.
And Button Name, enter the name of the button you got from Nature Remo.

If you have changed the input sources, you will need to restart homebridge and re-register in home.app.

Relocate the keymap

Assign any button on TV remote in the Control Center to any button.

Open the plugin tab of config-ui-x and go to Settings and open Key maps.

🤝 Contributing

  1. Fork it (https://github.com/sskmy1024y/homebridge-nature-remo-tv-remote/fork)
  2. Create your feature branch (git checkout -b my-new-feature)
  3. Commit your changes (git commit -am 'Add some feature')
  4. Push to the branch (git push origin my-new-feature)
  5. Create a new Pull Request

🎫 Licence

The MIT License (MIT)

  • Copyright (c) 2021 Sho YAMASHITA

🖋 Author