Dungeon Crawl Stone Soup is available in two versions: a non-graphical console port (as is traditional for roguelikes), as well as a graphical Tiles version. The latter package will actually contain both the graphical and the non-graphical binaries, so if you don’t know yet which one you’d prefer, try that one. All pre-built packages contain wizard mode.

Latest stable release 0.16.1


graphical Tiles/SDL non-graphical Console/ASCII
Screenshots 0.7 Tiles screenshot featuring storm disc explosions in the Lair ASCII screenshot of Xom reviving a dead character.
More screenshots…
Operating systems
Windows Zips Download Tiles Version (32-bit version) Download Console Version (32-bit version)
Mac OS X Download Tiles Version Download Console Version
Debian/Ubuntu Download Tiles Version Download Console Version
Android Download Tiles Version Download Console Version (unofficial, 0.15.2)
Source code Source code for both Tiles and Console Versions (tarball, tarball without deps)

The changelog can be found here. A list of all files, particularly of older versions, is available on SourceForge.

Packages for Debian-based Operating Systems

We are also offering packages for Debian-based operating systems (Debian, Ubuntu, Mint, etc) for the architectures i386, amd64 and armel. Add the line from below to your /etc/apt/sources.list:

deb http://crawl.develz.org/debian crawl 0.16

Additionally you should download and install our signing key to prevent warnings and to verify the packages:

wget http://crawl.develz.org/debian/pubkey -O - | apt-key add -
(if not done as root, please insert “sudo” before apt-key)

The available packages to apt-get are named: crawl, crawl-tiles

Unofficial packages for Fedora 21/20

User BlasterBlade has provided Fedora packages for Crawl (tiles and console builds) in the openSUSE Build System repository.

To install the tiles version, run the following (for Fedora 20, replace the 21 in the URL):

cd /etc/yum.repos.d/
wget http://download.opensuse.org/repositories/home:nazar554/Fedora_21/home:nazar554.repo
yum install crawl-sdl crawl-data

For the console version, replace the last command with:

yum install crawl-console crawl-data

Packages for openSUSE

Crawl is available in the OpenSUSE repository.

Development Builds

Stone Soup is undergoing rapid development, but you normally won’t see any big changes in minor bugfix releases. If you’d like to take a look at the next major release, you can play the development version online on CDO or you can download some regularly updated builds for both Tiles and the console version, available for Windows, Mac OS X and Debian/Ubuntu.

Be warned that changes may be experimental, unbalanced or buggy. However, we are usually quick in correcting these issues, and both bug reports and feature requests are very much appreciated. Also, from time to time, save games will be invalidated as big changes are integrated into the game.

The Source

1. Getting the source

If you’re only interested in compiling the most recent release version, all you need to do is download the xz-ed tarball mentioned above.

Otherwise, you will need to use git to access Stone Soup’s code repository. See docs/develop/git/quickstart.txt for a short introduction to git, where to get it and how to use it.

Once git is installed, you type the following in your command shell:

$ git clone https://github.com/crawl/crawl.git

“git clone” clones the crawl-ref git repository to your computer. When it’s done, you’ll have a full local copy of Stone Soup’s entire repository with all its history. In particular, you’ll be able to access any of the previous release branches by typing, e.g.

$ git checkout -b stone_soup-0.16 origin/stone_soup-0.16

Now the branch is tracked on your system, the necessary command
becomes much shorter:

$ git checkout stone_soup-0.16

To return to the main development branch (“trunk” or “master”), type:

$ git checkout master

You can have a look at the commit history of the currently active branch with

$ git log

The source code also includes a number of “submodules” like e.g. Lua or SDL
that have to initialized separately. To do this, type:

$ git submodule update --init

See docs/develop/quickstart.txt for a more detailed explanation.

2. Compiling the source

If you’ve never compiled the source code before, check INSTALL.txt for a list of programs you might have to install first. Once everything is installed correctly, all you really need to do is enter the source/ directory and type

$ make

for the console version, or

$ make TILES=y

for the Tiles version.

When the process finishes, the binary (named “crawl”) should be in the source directory. Depending on your operating system, you can then start it by clicking on it or by typing “./crawl” in the command line.

If you’re having trouble, or wish to compile the Tiles version on a Mac or to install Crawl for multiple users, please read INSTALL.txt.