1# building liquidsfz under windows
2
3## install a suitable compiler
4
5Compiling was tested with gcc using the online installer from
6
7 * https://sourceforge.net/projects/mingw-w64/files
8
9within the installer, select
10
11 * version `8.1.0`
12 * architecture `x86_64`
13 * threads `posix`
14 * exception `seh`
15 * build revision `0`
16
17it is likely that other compilers could also work. If you need changes to build
18with another compiler, please report it as a github issue.
19
20## cmake
21
22We assume that cmake is also installed and working, and in the PATH.
23
24## preparing the liquidsfz source code
25
26The source code can be downloaded from github. For this document we assume that
27the folder containing the master branch of liquidsfz was extracted to
28`C:\src\liquidsfz-master`
29
30Since cmake support is still experimental, the file in the repository is called
31`testCMakeLists.txt`. You need to rename it before building:
32
33    C:\src\liquidsfz-master> ren testCMakeLists.txt CMakeLists.txt
34
35## installing libsndfile
36
37Also from github, you can get it from here:
38
39* https://github.com/libsndfile/libsndfile/releases/download/v1.0.30/libsndfile-1.0.30-win64.zip
40
41extract the folder so that there is a new subfolder: `C:\src\liquidsfz-master\libsndfile-1.0.30-win64`
42
43## building
44
45Run `mingw-w64.bat`, in a typical installation
46
47    C:\Program Files\mingw-w64\x86_64-8.1.0-posix-seh-rt_p6-rev0\mingw-v64.bat
48
49To build, go to the liquidsfz source folder and use the following commands
50
51    C:\src\liquidsfz-master> mkdir build
52    C:\src\liquidsfz-master> cd build
53    C:\src\liquidsfz-master\build> cmake -G"MinGW Makefiles" .. -DCMAKE_PREFIX_PATH=C:\src\liquidsfz-master\libsndfile-1.0.30-win64
54    C:\src\liquidsfz-master\build> mingw32-make
55