Compilation Instructions

From Musik

Table of contents

Downloading the source

The way to get your hands on the latest, bleeding edge, SVN source you first need an SVN client for Windows. Personally I've only tried TortoiseSVN and it seems to work out just fine but you can use anything you'd like. This tutorial, however is only going to explain how to use TortoiseSVN. Get Tortoise here: [1] (http://tortoisesvn.tigris.org/). Once you've got it installed you'll have a few new options in your right-click menu in Explorer.

Create a folder anywhere you'd like, we'll say the desktop, and call it musikSVN for continuty's sake. Open the folder and then right-click. Select the SVN Checkout... option and a new window will pop up. This dialog is pretty straight forward so lets put in http://svn.clangen.org/musikCube for the "URL of repository" box and leave "Checkout directory" alone since it should be the new folder you created. Ignore the two options below that and select HEAD revision to grab the latest source. Hit OK and it'll throw a warning about the SSL certificate. Since we know its safe we can accept it and then wait for the source to roll in. After it completes hit OK. Your source will be under the trunk directory in your musikSVN directory.

Compiling with Visual Studio .NET 2005

This is the easiest way to compile musikCube as the source includes a nice and easy solution file to load into Visual Studio. The rest of this document assumes you have VS2005 ready to use.

Setting the Windows Media Format dependency

You'll need an external dependency called Windows Media Format SDK, you can get it here (http://download.microsoft.com/download/a/c/3/ac367925-39e7-4451-a175-a224f94fbdce/wmformat11sdk.exe).

Once it's installed you need to set up Visual Studio to use it. Via Tools > Options > Projects and solutions > VC++ directories add the paths for Include files and Library files.

Compiling the code

Open the mcProjects.sln solution file. It's the main solution containing all the projects of the application.

Go to the toolbar and select the Release build and then simply hit F7 (Build) and wait for the compilation to finish. There WILL be warnings when compiling, quite a few actually, so don't worry about it. It's when you hit an error that you have to worry. With the Debug build, there should be no errors, but for some reason I haven't quite worked out yet with the Release build, there are errors in the import and export playlist projects. Do not worry about these - they are only plugins and do not affect the build of the main program so you can remove them from the list of project to build with the Configuration Manager.

Gathering the files

After the application compiled successfully you'll have to gather all the executable code and data needed to run the application. The gather_files.bat file located in the build directory will put all the required files in the output directory (which will be located in the build directory) and you should be able to run the program from there. If you want to put the compiled program to a different directory than build/bin directory, you'll need to copy all the dlls and other files in that directory with it.

Compiling without Visual Studio

To prevent duplication in the wiki I'll just reference you to this article here:

Compiling Without Visual Studio 2003