Latest version

Released:

The release of Xbox One is nearly upon us. Here in Redmond, we are incredibly excited for launch and we hope you are too. Before Xbox One arrives on Nov. 22, download the Xbox One SmartGlass app today (it’s a separate app from Xbox 360 SmartGlass) and check out some of the new features in advance that will make unboxing and setting up your Xbox One even easier. Mar 06, 2018 Xbox One SmartGlass is the perfect companion app for your Xbox One, both in your living room and on the go. Connect and control your Xbox One. Stay connected with the games and gamers you like. Nov 04, 2016 Description. Similar to Sony's approach with Remote Play and Second Screen functionality on PS Vita, Microsoft revamped its Xbox One SmartGlass.It is the perfect companion app for your Xbox One.

A library to interact with the Xbox One gaming console via the SmartGlass protocol.

Project description

Xbox-Smartglass-Core

This library provides the core foundation for the smartglass protocol that is usedwith the Xbox One Gaming console

For in-depth information, check out the documentation: (https://openxbox.org/smartglass-documentation)

NOTE: Since 29.02.2020 the following modules are integrated into core: stump, auxiliary, rest-server

NOTE: Nano module is still offered seperately

Features

Power on / off the console
Get system info (running App/Game/Title, dashboard version)
Media player control (seeing content id, content app, playback actions etc.)
Stump protocol (Live-TV Streaming / IR control)
Title / Auxiliary stream protocol (f.e. Fallout 4 companion app)
Trigger GameDVR remotely
REST Server

Frameworks used

construct - Binary parsing (https://construct.readthedocs.io/)
cryptography - cryptography magic (https://cryptography.io/en/stable/)
dpkt - pcap parsing (https://dpkt.readthedocs.io/en/latest/)
Flask - REST API (https://pypi.org/project/Flask/)

Install

Via pip:

Xbox One Smartglass Login

See the end of this README for development-targeted instructions.

How to use

There are several command line utilities to check out:

Some functionality, such as GameDVR record, requires authenticationwith your Microsoft Account to validate you have the right to triggersuch action.

To authenticate / get authentication tokens use:

REST Server

Start the REST server:

For more information consult RestFAQ

Fallout 4 relay service

To forward the title communication from the Xbox to your local hostto use third-party Fallout 4 Pip boy applications or extensions:

Screenshots

Here you can see the SmartGlass TUI (Text user interface):

Development workflow

Ready to contribute? Here’s how to set up xbox-smartglass-core-python for local development.

Fork the xbox-smartglass-core-python repo on GitHub.
Clone your fork locally:
Install your local copy into a virtual environment. This is how you set up your fork for local development:
Setup auto-linting before each commit via pre-commit:
Shonen knife yama-no attchan rarity. Create a branch for local development:
Make your changes.
Before pushing the changes to git, please verify they actually work:
Commit your changes and push your branch to GitHub:
Submit a pull request through the GitHub website.

Pull Request Guidelines

Before you submit a pull request, check that it meets these guidelines:

Code includes unit-tests.
Added code is properly named and documented.
On major changes the README is updated.
Run tests / linting locally before pushing to remote.

Credits

Kudos to joelday for figuring out the AuxiliaryStream / TitleChannel communication first!You can find the original implementation here: SmartGlass.CSharp.

This package uses parts of Cookiecutter and the audreyr/cookiecutter-pypackage project template.

History

1.2.1 (2020-03-04)

cli: Python3.6 compatibility change
HOTFIX: Add xbox.handlers to packages in setup.py

1.2.0 (2020-03-04)

CLI scripts rewritten, supporting log/loglevel args now, main script is called xbox-cli now
Add REPL / REPL server functionality
Updates to README and REST server documentation

1.1.2 (2020-02-29)

Drop support for Python 3.5
crypto: Fix deprecated cryptography functions
tests: Speed up REST server tests (discovery, poweron)
Update all dependencies

1.1.1 (2020-02-29)

FIX: Include static files for REST server in distributable package
REST: Remove deprecated packages from showing in /versions endpoint

1.1.0 (2020-02-29)

Clean up dependencies
Merge in xbox-smartglass-rest, deprecate standalone package
Merge in xbox-smartglass-stump, deprecate standalone package
Merge in xbox-smartglass-auxiliary, deprecate standalone package
tui: Fix crash when bringing up command menu, support ESC to exit

1.0.11 (2018-11-05)

Add game_dvr_record to Console-class
Fix PCAP parser
Add last_error property to Console-class

1.0.10 (2018-08-14)

Safeguard around connect() functions, if userhash and xsts_token is NoneType

1.0.9 (2018-08-11)

Fix for Console instance poweron
Reset state after poweroff
Little fixes to TUI
Support handling MessageFragments

1.0.8 (2018-06-14)

Use aenum library for backwards-compat with _enum.Flag_ on py3.5

1.0.7 (2018-05-16)

CoreProtocol.connect: Treat ConnectionResult.Pending as error
constants.WindowsClientInfo: Update ClientVersion 15 -> 39
Make CoreProtocol.start_channel take optional title_id / activity_id arguments

Project details

Release historyRelease notifications | RSS feed

0.8.10

0.8.9

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for xbox-smartglass-core-asyncio, version 0.8.10
Filename, size	File type	Python version	Upload date	Hashes
Filename, size xbox_smartglass_core_asyncio-0.8.10-py2.py3-none-any.whl (85.4 kB)	File type Wheel	Python version py2.py3	Upload date	Hashes
Filename, size xbox-smartglass-core-asyncio-0.8.10.tar.gz (392.0 kB)	File type Source	Python version None	Upload date	Hashes

Close

Hashes for xbox_smartglass_core_asyncio-0.8.10-py2.py3-none-any.whl

Hashes for xbox_smartglass_core_asyncio-0.8.10-py2.py3-none-any.whl
Algorithm	Hash digest
SHA256	`fa62afc38b7eb345a92c5800cba532f568cfba56be0ac586a1c1952df184390e`
MD5	`80ef29101df1e3392068f93005993a9c`
BLAKE2-256	`bbf3d7aef9410635850c973c226cd69e575e264fd6f8b116e4b508fa8eb4de57`

Close

Hashes for xbox-smartglass-core-asyncio-0.8.10.tar.gz

Hashes for xbox-smartglass-core-asyncio-0.8.10.tar.gz
Algorithm	Hash digest
SHA256	`7ce31386102a68c55edabe3577efd65f0ed6ce016c7b12ed1737d3928de49e01`
MD5	`23cd5624ad88e46eb9211281fbfa9f28`
BLAKE2-256	`eb3fb5ae5b8b62197d80880f53c9d8bd6cb1e6f79c41f564a86f51d7f133b12d`

Xbox

Screenshot of the Xbox Console Companion app on Windows 10

Developer(s)

Microsoft

Stable release

Windows 10	48.55.30001.0 / August 1, 2019; 23 mon