Build the StepMania Source in Linux

To Build StepMania for Linux, the following steps must be taken. These steps assume you are building the latest source.


Gather The Libraries

Ensure you have the following libraries and programs installed:

  • libasound2-dev
  • libpulse-dev
  • libmad0-dev
  • libtheora-dev
  • libvorbis-dev
  • libpng-dev
  • libjpeg-dev
  • libglu1-mesa-dev
  • libgl1-mesa-dev
  • libgtk2.0-dev
  • xorg-dev*
  • libxrandr-dev
  • libbz2-dev
  • libglew1.5-dev
  • libswscale-dev
  • libavutil-dev
  • libavformat-dev
  • libavcodec-dev
  • automake1.10
  • build-essential
  • Mercurial/hg (or Subversion/svn for older releases)
  • curl
  • g++

*: It is believed almost any x11-dev or related library will work.

On some systems, some of these may already be installed.

On a Debian or Ubuntu command line you can copy and paste this:

sudo apt-get install libasound2-dev libpulse-dev libmad0-dev libtheora-dev libvorbis-dev libpng-dev \
libswscale-dev libavutil-dev libavformat-dev libavcodec-dev \
libjpeg-dev libglu1-mesa-dev libgl1-mesa-dev libgtk2.0-dev xorg-dev libxrandr-dev libbz2-dev \
libglew1.5-dev automake1.10 build-essential curl g++

Note: When compiling with MP3 support via libmad, binary distribution is under the terms of the GNU GPL v2.

To get everything but the version control (sudo apt-get install subversion or sudo apt-get mercurial)

Get the Source

Depending on which version you want, you'll have to run a different command.

StepMania 5

In the folder of your choice, run this command:

hg clone

If you already have the source, and wish to update it, run hg pull -u.

If you get an error message like "abort: HTTP Error 414: Request-URI Too Large" when trying to pull changes, you may need to use hg pull -b default to explicitly pull the default branch.

StepMania 4

In the folder of your choice, run this command:

svn co

If you already have the source, and wish to update it, run svn up.

If you get the following message when connecting to SVN:

Error validating server certificate for '':
 - The certificate is not issued by a trusted authority. Use the
   fingerprint to validate the certificate manually!
 - The certificate hostname does not match.
Certificate information:
 - Hostname:
 - Valid: from Thu, 07 Feb 2008 07:01:36 GMT until Sun, 04 Feb 2018 07:01:36 GMT
 - Issuer: Internet Security Division, StepMania, Seattle, Washington, US
 - Fingerprint: b0:7b:dc:ee:44:78:48:4b:76:32:89:d4:01:8d:c4:74:d5:e7:16:5d
(R)eject, accept (t)emporarily or accept (p)ermanently?

just accept permanently (p).

Compile the Source

Inside the stepmania folder, run this command:


(This creates some build scripts, it only has to be done the first time you build.)



It will gather ffmpeg, compile it, and then compile stepmania with it.

Have Fun

With that, the game is compiled. Go get some simfiles and have fun.

Thanks to (donated web hosting)