trunk/www.linuxsampler.org/windows.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>LinuxSampler For Windows</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><center>LinuxSampler for Windows &nbsp; <img src="gfx/logos/windows.png"> &nbsp; HOWTO by Benno Senoner&nbsp;</center></h2>
<br>
<center>December&nbsp;18th,&nbsp;2007</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="#requirements">2.&nbsp; Requirements</a><br>
3.&nbsp; Installation ...<br>
<a href="#install_w_inet">&nbsp;&nbsp;&nbsp;&nbsp;3.a&nbsp; with Internet Connection</a><br>
<a href="#install_wo_inet">&nbsp;&nbsp;&nbsp;&nbsp;3.b&nbsp; without Internet</a><br>
<a href="#using">4.&nbsp; Using the Applications</a><br>
<a href="#setup_midi">&nbsp;&nbsp;&nbsp;&nbsp;4.1&nbsp; Setting up MIDI Input</a><br>
<a href="#setup_audio">&nbsp;&nbsp;&nbsp;&nbsp;4.2&nbsp; Setting up Audio Output</a><br>
<a href="#load_samples">&nbsp;&nbsp;&nbsp;&nbsp;4.3&nbsp; Loading Samples</a><br>
<a href="#save_session">&nbsp;&nbsp;&nbsp;&nbsp;4.4&nbsp; Saving a Sampler Session</a><br>
<a href="#sequencer_routing">&nbsp;&nbsp;&nbsp;&nbsp;4.5&nbsp; Routing LinuxSampler Outs Into Sequencer</a><br>
<a href="#houston">5.&nbsp; Installation Troubleshooting</a><br>
<a href="#docs">6.&nbsp; Detailed Documentation</a><br>
<a href="#bugs">7.&nbsp; Bugs, Problems and Feature Requests</a><br>
<a href="#contact">8.&nbsp; Contact</a><br>
</div>

<a name="intro"></a>
<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>1.&nbsp; Introduction</h3>
The LinuxSampler development team is happy to announce that
LinuxSampler, the most advanced free, open source sampler finally runs on
MS Windows too. More information will be added here soon, so check back frequently.<br>
<br>
For now the sampler supports the Windows Multimedia Extensions System (MME)
for MIDI input and ASIO for audio out. This means it currently runs only
as a standalone application. A VST interface will follow soon, along with
a network module to run multiple sampler slaves distributed on Windows or
Linux machines (Linux provides better performance) all controlled from a
Windows box i.e. running the VST sequencer.<br>
<br>
LinuxSampler is implemented as a client/server application. This means
the sampling engine (the server / backend) runs
independently from the GUI (the client / frontend). Sampling engine and
client can be run on the same box or on different machines too, connected
over the network.<br>
<br>
The MS Windows version provides all the features of the Linux version
(except of the instruments DB feature yet) since it is built from the
same source code base. This means when new features will come out the
Windows version will usually provide the same feature set as the Linux
version. This was made possible by the very modular design of both
low level, operating system functions and flexible audio / MIDI driver
system.<br>
<br>
The Windows version comes as a self extracting .exe file which will
install all the necessary modules to run both the server ( linuxsampler.exe )
and the GUI client. It installs 2 GUI clients:
<ul>
  <li>One is <b>QSampler</b>, a light-weight frontend based on the
      cross-platform Qt4 GUI toolkit with native OS GUI widgets</li>
  <li>Another is <b>JSampler "Fantasia"</b>, a Java based GUI client called,
      providing a modern skin-based user interface</li>
</ul>
At the moment JSampler is more advanced than QSampler as it implements all
the functionality present in the LinuxSampler engine. Due to the Java
virtual machine however it occupies a bit more RAM than the
QSsampler GUI (around 30MB or so) and takes a bit longer for startup,
but on a 1GB+ RAM box the difference should be negligible.

<a name="requirements"></a>
<h3>2.&nbsp; Requirements</h3>
<ul>
  <li>Intel Pentium4 or recent AMD processor (use
    <a href="#old_cpu_workaround">this workaround for older processors</a>)
  <li>Windows 2000, ME, XP or Vista</li>
  <li><a href="http://www.gtk.org/">GTK+</a> (<a href="http://downloads.sourceforge.net/gladewin32/gtk-2.10.11-win32-1.exe?modtime=1175123376&big_mirror=0">version 2.10.11</a>)</li>
  <li><a href="http://www.gtkmm.org/">gtkmm</a> (<a href="http://ftp.gnome.org/pub/gnome/binaries/win32/gtkmm/2.10/gtkmm-win32-runtime-2.10.11-1.exe">version 2.10.11</a>)</li>
  <li><a href="http://en.wikipedia.org/wiki/Java_(Sun)">Java Runtime Environment</a> (<a href="http://www.java.com/getjava/">version 6</a>)</a></li>
  <li>sound card with <a href="http://en.wikipedia.org/wiki/Audio_Stream_Input/Output">ASIO</a> driver</li>
</ul>
<a name="asio_tip"></a>
<b>Tip:</b> For consumer audio cards which do not come with their own ASIO
drivers you can install <a href="http://www.asio4all.com/">ASIO4ALL</a> to be
able to use LinuxSampler with your soundcard.
We recommend to use version 2.7, perhaps on Vista 2.8beta1 works better but
we did not perform tests on Vista so we cannot tell it. Please let us know
about your results so we can share them here!

<a name="install_w_inet"></a>
<h3>3.a&nbsp; Installation with Internet Connection</h3>
Simply download the latest version of the LinuxSampler Windows installer
from the <a href="http://www.linuxsampler.org/downloads.html">LinuxSampler
Download Page</a>, execute the installer and follow the instructions. It will
automatically detect if the required software components are already installed.
If not, it will download them from the internet and install them on your
computer.

<a name="install_wo_inet"></a>
<h3>3.b&nbsp; Installation without Internet</h3>
First download the required components with a machine which has connection to
the internet:
<ul>
  <li><a href="http://downloads.sourceforge.net/gladewin32/gtk-2.10.11-win32-1.exe?modtime=1175123376&big_mirror=0">gtk+ 2.10.11</a></li>
  <li><a href="http://ftp.gnome.org/pub/gnome/binaries/win32/gtkmm/2.10/gtkmm-win32-runtime-2.10.11-1.exe">gtkmm 2.10.11</a></li>
  <li><a href="http://www.java.com/getjava/">Java Runtime Environment 6</a></li>
  <li>and of course the latest <a href="http://www.linuxsampler.org/downloads.html">
     LinuxSampler Windows installer</a></li>
</ul>
Transfer the downloaded files to the computer where you want to install
LinuxSampler and install them in the following order:
<ol>
  <li>gtk-2.10.11-win32-1.exe</li>
  <li>gtkmm-win32-runtime-2.10.11-1.exe</li>
  <li>jre-6u2-windows-i586-p.exe</li>
  <li>linuxsampler_20071207_setup.exe</li>
</ol>
The order is important, since the components depend on each other and would
otherwise try to download the missing component from the internet.

<a name="using"></a>
<h3>4.&nbsp; Using the Applications</h3>
Now that we installed everything, let's get wet and start the applications:
<ol>
  <li>First start the LinuxSampler backend: Click on <i>"Start" ->
      "LinuxSampler" -> "LinuxSampler 0.5.1 (backend)"</i>. A black console
      window should immediately popup. It does what you think it does:
      nothing ... yet ... because this is "just" the raw sampler, without a
      user interface.</li>
  <li>Now start a "frontend" application to actually control the previously
      started sampler. For beginners and / or unpatient people, we recommend
      you to use JSampler: Click on <i>"Start" -> "LinuxSampler" ->
      "JSampler 'Fantasia' 0.8a (frontend)"</i>. This usually takes about
      20 seconds or so until the application finally appears on the
      screens.</li>
</ol>
</div>

<a name="setup_midi"></a>
<h3>4.1&nbsp; Setting up MIDI Input</h3>
Once the GUI opens, click on the left round button in the MIDI devices
tab.
At this point a window will open where you can create a new MIDI device.
Press Create. The window will close and the MIDI device will be created.
(MIDI Device 0 MME).
Now click on the right arrow which points downwards.
You can see that a MIDI device with a single Port (Port 0) was created.
Under Windows MME LinuxSampler always creates MIDI devices which are
connected to a single MME port.
To select the MIDI input port you must click on the field located on
the left of PORT.
A combobox pops-up where you can select the Windows MIDI port.<br>
<br>
You can create an arbitrary number of MIDI input devices by repeating
the procedure above.
Each MIDI input device is connected to a single Windows MME MIDI port.
This means LinuxSampler has no limitation in terms of number of MIDI
ports.
Each MIDI device can be routed to arbitrary sampler channels.

<a name="setup_audio"></a>
<h3>4.2&nbsp; Setting up Audio Output</h3>
LinuxSampler currently only supports the ASIO driver model for audio output
on Windows. ASIO drivers ensure reliable low-latency operation and are
virtually available for any soundcard (see <a href="#asio_tip">
ASIO requirements tip</a>).<br>
<br>
Click on the left round button in the Audio Devices tab.
At this point a window will open where you can create a new MIDI device.
When creating the Audio device you can set several parameters:
<ul>
  <li><b>CARD</b> : The name of the soundcard, in case you have multiple cards
      installed. It will show the default value (first card found).</li>
  <li><b>CHANNELS</b> : Number of audio output channels, can range from 1 to
      maximum number of channels your soundcard supports. We recommend to
      leave the default value which is the maximum number of channels your
      soundcard supports.</li>
  <li><b>FRAGMENTSIZE</b> : ASIO buffer size in samples. The card's default
      value is shown. If you experience clicks and pops during audio
      playback then initialize the audio output device with bigger values.
      (better if it's always a power of 2:&nbsp; e.g. 256, 512, 1024)</li>
  <li><b>SAMPLERATE</b> : Sets the samplerate. The default value is shown.<br>
</ul>
Now Press "Create". The window will close and the Audio device will be
created: "AUDIO DEVICE 0 (ASIO)" appears.

<a name="load_samples"></a>
<h3>4.3&nbsp; Loading Samples</h3>
In the middle of the screen below the volume slider, you see the sampler
channel strip pane. press on the round button located on the left.
This will create a new sampler channel. Click on "Load Instrument".
This opens a dialog which allows you to select an instrument to be
loaded in the sampler channel

(for information on how to use "orchestras" <a
 href="http://www.linuxsampler.org/jsampler/manual/html/jsampler.html#USING_ORCHESTRAS">click
here</a>, but note: orchestras, a.k.a "instruments database" is not yet supported in this
first Windows version of LinuxSampler, but will certainly be on the next Windows release).

On the row&nbsp; "Select instrument from file" click on the orange icon
located on the right side. This opens a file dialog which allows you to
select a sample to be loaded
(currently only the GIG format is supported).
Select the sample to be loaded and then click on "Open".
At this point the fields Instrument file shows the filename.
You can click on the Instrument index and select the specific
instrument contained in the instrument file. Now press "OK".<br>
<br>
While it loads you see: "Loading" .. "90%" .. "100%" <br>
<br>
Once loaded, you see the Instrument's name: i.e.&nbsp;"FreePiano"<br>
<br>
On the left side of the sampler channel click on the arrow below
"Options".
This pane permits to set MIDI input device, port and channel and oudio
output channel.
Notice that under Windows MME the Port value is always 0.
So the only values you can change is "MIDI device" (normally 0 if you
created only a single
MIDI input device) and the MIDI channel (from 1 to 16).

<a name="save_session"></a>
<h3>4.4&nbsp; Saving a Sampler Session</h3>
Click on the 3rd icon from the left on the row where you see the round
icon with the LinuxSampler "S"-shape logo.
Now select the directory where you want to save the file to (extension
.lscp = <i>Linux Sampler Control Protocol</i>).
Enter the name and press save (add .lscp at end of file otherwise you
will not see it in the file-open dialog later, when you want to load it again).<br>
<br>
Next time you can load a sampler session by clicking on the second icon
from the left, then select a .lscp file in the file dialog and press "Open".
This will automatically set up the MIDI devices and audio devices,
create the sampler channels and load all the samples that were previously
loaded by you in the saved sampler session.

<a name="sequencer_routing"></a>
<h3>4.5&nbsp; Routing LinuxSampler Outs Into Sequencer</h3>
LinuxSampler currently lacks a VST interface so the only way to route LinuxSampler's outs into a sequencer
are either by using physical cables or internal routing via ASIO. Some audio cards offer this feature.
<br>
The <a href="http://www.reaper.fm">Reaper</A> sequencer allows ASIO routing by implementing a virtual
ASIO based driver independently from the soundcard type (ReaRoute). Basically in LinuxSampler you select the ReaRoute  as ASIO output driver which
appear as input ports in Reaper. Coupled with the MIDI controllable FX sends in LinuxSampler you can use
Reaper's FX egine to add reverb, chorus etc to LinuxSampler instruments, fully MIDI controllable, similar to
other MIDI based modules.
<br>
Our forum user moonskin (thanks Graham!) has described the steps needed to perform in order to set up the routing.
<a href="http://bb.linuxsampler.org/viewtopic.php?f=6&t=111&sid=d745353791f6cb1ef46946af4168aada&start=10#p944">
See here</a>


<a name="houston"></a>
<h3>5.&nbsp; Installation Troubleshooting</h3>
<ul>
  <li>
    <div style="background-color: #FFF2F2;">
      <u>Problem:</u> The LinuxSampler backend application
      (<i>linuxsampler.exe</i>) fails to start with an error message that
      claims that a DLL file is missing (e.g. <i>libatkmm-1.6-1.dll</i>)
    </div>
    <div style="background-color: #F2FFF2;">
      <u>Reason / Solution:</u>
      It could happen that due to previous installations of Gtk+ and gtkmm
      DLLs even after deinstallation leave some stale keys in the windows
      registry which could fool the installer into believing that the needed
      DLLs are already installed therefore skipping its installation which
      will cause the sampler not being able to start due to the missing
      DLLs. We recommend in this case to install gtk+ and gtkmm manually as
      described above in "<a href="#install_wo_inet">Installation without
      Internet</a>". Just install those mentioned Gtk+ and gtkmm versions
      and then LinuxSampler should work correctly.
    </div>
  </li>
  <li>
    <div style="background-color: #FFF2F2;">
      <u>Problem:</u> The LinuxSampler backend application
      (<i>linuxsampler.exe</i>) fails to start with the error message
      "<i>The application failed to initialize properly (0xc000001d). Click
      on OK to terminate the application.</i>"
    </div>
    <div style="background-color: #F2FFF2;">
      <u>Reason / Solution:</u><a name="old_cpu_workaround"></a>
      This first Windows release of LinuxSampler requires at least an Intel
      Pentium4 processor or a recent AMD processor. If you have an older
      processor and get the error message from above, you can use the
      following workaround for now:
      <ol>
        <li>Download and extract
          <a href="http://download.linuxsampler.org/dev/win32_probs/ls686_20071207.zip">
            these replacement binaries.
          </a>
        </li>
        <li>Copy the 3 binaries manually in your LinuxSampler installation
          directory (default installation directory:
          "C:\Program Files\LinuxSampler"), that is overwrite the existing
          binaries in the LS installation directory with the 3 ones from the
          zip file.
        </li>
      </ol>
      Use this workaround only if you got the mentioned error message,
      because the replacement binaries will otherwise decrease runtime
      efficiency! This is of course just a temporary workaround. We'll
      address this issue with the next release of LinuxSampler (see also
      <a href="https://bugs.linuxsampler.org/cgi-bin/show_bug.cgi?id=67">
      bug report #67</a>).
    </div>
  </li>
</ul>

<a name="docs"></a>
<h3>6.&nbsp; Detailed Documentation</h3>
You find more detailed documentation about our software, i.e. about JSampler
or gigedit on our official <a href="http://linuxsampler.org/documentation.html">
LinuxSampler documentation site</a>.

<a name="bugs"></a>
<h3>7.&nbsp; Bugs, Problems and Feature Requests</h3>
Our Forum is a good place to ask for help:<br>
<br>
&nbsp;&nbsp;&nbsp;&nbsp;<a href="http://bb.linuxsampler.org">https://bb.linuxsampler.org</a><br>
<br>
We have a dedicated forum section for
newbies and support.<br>
<br>
Since the Windows port of LinuxSampler is very young, there could be several
bugs which we hope to root out soon.
Please report them using our bug tracking system:<br>
<br>
&nbsp;&nbsp;&nbsp;&nbsp;<a href="http://bugs.linuxsampler.org/">http://bugs.linuxsampler.org/</a><br>
<br>
Some bugs and problems I discovered so far:
<ul>
  <li>when adding a channel there noises could occur while playing on other
  channels</li>
  <li>if you overload the sampler (CPU overload or disk overload) it
  produces noises</li>
  <li>when editing an instrument using gigedit, after saving it, it could
  happen that LinuxSampler does not accept commands from the GUI anymore.
  if this happens close the GUI and the LinuxSampler console window and
  restart both.</li>
</ul>

<a name="contact"></a>
<h3>8.&nbsp; Contact</h3>
If you have questions or want to help us to improve the sampler,
subscribe to the <a href="http://www.linuxsampler.org/developers.html">
LinuxSampler Developer's mailing list</a>. Alternatively, since I did most
of of the Windows porting, you can write me (Benno) directly about Windows
related issues. You can find my email address here:<br>
<br>
&nbsp;&nbsp;&nbsp;&nbsp;<a href="http://www.linuxsampler.org/developers.html">http://www.linuxsampler.org/developers.html</a>
<br><br>
That's it, enjoy!<br>
<br>

</body>
</html>
1	senoner	1575	<!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>LinuxSampler For Windows</title>
7	schoenebeck	1593	<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	senoner	1575	</head>
10			<body>
11	schoenebeck	1593	<h2><center>LinuxSampler for Windows   <img src="gfx/logos/windows.png">   HOWTO by Benno Senoner </center></h2>
12	senoner	1575	<br>
13	schoenebeck	1596	<center>December 18th, 2007</center><br>
14	schoenebeck	1593	<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="#requirements">2.  Requirements</a><br>
17			3.  Installation ...<br>
18			<a href="#install_w_inet">    3.a  with Internet Connection</a><br>
19			<a href="#install_wo_inet">    3.b  without Internet</a><br>
20			<a href="#using">4.  Using the Applications</a><br>
21			<a href="#setup_midi">    4.1  Setting up MIDI Input</a><br>
22			<a href="#setup_audio">    4.2  Setting up Audio Output</a><br>
23			<a href="#load_samples">    4.3  Loading Samples</a><br>
24			<a href="#save_session">    4.4  Saving a Sampler Session</a><br>
25	senoner	1720	<a href="#sequencer_routing">    4.5  Routing LinuxSampler Outs Into Sequencer</a><br>
26	schoenebeck	1593	<a href="#houston">5.  Installation Troubleshooting</a><br>
27			<a href="#docs">6.  Detailed Documentation</a><br>
28			<a href="#bugs">7.  Bugs, Problems and Feature Requests</a><br>
29			<a href="#contact">8.  Contact</a><br>
30			</div>
31
32			<a name="intro"></a>
33	senoner	1983	<p><center>
34			<script type="text/javascript"><!--
35			google_ad_client = "pub-3408196773880325";
36			/* 728x90, created 8/3/09 */
37			google_ad_slot = "7744776541";
38			google_ad_width = 728;
39			google_ad_height = 90;
40			//-->
41			</script>
42			<script type="text/javascript"
43			src="http://pagead2.googlesyndication.com/pagead/show_ads.js">
44			</script>
45			</center>
46			</p>
47	schoenebeck	1593	<h3>1.  Introduction</h3>
48			The LinuxSampler development team is happy to announce that
49			LinuxSampler, the most advanced free, open source sampler finally runs on
50			MS Windows too. More information will be added here soon, so check back frequently.<br>
51	senoner	1575	<br>
52	schoenebeck	1593	For now the sampler supports the Windows Multimedia Extensions System (MME)
53			for MIDI input and ASIO for audio out. This means it currently runs only
54			as a standalone application. A VST interface will follow soon, along with
55			a network module to run multiple sampler slaves distributed on Windows or
56			Linux machines (Linux provides better performance) all controlled from a
57			Windows box i.e. running the VST sequencer.<br>
58	senoner	1575	<br>
59			LinuxSampler is implemented as a client/server application. This means
60	schoenebeck	1593	the sampling engine (the server / backend) runs
61			independently from the GUI (the client / frontend). Sampling engine and
62			client can be run on the same box or on different machines too, connected
63			over the network.<br>
64	senoner	1575	<br>
65			The MS Windows version provides all the features of the Linux version
66	schoenebeck	1593	(except of the instruments DB feature yet) since it is built from the
67	senoner	1575	same source code base. This means when new features will come out the
68	schoenebeck	1593	Windows version will usually provide the same feature set as the Linux
69			version. This was made possible by the very modular design of both
70			low level, operating system functions and flexible audio / MIDI driver
71	senoner	1575	system.<br>
72			<br>
73			The Windows version comes as a self extracting .exe file which will
74	schoenebeck	1593	install all the necessary modules to run both the server ( linuxsampler.exe )
75			and the GUI client. It installs 2 GUI clients:
76			<ul>
77			<li>One is <b>QSampler</b>, a light-weight frontend based on the
78			cross-platform Qt4 GUI toolkit with native OS GUI widgets</li>
79			<li>Another is <b>JSampler "Fantasia"</b>, a Java based GUI client called,
80			providing a modern skin-based user interface</li>
81			</ul>
82			At the moment JSampler is more advanced than QSampler as it implements all
83			the functionality present in the LinuxSampler engine. Due to the Java
84			virtual machine however it occupies a bit more RAM than the
85			QSsampler GUI (around 30MB or so) and takes a bit longer for startup,
86			but on a 1GB+ RAM box the difference should be negligible.
87
88			<a name="requirements"></a>
89			<h3>2.  Requirements</h3>
90			<ul>
91	schoenebeck	1595	<li>Intel Pentium4 or recent AMD processor (use
92			<a href="#old_cpu_workaround">this workaround for older processors</a>)
93	schoenebeck	1593	<li>Windows 2000, ME, XP or Vista</li>
94			<li><a href="http://www.gtk.org/">GTK+</a> (<a href="http://downloads.sourceforge.net/gladewin32/gtk-2.10.11-win32-1.exe?modtime=1175123376&big_mirror=0">version 2.10.11</a>)</li>
95			<li><a href="http://www.gtkmm.org/">gtkmm</a> (<a href="http://ftp.gnome.org/pub/gnome/binaries/win32/gtkmm/2.10/gtkmm-win32-runtime-2.10.11-1.exe">version 2.10.11</a>)</li>
96			<li><a href="http://en.wikipedia.org/wiki/Java_(Sun)">Java Runtime Environment</a> (<a href="http://www.java.com/getjava/">version 6</a>)</a></li>
97			<li>sound card with <a href="http://en.wikipedia.org/wiki/Audio_Stream_Input/Output">ASIO</a> driver</li>
98			</ul>
99			<a name="asio_tip"></a>
100			<b>Tip:</b> For consumer audio cards which do not come with their own ASIO
101			drivers you can install <a href="http://www.asio4all.com/">ASIO4ALL</a> to be
102			able to use LinuxSampler with your soundcard.
103			We recommend to use version 2.7, perhaps on Vista 2.8beta1 works better but
104			we did not perform tests on Vista so we cannot tell it. Please let us know
105			about your results so we can share them here!
106
107			<a name="install_w_inet"></a>
108			<h3>3.a  Installation with Internet Connection</h3>
109			Simply download the latest version of the LinuxSampler Windows installer
110			from the <a href="http://www.linuxsampler.org/downloads.html">LinuxSampler
111			Download Page</a>, execute the installer and follow the instructions. It will
112			automatically detect if the required software components are already installed.
113			If not, it will download them from the internet and install them on your
114			computer.
115
116			<a name="install_wo_inet"></a>
117			<h3>3.b  Installation without Internet</h3>
118			First download the required components with a machine which has connection to
119			the internet:
120			<ul>
121			<li><a href="http://downloads.sourceforge.net/gladewin32/gtk-2.10.11-win32-1.exe?modtime=1175123376&big_mirror=0">gtk+ 2.10.11</a></li>
122			<li><a href="http://ftp.gnome.org/pub/gnome/binaries/win32/gtkmm/2.10/gtkmm-win32-runtime-2.10.11-1.exe">gtkmm 2.10.11</a></li>
123			<li><a href="http://www.java.com/getjava/">Java Runtime Environment 6</a></li>
124			<li>and of course the latest <a href="http://www.linuxsampler.org/downloads.html">
125			LinuxSampler Windows installer</a></li>
126			</ul>
127			Transfer the downloaded files to the computer where you want to install
128			LinuxSampler and install them in the following order:
129			<ol>
130			<li>gtk-2.10.11-win32-1.exe</li>
131			<li>gtkmm-win32-runtime-2.10.11-1.exe</li>
132			<li>jre-6u2-windows-i586-p.exe</li>
133			<li>linuxsampler_20071207_setup.exe</li>
134			</ol>
135			The order is important, since the components depend on each other and would
136			otherwise try to download the missing component from the internet.
137
138			<a name="using"></a>
139			<h3>4.  Using the Applications</h3>
140			Now that we installed everything, let's get wet and start the applications:
141			<ol>
142			<li>First start the LinuxSampler backend: Click on <i>"Start" ->
143			"LinuxSampler" -> "LinuxSampler 0.5.1 (backend)"</i>. A black console
144			window should immediately popup. It does what you think it does:
145			nothing ... yet ... because this is "just" the raw sampler, without a
146			user interface.</li>
147			<li>Now start a "frontend" application to actually control the previously
148			started sampler. For beginners and / or unpatient people, we recommend
149			you to use JSampler: Click on <i>"Start" -> "LinuxSampler" ->
150			"JSampler 'Fantasia' 0.8a (frontend)"</i>. This usually takes about
151			20 seconds or so until the application finally appears on the
152			screens.</li>
153			</ol>
154			</div>
155
156			<a name="setup_midi"></a>
157			<h3>4.1  Setting up MIDI Input</h3>
158			Once the GUI opens, click on the left round button in the MIDI devices
159			tab.
160			At this point a window will open where you can create a new MIDI device.
161			Press Create. The window will close and the MIDI device will be created.
162			(MIDI Device 0 MME).
163			Now click on the right arrow which points downwards.
164			You can see that a MIDI device with a single Port (Port 0) was created.
165	senoner	1575	Under Windows MME LinuxSampler always creates MIDI devices which are
166	schoenebeck	1593	connected to a single MME port.
167	senoner	1575	To select the MIDI input port you must click on the field located on
168	schoenebeck	1593	the left of PORT.
169	senoner	1575	A combobox pops-up where you can select the Windows MIDI port.<br>
170			<br>
171			You can create an arbitrary number of MIDI input devices by repeating
172	schoenebeck	1593	the procedure above.
173			Each MIDI input device is connected to a single Windows MME MIDI port.
174	senoner	1575	This means LinuxSampler has no limitation in terms of number of MIDI
175	schoenebeck	1593	ports.
176			Each MIDI device can be routed to arbitrary sampler channels.
177
178			<a name="setup_audio"></a>
179			<h3>4.2  Setting up Audio Output</h3>
180			LinuxSampler currently only supports the ASIO driver model for audio output
181			on Windows. ASIO drivers ensure reliable low-latency operation and are
182			virtually available for any soundcard (see <a href="#asio_tip">
183			ASIO requirements tip</a>).<br>
184	senoner	1575	<br>
185	schoenebeck	1593	Click on the left round button in the Audio Devices tab.
186			At this point a window will open where you can create a new MIDI device.
187			When creating the Audio device you can set several parameters:
188			<ul>
189			<li><b>CARD</b> : The name of the soundcard, in case you have multiple cards
190			installed. It will show the default value (first card found).</li>
191			<li><b>CHANNELS</b> : Number of audio output channels, can range from 1 to
192			maximum number of channels your soundcard supports. We recommend to
193			leave the default value which is the maximum number of channels your
194			soundcard supports.</li>
195			<li><b>FRAGMENTSIZE</b> : ASIO buffer size in samples. The card's default
196			value is shown. If you experience clicks and pops during audio
197			playback then initialize the audio output device with bigger values.
198			(better if it's always a power of 2:  e.g. 256, 512, 1024)</li>
199			<li><b>SAMPLERATE</b> : Sets the samplerate. The default value is shown.<br>
200			</ul>
201			Now Press "Create". The window will close and the Audio device will be
202			created: "AUDIO DEVICE 0 (ASIO)" appears.
203
204			<a name="load_samples"></a>
205			<h3>4.3  Loading Samples</h3>
206			In the middle of the screen below the volume slider, you see the sampler
207			channel strip pane. press on the round button located on the left.
208			This will create a new sampler channel. Click on "Load Instrument".
209			This opens a dialog which allows you to select an instrument to be
210			loaded in the sampler channel
211
212			(for information on how to use "orchestras" <a
213	senoner	1592	href="http://www.linuxsampler.org/jsampler/manual/html/jsampler.html#USING_ORCHESTRAS">click
214	schoenebeck	1593	here</a>, but note: orchestras, a.k.a "instruments database" is not yet supported in this
215			first Windows version of LinuxSampler, but will certainly be on the next Windows release).
216
217	senoner	1575	On the row  "Select instrument from file" click on the orange icon
218	schoenebeck	1593	located on the right side. This opens a file dialog which allows you to
219			select a sample to be loaded
220			(currently only the GIG format is supported).
221			Select the sample to be loaded and then click on "Open".
222			At this point the fields Instrument file shows the filename.
223	senoner	1575	You can click on the Instrument index and select the specific
224	schoenebeck	1593	instrument contained in the instrument file. Now press "OK".<br>
225	senoner	1575	<br>
226	schoenebeck	1593	While it loads you see: "Loading" .. "90%" .. "100%" <br>
227			<br>
228			Once loaded, you see the Instrument's name: i.e. "FreePiano"<br>
229			<br>
230	senoner	1575	On the left side of the sampler channel click on the arrow below
231	schoenebeck	1593	"Options".
232	senoner	1575	This pane permits to set MIDI input device, port and channel and oudio
233	schoenebeck	1593	output channel.
234			Notice that under Windows MME the Port value is always 0.
235			So the only values you can change is "MIDI device" (normally 0 if you
236			created only a single
237			MIDI input device) and the MIDI channel (from 1 to 16).
238
239			<a name="save_session"></a>
240			<h3>4.4  Saving a Sampler Session</h3>
241			Click on the 3rd icon from the left on the row where you see the round
242			icon with the LinuxSampler "S"-shape logo.
243			Now select the directory where you want to save the file to (extension
244			.lscp = <i>Linux Sampler Control Protocol</i>).
245			Enter the name and press save (add .lscp at end of file otherwise you
246			will not see it in the file-open dialog later, when you want to load it again).<br>
247	senoner	1575	<br>
248			Next time you can load a sampler session by clicking on the second icon
249	schoenebeck	1593	from the left, then select a .lscp file in the file dialog and press "Open".
250	senoner	1575	This will automatically set up the MIDI devices and audio devices,
251	schoenebeck	1593	create the sampler channels and load all the samples that were previously
252			loaded by you in the saved sampler session.
253
254	senoner	1720	<a name="sequencer_routing"></a>
255			<h3>4.5  Routing LinuxSampler Outs Into Sequencer</h3>
256			LinuxSampler currently lacks a VST interface so the only way to route LinuxSampler's outs into a sequencer
257			are either by using physical cables or internal routing via ASIO. Some audio cards offer this feature.
258			<br>
259			The <a href="http://www.reaper.fm">Reaper</A> sequencer allows ASIO routing by implementing a virtual
260			ASIO based driver independently from the soundcard type (ReaRoute). Basically in LinuxSampler you select the ReaRoute as ASIO output driver which
261			appear as input ports in Reaper. Coupled with the MIDI controllable FX sends in LinuxSampler you can use
262			Reaper's FX egine to add reverb, chorus etc to LinuxSampler instruments, fully MIDI controllable, similar to
263			other MIDI based modules.
264			<br>
265			Our forum user moonskin (thanks Graham!) has described the steps needed to perform in order to set up the routing.
266			<a href="http://bb.linuxsampler.org/viewtopic.php?f=6&t=111&sid=d745353791f6cb1ef46946af4168aada&start=10#p944">
267			See here</a>
268
269
270	schoenebeck	1593	<a name="houston"></a>
271			<h3>5.  Installation Troubleshooting</h3>
272	schoenebeck	1595	<ul>
273			<li>
274			<div style="background-color: #FFF2F2;">
275			<u>Problem:</u> The LinuxSampler backend application
276			(<i>linuxsampler.exe</i>) fails to start with an error message that
277			claims that a DLL file is missing (e.g. <i>libatkmm-1.6-1.dll</i>)
278			</div>
279			<div style="background-color: #F2FFF2;">
280			<u>Reason / Solution:</u>
281			It could happen that due to previous installations of Gtk+ and gtkmm
282			DLLs even after deinstallation leave some stale keys in the windows
283			registry which could fool the installer into believing that the needed
284			DLLs are already installed therefore skipping its installation which
285			will cause the sampler not being able to start due to the missing
286			DLLs. We recommend in this case to install gtk+ and gtkmm manually as
287			described above in "<a href="#install_wo_inet">Installation without
288			Internet</a>". Just install those mentioned Gtk+ and gtkmm versions
289			and then LinuxSampler should work correctly.
290			</div>
291			</li>
292			<li>
293			<div style="background-color: #FFF2F2;">
294			<u>Problem:</u> The LinuxSampler backend application
295			(<i>linuxsampler.exe</i>) fails to start with the error message
296			"<i>The application failed to initialize properly (0xc000001d). Click
297			on OK to terminate the application.</i>"
298			</div>
299			<div style="background-color: #F2FFF2;">
300			<u>Reason / Solution:</u><a name="old_cpu_workaround"></a>
301			This first Windows release of LinuxSampler requires at least an Intel
302			Pentium4 processor or a recent AMD processor. If you have an older
303			processor and get the error message from above, you can use the
304			following workaround for now:
305			<ol>
306			<li>Download and extract
307			<a href="http://download.linuxsampler.org/dev/win32_probs/ls686_20071207.zip">
308			these replacement binaries.
309			</a>
310			</li>
311			<li>Copy the 3 binaries manually in your LinuxSampler installation
312			directory (default installation directory:
313			"C:\Program Files\LinuxSampler"), that is overwrite the existing
314			binaries in the LS installation directory with the 3 ones from the
315			zip file.
316			</li>
317			</ol>
318			Use this workaround only if you got the mentioned error message,
319			because the replacement binaries will otherwise decrease runtime
320			efficiency! This is of course just a temporary workaround. We'll
321			address this issue with the next release of LinuxSampler (see also
322			<a href="https://bugs.linuxsampler.org/cgi-bin/show_bug.cgi?id=67">
323			bug report #67</a>).
324			</div>
325			</li>
326			</ul>
327	schoenebeck	1593
328			<a name="docs"></a>
329			<h3>6.  Detailed Documentation</h3>
330			You find more detailed documentation about our software, i.e. about JSampler
331			or gigedit on our official <a href="http://linuxsampler.org/documentation.html">
332			LinuxSampler documentation site</a>.
333
334			<a name="bugs"></a>
335			<h3>7.  Bugs, Problems and Feature Requests</h3>
336	schoenebeck	1676	Our Forum is a good place to ask for help:<br>
337			<br>
338	schoenebeck	1856	<a href="http://bb.linuxsampler.org">https://bb.linuxsampler.org</a><br>
339	schoenebeck	1676	<br>
340			We have a dedicated forum section for
341			newbies and support.<br>
342			<br>
343	schoenebeck	1593	Since the Windows port of LinuxSampler is very young, there could be several
344			bugs which we hope to root out soon.
345			Please report them using our bug tracking system:<br>
346	senoner	1592	<br>
347	schoenebeck	1593	<a href="http://bugs.linuxsampler.org/">http://bugs.linuxsampler.org/</a><br>
348	senoner	1592	<br>
349	schoenebeck	1593	Some bugs and problems I discovered so far:
350			<ul>
351			<li>when adding a channel there noises could occur while playing on other
352			channels</li>
353			<li>if you overload the sampler (CPU overload or disk overload) it
354			produces noises</li>
355			<li>when editing an instrument using gigedit, after saving it, it could
356			happen that LinuxSampler does not accept commands from the GUI anymore.
357			if this happens close the GUI and the LinuxSampler console window and
358			restart both.</li>
359			</ul>
360
361			<a name="contact"></a>
362			<h3>8.  Contact</h3>
363			If you have questions or want to help us to improve the sampler,
364			subscribe to the <a href="http://www.linuxsampler.org/developers.html">
365			LinuxSampler Developer's mailing list</a>. Alternatively, since I did most
366			of of the Windows porting, you can write me (Benno) directly about Windows
367			related issues. You can find my email address here:<br>
368	senoner	1592	<br>
369	schoenebeck	1593	<a href="http://www.linuxsampler.org/developers.html">http://www.linuxsampler.org/developers.html</a>
370			<br><br>
371			That's it, enjoy!<br>
372	senoner	1592	<br>
373	schoenebeck	1593
374	senoner	1575	</body>
375			</html>