Skip to content
A bundle of scripts to create a scoreboard website for the roguelike game Dungeon Crawl Stone Soup..
Python HTML JavaScript CSS Shell Makefile
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Type Name Latest commit message Commit time
Failed to load latest commit information.
.codeclimate.yml Exclude vendor css/js from codeclimate Nov 17, 2016
.gitignore Ignore *.pyc files Oct 12, 2016
.pylintrc cosmetics Aug 19, 2016

DCSS Scoreboard

Tool to create a scoreboard for online DCSS games.

Code Climate Build Status

Why make another scoreboard?

  • The CAO scoreboard is old; |amethyst said 1.3 people understood it and fewer still had time for working on it. So we decided to start from scratch.
  • Faster scripts. No benchmarks just yet so you'll have to take our word for it.
  • Better streaks:
    • Streak griefers are detected with some clever heuristics and blacklisted from the stats.
    • To extend your streak you must start the next game after finishing the previous one. No more queuing up games and winning them all at once for a streak!
  • Bots are blacklisted so the min-duration leaderboard is finally useful again!
  • It’s time for a fresh new UI. New features include player search and a fancy new logo by Ontoclasm. Plus, we’re probably improving stuff as you read this.
  • Per-player tracking of many stats. We hope you like stats.
  • New improvements arriving all the time. If you like, you can even help out.

High-level program flow

  1. CLI entrypoint
  2. download logfiles in parallel using wget --continue
  3. load each game (eg each line) from logfiles into the database
  4. score each unscored game: 1. Handle streaks
  5. create the website directory 1. Write all global pages (index, highscores, streaks) 1. Write pages for players with newly scored games

How to use

Python 3.5+ is required. Install pre-requisites with pip install -r requirements.txt. If you want to use Postgres as your database server, also install the psycopg2 pip module (which requires libpq-dev on Ubuntu).

To use the code, run --help.

Windows users

  1. First, get Vagrant at and install it.
  2. Install the vbguest plugin with vagrant plugin install vagrant-vbguest.
  3. Open in the git folder in cmd which should contain 'Vagrantfile', and run vagrant up. This will set up an Ubuntu VM and might take a while.
  4. Once the setup is complete, you should be able to visit http://localhost:8080/ in a web browser and see your development website!
  5. To update your development scoreboard, you can SSH into the machine with vagrant ssh and run ./
  6. Ctrl-D will exit out of the VM's terminal. vagrant halt will shut down the VM when you're done. vagrant up will start it up again when you need it, and vagrant destroy will remove the VM entirely.

Alternatively, specify port 8000 when writing the website, cd /vagrant and python & to start serving the website at http://localhost:8000/.

Postgresql Management

To create a user and database in Postgres, try the following commands:

sudo -u postgres createuser -D -A -P scoreboard
sudo -u postgres createdb -O scoreboard scoreboard


You can see development status here:

You can’t perform that action at this time.