Homebridge-Smartglass

This is a plugin for Homebridge that allows you to control your xbox console. The following features are supported:

Turn on and off
Show current active app using input sources
Allows you to launch apps and games using the input switcher *
Control volume on the Xbox Series *
Remote control using the native IOS remote

* Requires to be logged in and have the console configured using the Xbox API.

Requirements:

NodeJS >= 10.x
Homebridge >= 1.3.0

Installation instructions

Install the plugin:

npm install -g homebridge-smartglass

Config UI X / HOOBS instructions

Search for the plugin using smartglass
Install plugin and configure using the UI.

Setting up the Xbox

The plugin needs to be allowed to connect to your Xbox. To allow this make sure you set the setting to allow anonymous connections in Settings -> Devices -> Connections on the Xbox.

Your xbox also needs to be in instant-on mode.

Finding the liveid of your console

Go to settings -> Console info and the liveid is displayed right there.

Authenticate with the Xbox API

When you authenticate with the Xbox api using your account, you can enable the api function to switch apps and have an improved poweron and poweroff functions. After reloading homebridge, homebridge-smartglass will show instructions in the console on how to authenticate with the Xbox API. You can authenticatie via the following steps:

Check the log output for an link that homebridge-smartglass provides on startup
Authenticate with Homebridge-Smartglass to allow the application to authenticate with the Xbox API's
After authenticaing you will get redirected. After the redirect copy the part after ?code= from the url
Add a new entry below "liveid: "<liveid>", with: "apiToken": "<code>", and restart homebridge
Check the logs after the restart. The console will tell you if the authentication was successful or not

Reload homebridge and you are done.

Homebridge configuration

Configure the Platform in your Homebridge config like below. Replace the ip address and liveid.

"platforms": [
  {
    "platform": "Smartglass",
    // "apiToken": "<token>", // Only add this when you have to set the token. 
    "devices": [
      {
        "name": "Xbox Series S",
        "ipaddress": "192.168.2.9",
        "liveid": "F400000000000000",
        "inputs": [
          {
            "name": "Twitch",
            "aum_id": "TwitchInteractive.TwitchApp_7kd9w9e3c5jra!Twitch",
            "title_id": "442736763"
          },
          {
            "name": "Spotify",
            "aum_id": "SpotifyAB.SpotifyMusic-forXbox_zpdnekdrzrea0!App",
            "title_id": "1693425033"
          },
          {
            "name": "Youtube",
            "aum_id": "GoogleInc.YouTube_yfg5n0ztvskxp!App",
            "title_id": "122001257"
          },
          {
            "name": "Destiny 2",
            "aum_id": "Bungie.Destiny2basegame_8xb1a0vv8ay84!tiger.ReleaseFinal",
            "title_id": "144389848"
          }
        ]
      }
    ]
  }
]

Key	Explanation
`name`	The name of the accesory to appear in Homekit
`liveid`	This needs to contain your Xbox live id. You can get this live id in the console settings.
`ipaddress`	This needs to contain your xbox console ip. Best is to set a static ip on the console.
`inputs`	This part is optional. You can define extra apps here to show them in Homekit and you can launch then when you supply a title_id

Optional options

The plugin supports optional options for configuring the plugin.

Key	Explanation
`apiToken`	(Optional) After authenticating with the Xbox login url you need to paste in the token you get after the redirect in the url (`?code=<code>`)
`clientId`	(Optional) Provide an Azure AD clientId to use your own tenant for authentication
`clientSecret`	(Optional) Provide an Azure AD clientSecret related to the clientId to use your own tenant for authentication. Depends on app configuration if needed.

How can i find the aum_id and title_id?

There are 2 ways: You can get the data from the homebridge logs when you are authenticated with the xbox live api or you can try to find if the app or game is listed in a community user GitHub repository which can be found here: https://github.com/PewDieMelon/app-list-for-homebridge-smartglass

The Readme of the above listed repository also shows you how to get the aum_id and title_id via the console itself (In case you cannot check the homebridge log)

Known issues

TV Controls can stop working after some usage. The client will reconnect when this happens.

unknownskl/homebridge-smartglass