XBL Status is (c) 2008 Chris Hollenbeck and is released under the MIT License.

Site:
----
http://www.hollec.com/projects/xblstatus/

Forums:
------
http://www.hollec.com/forum/xblstatus/

IRC:
---
#xblstatus on irc.freenode.net

Prerequisites:
-------------
The following packages are required on Ubuntu 7.10 (Gutsy):

    python-beautifulsoup, python-clientform, python-glade2, python-gtk2,
    python-notify, python-dbus

The exact package names may be different for your distribution.

There is no more need to edit the xblstatus.py script and fill in your username
and password.  See the Usage section below for more information.  Settings are
saved in ~/.xblstatus/xblstatus.config

Give the script executable permissions by running the following from the
terminal:
    chmod u+x ./xblstatus.py

Usage:
------
Run the program from the terminal:
    cd /path/to/xblstatus
    ./xblstatus.py
    
You should also be able to double-click the xblstatus.py file in the
file manager and select Run if prompted.  The authentication information will
need to be set the first time the program is run.  Go to Edit->Preferences
and fill in the username and password you normally use to access the Xbox Live
site.  The default notification method is Libnotify, which gives balloon
notifications.  The DBus notification method can be used for other programs
that listen at the correct DBus path, such as Mumbles
(http://mumbles-project.org).  The Mumbles notifications require a plugin that
is distributed separately.

Listening for XBL Status on DBus:
---------------------------------
DBus interface: 'com.hollec.xblstatus'
DBus path: '/com/hollec/xblstatus'

Three strings are sent out in the notification:
1) Title (e.g. 'Online' or 'Offline')
2) Message (e.g. "FriendsGamertag\nPlaying Halo 3")
3) Picture (path to the friend's GamerPicture, stored in ~/.xblstatus/cache/)

See http://dbus.freedesktop.org/doc/dbus-python/doc/tutorial.html for
more information on using DBus in Python.  The NotifyDBus.py file is used
to send out the notifications.
