Skip to content

A plugin for BitBar that shows your Xbox Live friend's recent activity.


Notifications You must be signed in to change notification settings


Folders and files

Last commit message
Last commit date

Latest commit



15 Commits

Repository files navigation

BitBar Xbox Feed Plugin Build Status

A plugin for BitBar that shows your Xbox Live friend's recent activity.



bitbar install Games/xboxfeed.10m.js




  1. After installing the plugin, click on the Xbox icon in your menu bar and select "Run Installation".
  2. Go to and create a free account.
  3. Connect your Xbox Live account to your newly created Xbox API account and you should receive an API key.
  4. Open ~/.bitbarrc in your favorite text editor (create the file if it doesn't exist already).
  5. Insert the following and save:

Refresh the plugin and enjoy!


Along with your apiKey, other settings can be defined in your ~/.bitbarrc file:

  • apiKey - Your Xbox API Key

    • Default: (Blank)
    • Example: apiKey=c9ff119073ea2567730fb42e3a4fe805
    • Required
  • color - Text color

    • Default: false (System default)
    • Example 1: color=green
    • Example 2: color=#5dc21e
    • Setting to false will use the system default
    • Color names or HEX values can be used
  • font - Text font

    • Default: false (System default)
    • Example: font=Georgia
    • Setting to false will use the system default
  • size - Text size

    • Default: false (System default)
    • Example: size=24
    • Setting to false will use the system default
  • length - Number of characters before the text is truncated

    • Default: false
    • Example: length=70
    • Setting to false will disable truncating
  • limit - Max number of recent activity notifications to show

    • Default: 25
    • Example: limit=50
  • imgSize - User image size in pixels

    • Default: 18
    • Example: imgSize=50
    • Setting to false will disable user images display
    • Can be any number from 1-50
  • cachePath - Directory path to store user images cache

    • Default: /tmp/xboxfeed
    • Example: cachePath=/some/other/folder
    • Setting to false will disable user image caching (and will slow down the plugin)
    • Plugin will attempt to create the folder if it doesn't already exist
  • cacheExpire - Number of milliseconds before a user image should be re-downloaded

    • Default: 86400000 (24 hours)
    • Example: cacheExpire=604800000


Could not connect to API

The plugin couldn't connect to the servers. This means that either their servers are down, Xbox Live servers are down, or you are having internet connectivity problems.

A fresh login is required to gain a new token from Microsoft

The servers were unable to authorize your Xbox Live account. This means that you need to log into your account and reconnect your Xbox Live account. If this happens often you may want to consider checking the "Remember Me" box when connecting your account.

User images aren't showing up

If user images aren't showing up and you are sure that you don't have imgSize set to false then this means that the plugin ran into problems when trying to save the images to cachePath. You can either disable image caching by setting cachePath to false or try to figure out why the plugin couldn't save the images to the specified path. I would start by manually creating the folder that cachePath is set to.


MIT. See the License file for more info.


A plugin for BitBar that shows your Xbox Live friend's recent activity.








No packages published