Created building (markdown)

building.md

@@ -0,0 +1,31 @@
+# building
+this document describes to how compile musikcube (and musikbox) on all supported platforms
+
+## windows
+
+- grab the [Visual Studio 2017 Community Edition](https://www.visualstudio.com/en-us/downloads/download-visual-studio-vs.aspx) and install the 32-bit c++ compiler.
+- clone the musikcube sources: `git clone https://github.com/clangen/musikcube.git`
+- install the [32 bit version of boost 1.64](https://sourceforge.net/projects/boost/files/boost-binaries/1.64.0/boost_1_64_0-msvc-14.1-32.exe/download). ensure it shares the same parent directory with musikcube. e.g: `c:\src\musikcube` and `c:\src\boost_1_64_0` -- the project's solution will reference it via relative path.
+- open `musikcube.sln` and build/run. 
+
+## mac
+
+you'll need [homebrew](http://brew.sh/) to install the required dependencies. 
+
+- `brew install cmake boost libogg libvorbis flac faad2 libmicrohttpd lame`
+- `git clone https://github.com/clangen/musikcube.git`
+- `cd musikcube`
+- `cmake .`
+- `make`
+- `cd bin`
+- `./musikbox`
+
+## linux
+
+- install the following libraries and their development packages: `cmake boost libogg vorbis flac faad2 ncurses zlib asound pulse libcurl libmicrohttpd libmp3lame`
+- `git clone https://github.com/clangen/musikcube.git`
+- `cd musikcube`
+- `cmake .`
+- `make`
+- `sudo make install`
+- `musikbox`