This is a pre-production deployment of Warehouse, however changes made here WILL affect the production instance of PyPI.
Latest Version Dependencies status unknown Test status unknown Test coverage unknown
Project Description

DotBox is a block-based game mini library. It greatly limits what is plausible.


DotBox is free software under the terms of the GNU General Public License version 3 (or any later version). The author of DotBox is Niels Serup, contactable at This is version 0.1.0 of the program.

Any libraries used by DotBox are GPL-compatible. Any data used by the examples included in this package is as free as DotBox itself.


Way #1

Just run this (requires that you have python-setuptools installed):

$ sudo easy_install dotbox

Way #2

Get the newest version of DotBox at or at

Extract the downloaded file and run this in a terminal:

# python install


DotBox should work with both Python 2.6+ and Python 3.x.

DotBox depends on PyGame 1.8.1+ (perhaps earlier versions are also supported, though at least version 1.9.0 is needed for Python 3).

  • For DEB-based distros (Debian etc.): type apt-get install python-pygame
  • For RPM-based distros (Fedora etc.): type yum install pygame
  • For other distros: do something similar or get it at


DotBox is a mini library with little functionality. Its documentation is included in its source code, so you can run this command to find out more about it (as this /is/ a 0.1.0 release, not much is shown yet; to figure out how to use DotBox, take a look the included examples instead):

$ pydoc dotbox

Example games

Instead of the lacking documentation, you can also take a look at the example games in the examples directory of this package. These games are playable.

Usable colors

DotBox uses a palette of 256 colors. The first 216 are the so-called “web-safe” colors (see ), while the remaining 40 are grayscale.


DotBox is written in Python and uses Git for branches. To get the latest branch, get it from like this:

$ git clone git://

This document

Copyright (C) 2011 Niels Serup

Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. This file is offered as-is, without any warranty.

Release History

Release History


This version

History Node

TODO: Figure out how to actually get changelog content.

Changelog content for this version goes here.

Donec et mollis dolor. Praesent et diam eget libero egestas mattis sit amet vitae augue. Nam tincidunt congue enim, ut porta lorem lacinia consectetur. Donec ut libero sed arcu vehicula ultricies a non tortor. Lorem ipsum dolor sit amet, consectetur adipiscing elit.

Show More

Download Files

Download Files

TODO: Brief introduction on what you do with files - including link to relevant help section.

File Name & Checksum SHA256 Checksum Help Version File Type Upload Date
dotbox-0.1.0.tar.gz (2.5 MB) Copy SHA256 Checksum SHA256 Source Jan 23, 2011

Supported By

WebFaction WebFaction Technical Writing Elastic Elastic Search Pingdom Pingdom Monitoring Dyn Dyn DNS Sentry Sentry Error Logging CloudAMQP CloudAMQP RabbitMQ Heroku Heroku PaaS Kabu Creative Kabu Creative UX & Design Fastly Fastly CDN DigiCert DigiCert EV Certificate Rackspace Rackspace Cloud Servers DreamHost DreamHost Log Hosting