Skip to content


Switch branches/tags

Name already in use

A tag already exists with the provided branch name. Many Git commands accept both tag and branch names, so creating this branch may cause unexpected behavior. Are you sure you want to create this branch?
This branch is 405 commits ahead, 341 commits behind antzucaro:master.

Latest commit


Git stats


Failed to load latest commit information.
Latest commit message
Commit time

This is the source code of qlstats, a website for tracking Quake Live player statistics. The source is based on xonstat, the stats tracking site for Xonotic, and was modified and enhanced for handling Quake Live.

System overview

qlstats is a set of several components:

  • postgresql: The database system storing all the data (except some configuration), running on version 9.4
  • nginx: public facing HTTP server, used to dispatch incoming URLs to backend "paster" and "feeder" processes, also taking care of SSL encryption and throttling
  • paster: The process hosting the main web site, inherited from the xonstat project, written in python
  • feeder: nodejs server process(es), which fulfill several tasks, based on the(ir) config:
    • connect to QL game server ZMQ stats port to receive stats data
    • convert the stats data from QL JSON format to the xonstat submission format and upload it to the paster's
    • "gamerating" module to calculate glicko rating updates for the players in the matches
    • "webadmin" module with the game server self-administration panel
    • "webapi" module with public and internal APIs, like enriched server browser information, player localization, ...
    • "webui" module hosting the parts of the website that require a login
  • cronjobs: scheduled maintenance scripts to
    • update ranking lists
    • assign regions to game servers through geo-ip lookup
    • assign regions to players based on the servers they played on

nginx is the only publicly accessible server process. All other processes are bound to IP In this repository you can find nginx, paster and feeder config files for "" (production) and "qlstats.local" (development).

The production setup runs 5 feeder processes with different modules enabled, while in a local setup one feeder runs all modules. The nodejs "zmq" library has a limitation that it can only handle up to 342 zmq connection per process, so qlstats runs 4 feeder processes to handle more QL servers. In the production setup feeder #1 runs the webui, feeders 1-4 have listen to game server zmq messges, host the various webadmin panels and an internal web API. A 5th feeder process just runs the "webapi", which aggregates live data from the other 4 feeders through the internal API.

The local setup for development uses only a single feeder process that runs all the modules (but only allows up to 342 QL servers to be monitored).


nginx is setup to redirect almost all plain HTTP requests to HTTPS. Exceptions are public API URLs to provide backward compatibility. Incoming requests are forwarded to xonstat and feeder processes based on URL prefixes: /account: feeder 1 running the webui /panel1: feeder 1 running webadmin /panel2: feeder 2 running webadmin /panel3: feeder 3 running webadmin /panel4: feeder 4 running webadmin /api: feeder 5 running webapi redirected to /api/. This legacy subdomain only exists for backward compatibility all other URLs: paster

paster (aka xonstat)

This process is started automatically by a crontab entry to launch cronjobs/ The web server listens on


Feeders are started automatically by a crontab entry to launch cronjobs/
Feeders 1-4 run on to 8084 and use config files cfg1.json - cfg4.json.
Another feeder process runs on port 8088 and uses config file cfg_api.json. It only runs the "webapi" module and no actual QL server data feed.
Feeder process are started from within the xonstat/feeder directory with command line "node feeder.node.js -c cfgX.json".

local setup (for development)

To use the local setup, you need to add an entry to your /etc/hosts (or %windir%\System32\drivers\etc\hosts) file: qlstats.local

Use the nginx/qlstats.local/nginx.conf file to configure your local nginx server. It will handle requests for "http(s)://qlstats.local/" URLs and forward them to the local backend processes.

To start the "paster" main web server, use "paster serve local.ini" from within the xonstat directory.

To start the "feeder", use "node feeder.node.js -c local.json"

Project is licensed GPLv2+.


Pyramid application using xonstatdb to parse and store Xonotic statistical data.







No releases published


No packages published


  • Python 37.8%
  • JavaScript 28.9%
  • Mako 20.2%
  • PLpgSQL 4.3%
  • CSS 3.0%
  • Go 2.1%
  • Other 3.7%