Hass.io Add-on: Xbox One
This add-on is a packaged version of the Xbox One SmartGlass RESTful server and a Home Assistant Xbox One custom component. It allows you to easily setup and configure controlling your Xbox from Home Assistant.
Installation
The installation of this add-on is pretty straightforward and not different in
comparison to installing any other Hass.io add-on.
- Add my Hass.io add-ons repository to your Hass.io instance.
- Install the “Xbox One” add-on.
- Put your Xbox Live account details into the
email
/password
options. - Click the
Save
button to store your credentials. - Start the “Xbox One” add-on.
- Check the logs of the “Xbox One” add-on to see if everything went well.
- Surf to your Hass.io instance and use port
5557
(e.g.http://hassio.local:5557
).
Add-on Configuration
Note: Remember to restart the add-on when the configuration is changed.
Example add-on configuration:
{
"email": "[email protected]",
"password": "changeme"
}
Note: This is just an example, don’t copy and past it! Create your own!
Option: email
The email address you use to login to your Xbox Live account.
Option: password
The password you use to login to your Xbox Live account.
Home Assistant Configuration
This add-on creates a custom component in your hassio instance. This component needs to be configured in order to display your Xbox in Home Assistant. Follow the below steps to get started.
- Turn on all of the Xboxes you wish to be discovered.
- View the device list in this plugin: hassio.local:5557/devices
- Create the
media_player
configuration using theliveid
as the value fordevice
. - Restart Home Assistant to pick up the config change.
Example configuration.yaml
:
media_player:
- platform: xboxone
device: FD009374623167E
name: Living Room Xbox One
Note: This is just an example, don’t copy and past it! Create your own!
Option: platform
Required: This must be set to xboxone
Option: device
The LiveID of your Xbox One. It can be found in /devices
endpoint. Once this addon is up and running click here.
Option: name
The friendly name for this Xbox which will appear in Home Assistant.
Authors & Contributors
The original setup of this repository is by Jason Hunter.
Huge shoutout to Team OpenXbox for reverse engineering the SmartGlass protocol and providing the libraries and server used.
Special thanks to the contributions of tuxuser for answering late night questions and doing almost all of the heavy lifting on this.