Xbox One Smartglass REST API
Project description
Xbox-Smartglass-REST
Open-Source Xbox One Smartglass REST server.
For in-depth information, check out the documentation: (https://openxbox.github.io)
Dependencies
Python >= 3.5
xbox-smartglass-stump (https://pypi.org/project/xbox-smartglass-stump/)
Flask (https://pypi.org/project/Flask/)
Install
Via pip:
pip install xbox-smartglass-rest
How to use
Start the server:
$ xbox-rest-server
Authentication
Authenticate from scratch
For non-2FA enabled account: http://localhost:5557/auth/login For 2FA: http://localhost:5557/auth/oauth # Store tokens on valid authentication http://localhost:5557/auth/store
Load tokens from disk
http://localhost:5557/auth/load http://localhost:5557/auth/refresh
2FA OAuth - POST
# Get authorize url GET http://localhost:5557/auth/url Response-Parameters (JSON): authorization_url # Submit redirect url POST http://localhost:5557/auth/oauth Request-Parameters: redirect_uri
Regular (non-2FA) login - POST
POST http://localhost:5557/auth/login Request-Parameters: email, password
General usage
To see all API endpoints:
http://localhost:5557
Usual usage:
# (Optional) Poweron console http://localhost:5557/device/<liveid>/poweron # NOTE: You can specify device by ip: /device/<liveid>/poweron?addr=192.168.0.123 # Enumerate devices on network # NOTE: You can enumerate device by specific ip: /device?addr=192.168.0.123 http://localhost:5557/device # Connect to console # NOTE: You can connect anonymously: /connect?anonymous=true # .. if console allows it .. http://localhost:5557/device/<liveid>/connect # Use other API endpoints ...
Known issues
Find, report and/or fix them ;)
Bugreporting
When reporting bugs, please make sure to provide the output of the following endpoint
http://localhost:5557/versions
Contribute
Report bugs/suggest features
Improve / add endpoints
Credits
This package uses parts of Cookiecutter and the audreyr/cookiecutter-pypackage project template.
History
0.9.6 (2018-10-04)
Return unique index endpoint
Create FAQ
Always refresh XBL Client with new tokens and implement IP in /device
Expose IP addr discovery through /devices?addr=192.168.0.123
Always refresh XBL Client with new tokens
Add GameDVR endpoint
0.9.5 (2018-08-16)
Add App Type and Fix Media Status
0.9.4 (2018-08-14)
Add /web/titlehistory endpoint
Enable logfile cmdline argument
Parse proper parameter from /launch/<app_id> and /media/seek/<seek_position>
Standardize media commands and input keys casing
Clean up status codes and auth routes
Add friendly name and display image from titlehub to console_status response if authenticated
Do a best effort token load and refresh on startup, auto dump tokens file on successful auth
Simplify auth url endpoint
Restructure app to be more modular
Add XboxLiveClient and endpoint /web/title/<title_id> for downloading friendly name and displayImage
Allow connecting anonymously when supplying anonymous=true via POST to /connect
Pin xbox-smartglass-stump version
Adding /media/seek endpoint
Add /versions endpoint
Rewrite authentication endpoints, OAUTH and regular auth supported
Rename endpoint /authentication to /auth
0.9.3 (2018-08-08)
Rename /status to /console_status
0.9.2 (2018-08-04)
Stump <headend, livetv, tuner lineups> endpoints
Add console flags
Preparing NANO endpoints
Adjusting authentication endpoint slightly
Allow anonymous connection
0.9.1 (2018-08-04)
Small fixup
0.9.0 (2018-08-04)
First commit on github
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for xbox-smartglass-rest-0.9.7.tar.gz
Algorithm | Hash digest | |
---|---|---|
SHA256 | 91d21c0cd7cd83549461a364ac1dee7caeb482afa38f0ec77f9c4b428fd94141 |
|
MD5 | c4e73b3ca47b31fd1394ddc2c8345006 |
|
BLAKE2b-256 | dc2833cba723e6859df4ca84d8899459f748d34cd107b3a782e1dcdbc7e7b2f0 |
Hashes for xbox_smartglass_rest-0.9.7-py2.py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 06281b6d00c7ec1b570eb12380ed7c159aef2ec8ad97e54415884e0ed9369216 |
|
MD5 | 4e6ffb301f701a201a55eb4377f4921f |
|
BLAKE2b-256 | 05699bc572f4e0b015cf461110212f23301e820c1da4d83e292d81f1b2f23764 |