General Notes

Don't install StepMania 5 over any existing StepMania install.

Windows

The installer registers the stepmania:// protocol handler, hence a lack of a zip version.

If you are using Windows Vista/7, DO NOT install StepMania 5 into Program Files, or else you will have to run the game as Administrator in order for it to work correctly. This can be avoided by installing StepMania 5 into a folder where you have full read/write access.

If the game doesn't start for you, here are some possible solutions:

• If the game doesn't boot at all, complaining about "The application configuration is incorrect", you might not have the Visual C++ 2008 SP1 Redistributable. There are versions for x86 and x64 versions of Windows.
• If you are trying to run the SSE2 version (StepMania-SSE2.exe), and it won't work, try the normal StepMania.exe/"non-SSE2"-labeled version instead.

Mac OS X

StepMania 5 works best when it's installed in its own folder inside of Applications. This is necessary since you will need to create various folders (Songs, etc.). See InstallingContent for more information.

Linux

Binary

You will need the relevant GameData.smzip. Create a folder called Packages wherever you've installed StepMania 5, and put it in there. Make sure to remove any older versions of GameData.smzip when upgrading.

Source

Instructions courtesy of Fraxtil; this assumes you have Mercurial installed already.

hg clone https://sm-ssc.googlecode.com/hg/ sm-ssc
cd sm-ssc
chmod +x autogen.sh 
./autogen.sh 
./configure
make

Copying build.sh from the Utils directory to the main directory, making it executable, and executing it after autogen.sh is another build method.

and then when you want to get the latest version, switch to the sm-ssc directory and run:

hg pull
hg update