DarkRadiant - Compilation Guide

Compiling under Windows

This should hopefully cover the steps to prepare your machine to be able to compile the DarkRadiant Editor from source.

Needed Software

You'll need to download these pieces of software (these are all free, you don't need to pay for anything):

• TortoiseSVN for obtaining the sources
• MinGW the actual compiler
• ActivePython to run scons
• scons to run the compilation scripts
• The GTK+ Framework (choose the latest stable version)
• GtkGLExt - OpenGL Extension to GTK+

Step 1: Install the Tools

First, download and install TortoiseSVN. Nothing special here, just install it into any folder of your preference. After installation it probably will ask to reboot your machine, as Tortoise integrates into the Explorer shell. (You can do that later, when all the other components have been installed).

Second, install the compiler MinGW. Launch the setup and choose the package Current, then be sure to check the box of the g++ compiler. Choose Download and Install in the next steps and let setup do the rest.

Third, install the ActivePython interpreter, which is needed to run the SconScript. Nothing spectacular here as well. After Python has been installed, run the scons installer (version 0.96.1 works for sure, don't know about others).

Lastly, install GTK+ plus GtkGLExt and reboot the machine.

Step 2: Obtain the Sources

The complete codebase is available at SourceForge. To check out the sources, open up Explorer and create the folder you want to store them.

Right-click somewhere in the white space and choose SVN Checkout. A new dialog appears asing you for the repository URL and the checkout folder. You can copy and paste the URL from here into the dialog window:

https://darkradiant.svn.sourceforge.net/svnroot/darkradiant/trunk/darkradiant/

Click OK and prepare for a few minutes of downloading, the trunk repository is some ten megs large.

Step 3: Compile the Sources

If you're finished downloading the sources, open up the console by pressing Win-R or click Start > Run..., then type cmd and confirm. Once the DOS box is there, head to the according source folder by typing

cd C:\DarkRadiant

or whatever your path is where you downloaded them. Now type:

scons BUILD="release"

and the sources should start to compile (in release mode).

It's likely that I forgot something here and you might get scons complaining about a missing compiler or something. In that case, please tell greebo to update this tutorial accordingly.

The time neede to compile DarkRadiant strongly depends on your CPU power and may take up to ten minutes for a release build (a debug build may take much longer for whatever reasons).

Step 4: Run DarkRadiant

The readily compiled sources can be found in the install/ folder beneath the DarkRadiant root (the folder you downloaded your sources to).

C:\DarkRadiant\install\darkradiant.exe

Just create a shortcut by dragging the exe somewhere to your desktop with right mouse button and choose to create a link there. There is also an icon file located in the same folder you can use for this link to make it looking more pleasant.

If you get an error during startup, please contact greebo, perhaps there is something missing in this tutorial.

Compiling under Linux

Instructions go here (WIP)

See also

• DarkRadiant - Compilation Problems