Skip to main content

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

Project description


Latest Version Documentation Status Discord chat channel

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

For in-depth information, check out the documentation: (


Via pip:

pip install xbox-smartglass-core

How to use

Authenticate first (Authentication provided by xbox-webapi-python):

$ xbox-authenticate

# Alternative: Use the ncurses terminal ui, it has authentication integrated
$ xbox-tui

Now have a look in the Documentation how to use the provided shell-scripts!


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

Known issues

  • Find, report and/or fix them ;)


  • Report bugs/suggest features
  • Add/update docs
  • Enhance managers


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


1.0.12 (2018-11-14)

  • Python 3.7 compatibility

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

1.0.1 (2018-05-03)

  • First release on PyPI.

Project details

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, version 1.0.12
Filename, size File type Python version Upload date Hashes
Filename, size xbox_smartglass_core-1.0.12-py2.py3-none-any.whl (57.6 kB) File type Wheel Python version py2.py3 Upload date Hashes View hashes
Filename, size xbox-smartglass-core-1.0.12.tar.gz (77.3 kB) File type Source Python version None Upload date Hashes View hashes

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page