= Windows with MingW = 
[[TOC(heading=Platforms, depth=1, WindowsMinGW, VisualStudio, LinuxGentoo, LinuxDebian, LinuxUbuntu, LinuxTardis)]]

== MinGW ==
Download and install the [http://svn.orxonox.net/webdev/develop/win32/dev/MinGW_Toolbox_Setup_wr1.exe MinGW package]. Usually MinGW is installed to {{{c:\mingw}}}


== MSYS ==
Download the MSYS Installer from sourceforge: [http://svn.orxonox.net/webdev/develop/win32/dev/MSYS-1.0.10.exe Download] [[br]]
MSYS (Minimal SYStem) is a software port of the Unix-Shell to Windows. It's used by MinGW-Developers as a minimal system which can, for example, execute configure-scripts.
 1. Install MSYS into another path than MinGW
 1. During the installation process answer yes (y) twice
 1. Specify the path of the MinGW directory (most probably this will be {{{c:/mingw}}}).

Switch to the home-directory of your MSYS installation: {{{c:\<msys-install-path>\home\<username>\}}}[[br]]
This is your homedirectory in MSYS, this is where the action takes place.

'''In the following, we'll call this directory {{{c:\<msys-homedir>\}}} to make things shorter.'''


== SVN ==
To use [wiki:SVN] on your system we recommend TortoiseSVN, a very useful GUI-version. [http://tortoisesvn.net/downloads Download]

TortoiseSVN is a shell extension. You can use it within Windows Explorer, which is very practical. Most options are available through the context menu (right mouse button).


== Get the source ==
Check out the Orxonox-repository from {{{https://svn.orxonox.net/orxonox/trunk/}}} into a folder named 'trunk', for example {{{c:\<msys-homedir>\trunk\}}}. '''It's very important to use a directory inside your MSYS homedirectory, otherwise you can't compile.'''
 * URL: {{{https://svn.orxonox.net/orxonox/trunk/}}}
 * Checkout directory: {{{c:\<msys-homedir>\trunk\}}}

In TortoiseSVN this is done by right clicking into {{{c:\<msys-homedir>\}}} and chosing "SVN checkout...". Then set the URL of the repository to {{{https://svn.orxonox.net/orxonox/trunk/}}} and the checkout directory to {{{c:\<msys-homedir>\trunk\}}} (checkout depth should be "Fully recursive" and revision "HEAD").
Accept the certificate and enter your username and password in the authentication form (only if it's the first time you check out code from our server).

If you're not using TortoiseSVN, use the "svn co repository directory" command. See [wiki:SVN] for more information.

Now do the same with the media repository:
 * URL: {{{https://svn.orxonox.net/data/media}}}
 * Checkout directory: {{{c:\<msys-homedir>\media}}}

Now you should have the following directories in your home:
{{{
c:\<msys-homedir>\media
c:\<msys-homedir>\trunk
}}}


== Dependencies ==
Download the Orxonox dependencies: [http://svn.orxonox.net/ogre/precompiled_dependencies/OrxonoxDeps_090303_MinGW.7z Download] (get 7-Zip [http://www.7-zip.org/ here]).[[br]]
Extract the archive into {{{c:\<msys-homedir>\}}}

Now you should have the following directories in your home:
{{{
c:\<msys-homedir>\dependencies
c:\<msys-homedir>\media
c:\<msys-homedir>\trunk
}}}


== CMake ==
Now we can build Orxonox. To do so, we need CMake. CMake is a cross-platform system for build automation. Download the latest binary release from [http://cmake.org/HTML/Download.html here] and install it.
 * '''While installing check the option to add CMake to the system PATH'''

Open the MSYS console, change into your trunk folder and create an output directory for the binaries:
{{{
$ cd trunk
$ mkdir build
$ cd build
}}}
Then create a shortcut to save some typing:
{{{
$ echo "cmake .. -G \"MSYS Makefiles\"" > cm
}}}
This script will invoke CMake and create the Makefiles.

== Building Orxonox ==
Type the following into the MSYS console:
{{{
#!html
<pre class="wiki">
$ ./cm <i><small>(the file we created just before)</small></i>
$ make
</pre>
}}}
The first command will check your system (and the dependency directory) for all needed libraries, create the configuration and generate the makefiles. The second command builds Orxonox. If you have a multicore CPU, use "make -j3" instead of just "make". If you get an error while executing one of those steps, report it in the [http://forum.orxonox.net/ Forum] or ask us in [irc://irc.orxonox.net/orxonox IRC].

Compiling will take some time (CMake shows you the percentage). Be patient.[[br]]

If everything worked fine, start Orxonox with {{{c:\<msys-homedir>\trunk\build\run.bat}}}