trunk/www.linuxsampler.org/msys.html

<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head>
  <meta content="text/html; charset=ISO-8859-1"
 http-equiv="content-type">
  <title>Windows Build Instructions</title>
  <link rel="shortcut icon" href="http://download.linuxsampler.org/favicon.ico" type="image/x-icon">
  <link rel="stylesheet" type="text/css" href="libgig/css/content.css" title="content" media="all">
</head>
<body>
<h2 align="center">Windows Build Instructions &nbsp; <img src="gfx/logos/msys.png" alt="msys logo"> &nbsp; HOWTO by Andreas Persson</h2>
<br>
<center>July&nbsp;17th,&nbsp;2012</center><br>
<div style="background-color: #F4F4FF; margin: 1em 3em 1em 3em; padding: 1em 1em 1em 2.2em;">
<a href="#intro">1.&nbsp; Introduction</a><br>
<a href="#mingw">2.&nbsp; MinGW</a><br>
<a href="#gcc">3.&nbsp; gcc</a><br>
<a href="#pkg">4.&nbsp; pkg-config</a><br>
<a href="#gtkmm">5.&nbsp; gtkmm</a><br>
<a href="#asio">6.&nbsp; ASIO SDK</a><br>
<a href="#vst">7.&nbsp; VST SDK</a><br>
<a href="#intl">8.&nbsp; intltool</a><br>
<a href="#xslt">9.&nbsp; xsltproc</a><br>
<a href="#setup">10.&nbsp; MSYS setup</a><br>
<a href="#sqlite">11.&nbsp; Building SQLite</a><br>
<a href="#sndfile">12.&nbsp; Building libsndfile</a><br>
<a href="#gig">13.&nbsp; Building libgig</a><br>
<a href="#ls">14.&nbsp; Building linuxsampler</a><br>
<a href="#gigedit">15.&nbsp; Building gigedit</a><br>
</div>
<p>
<center>
<script type="text/javascript"><!--
google_ad_client = "pub-3408196773880325";
/* 728x90, created 8/3/09 */
google_ad_slot = "7744776541";
google_ad_width = 728;
google_ad_height = 90;
//-->
</script>
<script type="text/javascript"
src="http://pagead2.googlesyndication.com/pagead/show_ads.js">
</script>
</center>
</p>

<h3><a name="intro">1.&nbsp; Introduction</a></h3>

<p>This page contains instructions for building libgig, linuxsampler
and gigedit on Windows with help of MinGW and MSYS. After the MinGW
and MSYS environment and the other prerequisites are installed, the
build procedure will be the same as in Linux, that is, basically:
./configure ; make ; make install.</p>

<p>The versions of the files to download are just the ones I used when
last updating this text. You can probably use later ones if
available.</p>

<p>Some of the instructions below are marked with ***:</p>

<p>*** = only needed if you are going to build gigedit</p>


<h3><a name="mingw">2.&nbsp; MinGW</a></h3>

<p>Download the MinGW installer, mingw-get-inst-20120426.exe,
from <a href="http://www.mingw.org">www.mingw.org</a>, "Installer /
mingw-get-inst", and run it. The installer will automatically download
and install further packages. Choose the C Compiler, C++ Compiler and
MinGW Developer ToolKit.</p>


<h3><a name="gcc">3.&nbsp; gcc ***</a></h3>

<p>If you're going to build gigedit, it's important to have a gcc
version that is compatible with the libraries in the gtkmm package. I
couldn't get gigedit working with the gcc bundled in MinGW. The
MinGW-w64 project (which has compilers for both 32 and 64 bit Windows)
has one that works better. Download
from <a href="http://mingw-w64.sourceforge.net/">http://mingw-w64.sourceforge.net/</a>,
WIN32 Downloads, Personal Builds, rubenvb, release:
i686-w64-mingw32-gcc-4.5.3-release-win32_rubenvb.7z, and extract in a
directory of your choice. Add the bin directory first in PATH, for
example:</p>
<pre>export PATH=/c/MinGW-w64/mingw32/bin:$PATH</pre>


<h3><a name="pkg">4.&nbsp; pkg-config</a></h3>

<p>(You can skip this step if you're going to build gigedit, as
pkg-config is included in gtkmm.)</p>
<p>The pkg-config tool is needed by the configure script in all the
LinuxSampler packages. Download both the Tool and the Dev package
from <a href="http://www.gtk.org">www.gtk.org</a>. Extract
pkg-config_0.26-1_win32.zip and pkg-config-dev_0.26-1_win32.zip to
C:\MinGW.</p>


<h3><a name="gtkmm">5.&nbsp; gtkmm ***</a></h3>

<p>Download the gtkmm windows installer,
gtkmm-win32-devel-2.16.0-4.exe (2.16 seems to have less bugs than
2.22), from <a href="http://www.gtkmm.org">www.gtkmm.org</a>, and run
it. Let the installer adjust the PATH variable as it wants.</p>


<h3><a name="asio">6.&nbsp; ASIO SDK</a></h3>

<p>Download asiosdk2.2.zip from Steinberg. Extract it to your msys
$HOME.</p>


<h3><a name="vst">7.&nbsp; VST SDK</a></h3>

<p>If you want to build the LinuxSampler VST plugin, download
vst_sdk2_4_rev2.zip from Steinberg (note that you should not choose
version 3). Extract it to msys $HOME.</p>


<h3><a name="intl">8.&nbsp; intltool ***</a></h3>

<p>Download intltool_0.40.4-1_win32.zip from
<a href="http://ftp.gnome.org/pub/GNOME/binaries/win32/intltool">http://ftp.gnome.org/pub/GNOME/binaries/win32/intltool</a></p>

<p>Unzip this into the gtkmm directory (C:\Program Files\gtkmm)</p>


<h3><a name="xslt">9.&nbsp; xsltproc ***</a></h3>

<p>The gigedit Makefile wants to build the gigedit quick start
documentation, so it needs the xsltproc command. Download from
<a href="http://www.zlatkovic.com/pub/libxml/">http://www.zlatkovic.com/pub/libxml/</a>:</p>

<pre>libxslt-1.1.26.win32.zip</pre>

<p>Copy the contents of the bin directory from the zip file to a
directory of your choice. Add this directory last in your msys PATH,
for example:</p>

<pre>export PATH=$PATH:$HOME/xsltproc</pre>


<h3><a name="setup">10.&nbsp; MSYS setup</a></h3>

<p>*** Add the gtkmm aclocal directory to the list of extra directories
used by autoconf. (Make sure the gtkmm path is the one where you
installed it. The space in "Program Files" causes problems, so the
short file name form is used here):</p>

<pre>echo "/c/Progra~1/gtkmm/share/aclocal" >> /mingw/share/aclocal/dirlist</pre>

<p>*** Add the gtkmm bin directory first in your PATH (the installer has
already added gtkmm to the PATH, but it may have used "Program Files"
with a space in it, which causes configure to fail):</p>

<pre>export PATH=/c/Progra~1/gtkmm/bin:$PATH</pre>


<p>Make sure pkg-config will find the libraries you build:</p>

<pre>export PKG_CONFIG_PATH=/usr/local/lib/pkgconfig</pre>


<p>*** The intltool scripts expect perl to be in /opt/perl/bin, so
make a link to the real perl.exe:</p>

<pre>mkdir -p /opt/perl/bin
ln -s /bin/perl.exe /opt/perl/bin</pre>


<p>*** The gettext configure tools need:</p>

<pre>export CPPFLAGS="-I/c/Progra~1/gtkmm/include"
export LDFLAGS="-L/c/Progra~1/gtkmm/lib"</pre>


<h3><a name="sqlite">11.&nbsp; Building SQLite</a></h3>

<p>The windows precompiled version of SQLite doesn't include the
neccessary development files, so it's best to build SQLite yourself.
Download sqlite-autoconf-3071300.tar.gz
from <a href="http://www.sqlite.org">www.sqlite.org</a> and extract it
to your $HOME:</p>

<pre>cd
tar xf sqlite-autoconf-3071300.tar.gz</pre>

<p>Build and install:</p>

<pre>cd sqlite-autoconf-3071300
./configure
make
make install</pre>


<h3><a name="sndfile">12.&nbsp; Building libsndfile</a></h3>

<p>The windows precompiled version of libsndfile doesn't include the
neccessary pkg-config file, so it's best to build libsndfile
yourself. Download libsndfile-1.0.25.tar.gz
from <a href="http://www.mega-nerd.com/libsndfile/">www.mega-nerd.com</a> and
extract it to your $HOME:</p>

<pre>cd
tar xf libsndfile-1.0.25.tar.gz</pre>

<p>Build and install:</p>

<pre>cd libsndfile-1.0.25
./configure
make
make install</pre>


<h3><a name="gig">13.&nbsp; Building libgig</a></h3>

<p>Just use the same commands as you would in linux:</p>

<pre>make -f Makefile.cvs    (if you build from Subversion)
./configure             (add any configuration parameters as you wish)
make
make install</pre>


<h3><a name="ls">14.&nbsp; Building linuxsampler</a></h3>

<pre>make -f Makefile.cvs    (if you build from Subversion)
./configure --enable-asiosdk-dir=$HOME --enable-vstsdk-dir=$HOME/vstsdk2.4
make
make install</pre>


<h3><a name="gigedit">15.&nbsp; Building gigedit</a></h3>

<pre>make -f Makefile.cvs    (if you build from Subversion)
./configure
make
make install</pre>
</body>
</html>
1	persson	1807	<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
2			<html>
3			<head>
4			<meta content="text/html; charset=ISO-8859-1"
5			http-equiv="content-type">
6			<title>Windows Build Instructions</title>
7			<link rel="shortcut icon" href="http://download.linuxsampler.org/favicon.ico" type="image/x-icon">
8			<link rel="stylesheet" type="text/css" href="libgig/css/content.css" title="content" media="all">
9			</head>
10			<body>
11			<h2 align="center">Windows Build Instructions   <img src="gfx/logos/msys.png" alt="msys logo">   HOWTO by Andreas Persson</h2>
12			<br>
13	persson	2357	<center>July 17th, 2012</center><br>
14	persson	1807	<div style="background-color: #F4F4FF; margin: 1em 3em 1em 3em; padding: 1em 1em 1em 2.2em;">
15			<a href="#intro">1.  Introduction</a><br>
16			<a href="#mingw">2.  MinGW</a><br>
17	persson	2357	<a href="#gcc">3.  gcc</a><br>
18			<a href="#pkg">4.  pkg-config</a><br>
19			<a href="#gtkmm">5.  gtkmm</a><br>
20			<a href="#asio">6.  ASIO SDK</a><br>
21			<a href="#vst">7.  VST SDK</a><br>
22			<a href="#intl">8.  intltool</a><br>
23	persson	1807	<a href="#xslt">9.  xsltproc</a><br>
24			<a href="#setup">10.  MSYS setup</a><br>
25	persson	1918	<a href="#sqlite">11.  Building SQLite</a><br>
26			<a href="#sndfile">12.  Building libsndfile</a><br>
27			<a href="#gig">13.  Building libgig</a><br>
28			<a href="#ls">14.  Building linuxsampler</a><br>
29			<a href="#gigedit">15.  Building gigedit</a><br>
30	persson	1807	</div>
31	senoner	1983	<p>
32			<center>
33			<script type="text/javascript"><!--
34			google_ad_client = "pub-3408196773880325";
35			/* 728x90, created 8/3/09 */
36			google_ad_slot = "7744776541";
37			google_ad_width = 728;
38			google_ad_height = 90;
39			//-->
40			</script>
41			<script type="text/javascript"
42			src="http://pagead2.googlesyndication.com/pagead/show_ads.js">
43			</script>
44			</center>
45			</p>
46	persson	1807
47			<h3><a name="intro">1.  Introduction</a></h3>
48
49	persson	2357	<p>This page contains instructions for building libgig, linuxsampler
50			and gigedit on Windows with help of MinGW and MSYS. After the MinGW
51			and MSYS environment and the other prerequisites are installed, the
52			build procedure will be the same as in Linux, that is, basically:
53	persson	1807	./configure ; make ; make install.</p>
54
55	persson	2357	<p>The versions of the files to download are just the ones I used when
56			last updating this text. You can probably use later ones if
57	persson	1807	available.</p>
58
59	persson	2357	<p>Some of the instructions below are marked with ***:</p>
60	persson	1807
61			<p>*** = only needed if you are going to build gigedit</p>
62
63
64			<h3><a name="mingw">2.  MinGW</a></h3>
65
66	persson	2357	<p>Download the MinGW installer, mingw-get-inst-20120426.exe,
67			from <a href="http://www.mingw.org">www.mingw.org</a>, "Installer /
68			mingw-get-inst", and run it. The installer will automatically download
69			and install further packages. Choose the C Compiler, C++ Compiler and
70			MinGW Developer ToolKit.</p>
71	persson	1807
72
73	persson	2357	<h3><a name="gcc">3.  gcc ***</a></h3>
74	persson	1807
75	persson	2357	<p>If you're going to build gigedit, it's important to have a gcc
76			version that is compatible with the libraries in the gtkmm package. I
77			couldn't get gigedit working with the gcc bundled in MinGW. The
78			MinGW-w64 project (which has compilers for both 32 and 64 bit Windows)
79			has one that works better. Download
80			from <a href="http://mingw-w64.sourceforge.net/">http://mingw-w64.sourceforge.net/</a>,
81			WIN32 Downloads, Personal Builds, rubenvb, release:
82			i686-w64-mingw32-gcc-4.5.3-release-win32_rubenvb.7z, and extract in a
83			directory of your choice. Add the bin directory first in PATH, for
84			example:</p>
85			<pre>export PATH=/c/MinGW-w64/mingw32/bin:$PATH</pre>
86	persson	1807
87
88	persson	2357	<h3><a name="pkg">4.  pkg-config</a></h3>
89	persson	1807
90	persson	2357	<p>(You can skip this step if you're going to build gigedit, as
91			pkg-config is included in gtkmm.)</p>
92			<p>The pkg-config tool is needed by the configure script in all the
93			LinuxSampler packages. Download both the Tool and the Dev package
94			from <a href="http://www.gtk.org">www.gtk.org</a>. Extract
95			pkg-config_0.26-1_win32.zip and pkg-config-dev_0.26-1_win32.zip to
96			C:\MinGW.</p>
97	persson	1807
98
99	persson	2357	<h3><a name="gtkmm">5.  gtkmm ***</a></h3>
100	persson	1807
101	persson	2357	<p>Download the gtkmm windows installer,
102			gtkmm-win32-devel-2.16.0-4.exe (2.16 seems to have less bugs than
103			2.22), from <a href="http://www.gtkmm.org">www.gtkmm.org</a>, and run
104			it. Let the installer adjust the PATH variable as it wants.</p>
105	persson	1807
106	persson	2056
107	persson	2357	<h3><a name="asio">6.  ASIO SDK</a></h3>
108	persson	2056
109	persson	1807	<p>Download asiosdk2.2.zip from Steinberg. Extract it to your msys
110			$HOME.</p>
111
112
113	persson	2357	<h3><a name="vst">7.  VST SDK</a></h3>
114	persson	1807
115			<p>If you want to build the LinuxSampler VST plugin, download
116			vst_sdk2_4_rev2.zip from Steinberg (note that you should not choose
117			version 3). Extract it to msys $HOME.</p>
118
119
120	persson	2357	<h3><a name="intl">8.  intltool ***</a></h3>
121	persson	1807
122			<p>Download intltool_0.40.4-1_win32.zip from
123			<a href="http://ftp.gnome.org/pub/GNOME/binaries/win32/intltool">http://ftp.gnome.org/pub/GNOME/binaries/win32/intltool</a></p>
124
125	persson	1949	<p>Unzip this into the gtkmm directory (C:\Program Files\gtkmm)</p>
126	persson	1807
127
128			<h3><a name="xslt">9.  xsltproc ***</a></h3>
129
130			<p>The gigedit Makefile wants to build the gigedit quick start
131			documentation, so it needs the xsltproc command. Download from
132	persson	1949	<a href="http://www.zlatkovic.com/pub/libxml/">http://www.zlatkovic.com/pub/libxml/</a>:</p>
133	persson	1807
134	persson	2056	<pre>libxslt-1.1.26.win32.zip</pre>
135	persson	1807
136	persson	2056	<p>Copy the contents of the bin directory from the zip file to a
137	persson	1807	directory of your choice. Add this directory last in your msys PATH,
138			for example:</p>
139
140			<pre>export PATH=$PATH:$HOME/xsltproc</pre>
141
142
143			<h3><a name="setup">10.  MSYS setup</a></h3>
144
145	persson	2357	<p>*** Add the gtkmm aclocal directory to the list of extra directories
146	persson	1811	used by autoconf. (Make sure the gtkmm path is the one where you
147			installed it. The space in "Program Files" causes problems, so the
148			short file name form is used here):</p>
149	persson	1807
150	persson	1949	<pre>echo "/c/Progra~1/gtkmm/share/aclocal" >> /mingw/share/aclocal/dirlist</pre>
151	persson	1807
152	persson	2357	<p>*** Add the gtkmm bin directory first in your PATH (the installer has
153	persson	1811	already added gtkmm to the PATH, but it may have used "Program Files"
154			with a space in it, which causes configure to fail):</p>
155	persson	1807
156	persson	1811	<pre>export PATH=/c/Progra~1/gtkmm/bin:$PATH</pre>
157
158	persson	2357
159	persson	1949	<p>Make sure pkg-config will find the libraries you build:</p>
160	persson	1807
161			<pre>export PKG_CONFIG_PATH=/usr/local/lib/pkgconfig</pre>
162
163
164			<p>*** The intltool scripts expect perl to be in /opt/perl/bin, so
165	persson	2357	make a link to the real perl.exe:</p>
166	persson	1807
167			<pre>mkdir -p /opt/perl/bin
168	persson	2357	ln -s /bin/perl.exe /opt/perl/bin</pre>
169	persson	1807
170
171	persson	2357	<p>*** The gettext configure tools need:</p>
172	persson	1807
173	persson	1811	<pre>export CPPFLAGS="-I/c/Progra~1/gtkmm/include"
174			export LDFLAGS="-L/c/Progra~1/gtkmm/lib"</pre>
175	persson	1807
176
177	persson	1918	<h3><a name="sqlite">11.  Building SQLite</a></h3>
178	persson	1807
179	persson	1918	<p>The windows precompiled version of SQLite doesn't include the
180			neccessary development files, so it's best to build SQLite yourself.
181	persson	2357	Download sqlite-autoconf-3071300.tar.gz
182			from <a href="http://www.sqlite.org">www.sqlite.org</a> and extract it
183			to your $HOME:</p>
184	persson	1918
185			<pre>cd
186	persson	2357	tar xf sqlite-autoconf-3071300.tar.gz</pre>
187	persson	1918
188			<p>Build and install:</p>
189
190	persson	2357	<pre>cd sqlite-autoconf-3071300
191			./configure
192	persson	1918	make
193			make install</pre>
194
195
196			<h3><a name="sndfile">12.  Building libsndfile</a></h3>
197
198	persson	1807	<p>The windows precompiled version of libsndfile doesn't include the
199			neccessary pkg-config file, so it's best to build libsndfile
200	persson	2357	yourself. Download libsndfile-1.0.25.tar.gz
201	persson	1807	from <a href="http://www.mega-nerd.com/libsndfile/">www.mega-nerd.com</a> and
202			extract it to your $HOME:</p>
203
204			<pre>cd
205	persson	2357	tar xf libsndfile-1.0.25.tar.gz</pre>
206	persson	1807
207	persson	1861	<p>Build and install:</p>
208	persson	1807
209	persson	2357	<pre>cd libsndfile-1.0.25
210	persson	1861	./configure
211	persson	1807	make
212			make install</pre>
213
214
215	persson	1918	<h3><a name="gig">13.  Building libgig</a></h3>
216	persson	1807
217			<p>Just use the same commands as you would in linux:</p>
218
219	persson	2357	<pre>make -f Makefile.cvs (if you build from Subversion)
220	persson	1807	./configure (add any configuration parameters as you wish)
221			make
222			make install</pre>
223
224
225	persson	1918	<h3><a name="ls">14.  Building linuxsampler</a></h3>
226	persson	1807
227	persson	2357	<pre>make -f Makefile.cvs (if you build from Subversion)
228	persson	1807	./configure --enable-asiosdk-dir=$HOME --enable-vstsdk-dir=$HOME/vstsdk2.4
229			make
230			make install</pre>
231
232
233	persson	1918	<h3><a name="gigedit">15.  Building gigedit</a></h3>
234	persson	1807
235	persson	2357	<pre>make -f Makefile.cvs (if you build from Subversion)
236	persson	1807	./configure
237			make
238			make install</pre>
239			</body>
240			</html>