TABLE OF CONTENTS

README

This superkaramba theme utilized the python module qstat.py that has bindings into the qstat application. It should handle all supported game servers that the qstat application supports. It only displays the top 20 or so players currently.

Last updated: 12/29/2004
Version: 0.3

Files:
README - This file
qstat.py - The importable qstat wrapper module for the qstat application
skQstat.py - The python code for superkaramba callbacks
skQstat.theme - The superkaramba theme file

Directories:
doc - This contains any documentation for the application
images - This contains images used by the theme
pkgs - This contains the packages that you may need to install
+-->qstat-2.6.tar.gz - is the qstat binary application package
+-->qstat-latest.tar.gz - is the qstat python wrapper module for the qstat xml output
screenshots - This contains images of what to expect when running skQstat

INSTALL

For this theme to work, you will have to install the qstat application in the pkgs/qstat-2.6.tar.gz package. Once that application is configure/make/make install'ed then the superkaramba theme should be able to report server statistics.

The other package, pkgs/qstat-latest.tar.gz, is the python wrapper. There is NO need to install this. It is already in the theme directory for it to be accessed. The reason it is included is for distribution of the source so that anyone can use it should they want to write their own python code to read qstat output.

Changing the server

Q. How do I change to monitor a different game server?
A. Click on the green button in the upper left corner and follow the dialog instructions.

Notes

This has only been tested with Return to Castle Wolfenstein and Enemy Territory. Please contact me concerning anything that fails like a particular game server. That way we can add support.

Contact

Programmer: Ryan Nickell p0z3r@users.sourceforge.net

Credits

Thanks to Steve Jankowski who is the maintainer of Qstat( http://www.qstat.org )
Also, thanks to Erik Max Francis for his python wrapper qstat.py ( http://www.alcyone.com/max/ )


Thanks for using skQstat!

[top]