This module is an Accessory plugin for Homebridge which allows you to control your Xbox One using Homekit and the new Remote control introduced in iOS 12.2.
MIT License
This is a plugin for Homebridge that allows you to control your xbox console. The following features are supported:
* Requires to be logged in and have the console configured using the Xbox API.
Install the plugin:
npm install -g homebridge-smartglass
smartglass
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.
Go to settings -> Console info and the liveid is displayed right there.
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:
?code=
from the url"liveid: "<liveid>",
with: "apiToken": "<code>",
and restart homebridgeReload homebridge and you are done.
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 |
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. |
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)