Jump to content



Recommended Posts

  • Administrators

me Installation

GtkRadiant supports Windows, Mac and Linux platforms.

This is a guide for installing GtkRadiant 1.6 on these platforms.


Game Installation

On all platforms, GtkRadiant reads and writes game assets from within your game's directory. Before you start installing GtkRadiant, first make sure you have the game you want to edit for installed. GtkRadiant officially supports a number of different games. It is recommended to run a "clean" install: creating a separate installation of the game free of any third party custom content.


GtkRadiant 1.6 is packaged as a compressed zip file. Extract it somewhere on your system such as C:\GtkRadiant. Double-click on radiant.exe to start GtkRadiant, and be patient while the program initializes for the first time.

Some Windows users may find that they need to install the Visual C++ Redistributable for Visual Studio 2015. If you try to run GtkRadiant and you are getting an error message about missing .dll files, you will need to install this first. 32-bit users will need to download vcredist_x86.exe, 64-bit users will need to download both vcredist_x86.exe and vcredist_x64.exe.

Mac OS X

The Macintosh version of GtkRadiant relies on the Unix X11 system. For many OS X computers, X11 may already be installed with your operating system. It is recommended that you run a system update to make sure that you have the latest version. However if using OS X 10.8 (Mountain Lion) or later, Apple no longer packages X11 with the OS and is redirecting users to manually install X11 instead. The easiest way to do this is to download and install XQuartz, it is a simple .dmg file, just run it and follow the instructions.

Currently, Mac users will also need to install MacPorts. It can be downloaded as a "pkg" installer so just run the program and follow the instructions. Once installed, you will need to install additional dependencies for MacPorts. Open Terminal and enter the following (it may take some time and there is no feedback in Terminal as it downloads and installs, so be patient).

sudo port install dylibbundler pkgconfig gtkglext scons

GtkRadiant for Mac can be downloaded as a .dmg file. Just run the .dmg file and drag and drop the GtkRadiant.app to your Applications folder. Then double-click on GtkRadiant.app and wait for the program to initialize for the first time.

If using OS X 10.8 or later, you may have Gatekeeper enabled and you may receive the following message:


To override the Gatekeeper functionality for GtkRadiant, you can right-click on the GtkRadiant.app and select "Open", or follow the instructions here.


GtkRadiant for Linux comes in either 32 or 64-bit versions, make sure you download the right version for your system and extract it to the folder of your choice.

On some Linux distributions, GtkRadiant will require the installation of additional libs. You can get a list of libs that GtkRadiant requires by opening up a new Terminal session and typing in the following command:

ldd complete/path/to/GtkRadiant/radiant.bin

Once you know which libs are missing on your system, you can install them:

sudo apt-get install [missinglibname]

Here is a list of required libs for some distributions:

  • Ubuntu 10.10
    • libgtk2.0-0
    • libgtkglext1
    • libmhash2
    • zlib1g
    • zlibc
    • libpng12-0
    • libglib2.0-0
  • Ubuntu 12.04
    • In addition to the above, libjpeg62
  • Fedora
    • libxml2
    • glib2
    • gtk2
    • gtkglext-libs-1
    • mhash
    • libjpeg
    • zip
  • Open Linux (OS4)
    • None, should work as is.

Now that you have all the required dependencies installed, you can start running GtkRadiant. The executable is the file radiant.bin in your GtkRadiant folder.

  1. Open a terminal session in this folder (contextual menu "Open in Terminal" on most Linux systems).
  2. Launch the executable by drag-dropping it in the terminal window and then press the Enter key.

Optionally, you can create a bash script to make running GtkRadiant easier.

  1. Create a new text file and name it "radiant.sh".
  2. In this file, add the following lines:
  3. Save the file.
  4. Make your script executable by typing the following in Terminal:
    chmod +x path/to/your/script/radiant.sh
  5. Double-click on the script and choose to execute it.
  6. Optionally, you can also add a menu shortcut to your applications menu by right-clicking on radiant.sh and choosing the appropriate menu option.

First Start

Starting GtkRadiant for the first time, the program needs to initialize and copy game-pack files to where you installed your game. You will see a dialog box.

Game setup dialog box

In the drop down menu, you will need to specify the game you are editing for. If more than one is required, just pick the first one to set up.

Then, tell GtkRadiant where you have the game installed. For most games, you will want to point the location to either the root of your game installation directory (eg. C:\Games\Quake3\). Click the OK button to proceed.

The game selection dialog now appears. Select the game you want to use or click on "Configure more games" to set up additional games. Click OK when done.

Game setup dialog box

You should now see the GtkRadiant main interface load up. Be sure to check though the preferences to set things up to your liking. For further reading, see the Documentation section for additional guides.

Link to comment
Share on other sites

  • kate locked this topic
  • Administrators

1 / Compiling GtkRadiant on Windows

This guide explains how to compile GtkRadiant 1.6.x or newer from source code on Windows operating systems. The source code is obtained from the GtkRadiant Git repository, which is open to the public (details follow). These instructions are aimed at developers wanting to test changes to GtkRadiant source code.

Note that Windows XP is no longer supported.

This documentation may be incomplete, outdated, imprecise in some areas - we recommend dropping by the IRC channel to ask pointed questions as you work through this. If you have never done much C/C++ programming on Windows with Visual Studio, this is probably not for you.

This guide is divided into the following main sections.


Section 1: Pre-requisite software



You can also use a GUI git client, we found Sourcetree to be reasonably good.


Subversion command-line binaries from CollabNet

We use both git and svn. The svn.exe program needs to be in the path for SCons to successfully download the game packs. Download requires the creation of an account but the software is free.


Python 2.7 32bit

The build tool (scons) needs a 32 bit 2.x python. So no python 3, no x86-64. The rest of the instructions assume it was installed to C:\Python27


www.scons.org. Install the latest production release.

Visual Studio 2017 Community Edition

Download from Microsoft

Section 2: Obtaining Source Code, Game Paks, and Libs

We are now ready to get the source code for GtkRadiant.

Step A: Get Base Project

Open an Git Bash shell. When you start the shell, you will be in what is called your "home directory". You can execute the pwd command in Git Bash to find out which directory you are currently in. For example, when I start Git Bash, my current directory is /c/Users/Christian .

In any case, we need to create ourselves a work area for purposes of downloading files and compiling software. I would recommend creating a directory radiant-work in your home directory. So:

$ mkdir radiant-work

Now, we're going to change to that directory and get the base GtkRadiant project:

$ cd radiant-work
$ git clone git://github.com/TTimo/GtkRadiant.git

We created the extra radiant-work parent directory of GtkRadiant because the following step will place many files into the project's parent directory, and we don't want to litter our home directory with these files.

Step B: Execute SCons Build Target

Remember all the work we did earlier in order to install SCons? Well, thanks to all that work we did, obtaining the remaining things we need for compiling is really really easy:

Open a cmd shell and execute:

$ cd radiant-work\GtkRadiant
$ C:\Python27\Scripts\scons.bat target=setup

This SCons build target performs several actions:

  • Downloads "install paks" for several games such as Quake III Arena and Urban Terror.
  • Downloads library dependencies (such as GTK+) for building and running GtkRadiant.
  • Places library dependencies in proper locations.
  • Performs any other actions needed prior to compiling GtkRadiant.

Section 3: Compiling GtkRadiant

Open radiant.sln in Visual Studio. Select radiant in the solution explorer, right click and select Set as Startup Project.

Important: GtkRadiant.exe on Windows is a 32 bit application. Select the Release/Win32 configuration and compile. Most of the other projects are dependent modules that will be compiled implicitely as well.

Build the map compiler next: set q3map2 as the active project, select configuration Release/x64 and compile. Note that q3map2.exe is a 64 bit application this time around.


Section 4: Running GtkRadiant

All of the files needed to run GtkRadiant are going to be in the folder radiant-work\GtkRadiant\install [relative to your home directory]. You can copy the entire install folder to some place such as your Desktop and you can rename this folder to ZeroRadiant for example. Then, you will use radiant.exe in that directory to launch the application.

That's it! Good luck and thanks for reading this enhanced tutorial! More information about GtkRadiant is on gtkradiant.com/.


Link to comment
Share on other sites

  • Administrators

This directory provides packaging steps for GtkRadiant for OSX. This document describes compiling the application on OSX as well as generating distributable bundles using the framework provided in this directory.

Dependencies & Compilation
Directions for OSX Mavericks 10.9 - your mileage may vary:

Install MacPorts.

Install XQuartz

Install dependencies with MacPorts:

sudo port install dylibbundler pkgconfig gtkglext scons
Get the GtkRadiant code and compile:
git clone https://github.com/TTimo/GtkRadiant.git
cd GtkRadiant/
Run the build:
(from the GtkRadiant/ directory)

XQuartz note: on my configuration XQuartz doesn't automatically start for some reason. I have to open another terminal, and run the following command: /Applications/Utilities/XQuartz.app/Contents/MacOS/X11.bin, then start radiant.

Building GtkRadiant.app
The Makefile in the 'apple/' directory will produce a distributable .app bundle for GtkRadiant using dylibbundler:

make image
Getting help
Get on irc: Quakenet #radiant, or ask on the mailing list, or post something on the issue tracker..

Link to comment
Share on other sites

  • 1 year later...
This topic is now closed to further replies.

  • Create New...