/[svn]/web/trunk/www.linuxsampler.org/windows.html

Diff of /web/trunk/www.linuxsampler.org/windows.html

Parent Directory | Revision Log | View Patch Patch

-revision 1575 by senoner,
Fri Dec  7 06:44:01 2007 UTC
+revision 1593 by schoenebeck,
Thu Dec 13 01:46:02 2007 UTC
 Line 4
    <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>LinuxSampler for Windows&nbsp; - howto by Benno Senoner&nbsp; </h2>
+ <h2><center>LinuxSampler for Windows &nbsp; <img src="gfx/logos/windows.png"> &nbsp; HOWTO by Benno Senoner&nbsp;</center></h2>
  <br>
- December,&nbsp; 7 2007<br>
+ <center>December&nbsp;13th,&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>
+.&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="#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>
+ <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>
- the LinuxSampler development team is happy to announce that<br>
- LinuxSampler, the most advanced free, open source sampler now runs on
- MS Windows too (requires at least Windows 2000).<br>
- (see below for the download link)<br>
- More information and documentation will be added here soon, so check
- back frequently.<br>
- <br>
- for the latest LinuxSampler Windowsversion always check <a
-  href="http://www.linuxsampler.org/downloads.html">LinuxSampler
- Download Page</a><br>
- <br>
- If you have questions or want to help subscribe to the <a
-  href="http://www.linuxsampler.org/developers.html">LinuxSampler
- mailing list</a><br>
- <br>
- or since I did most of of the porting, you can write me directly (to
- Benno) about&nbsp; Windows related questions.<br>
- you can find my email address here: <a
-  href="http://www.linuxsampler.org/developers.html">LinuxSampler
- developers</a><br>
- <br>
- To report bugs please use our bug tracking system <a
-  href="http://bugs.linuxsampler.org/">http://bugs.linuxsampler.org/</a><br>
- <br>
- <br>
- For now it supports Windows Multimedia System (MME) at MIDI in and ASIO
- output out.<br>
- <br>
- This means that currently it runs only as a standalone application.<br>
- A VST interface will follow soon, along with a network module to run
- multiple sampler slaves on<br>
- Windows or Linux machines (Linux provides better performance) all
- controlled from a Windows box running <br>
- the VST sequencer.<br>
  LinuxSampler is implemented as a client/server application. This means
- the sampling engine (the server) runs<br>
+ the sampling engine (the server / backend) runs
- independently from the GUI (the client). Sampling engine and client can
+ independently from the GUI (the client / frontend). Sampling engine and
- be run on the same box or<br>
+ client can be run on the same box or on different machines too, connected
- on different machines too, connected over the network.<br>
+ over the network.<br>
  <br>
  The MS Windows version provides all the features of the Linux version
- since it is built from the <br>
+ (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 always provide<br>
+ Windows version will usually provide the same feature set as the Linux
- the same feature set as the Linux version. This was made possible by
+ version. This was made possible by the very modular design of both
- the very modular design of both<br>
+ low level, operating system functions and flexible audio / MIDI driver
- 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<br>
+ install all the necessary modules to run both the server ( linuxsampler.exe )
- to run both the server ( linuxsampler.exe ) and the GUI client.<br>
+ and the GUI client. It installs 2 GUI clients:
- In installs 2 GUI clients. One is QSampler, based on the cross-platform
+ <ul>
- Qt4 GUI toolkit, and a java<br>
+   <li>One is <b>QSampler</b>, a light-weight frontend based on the
- GUI client called JSampler Fantasia. At the moment the latter more
+       cross-platform Qt4 GUI toolkit with native OS GUI widgets</li>
- advanced than qsampler as it <br>
+   <li>Another is <b>JSampler "Fantasia"</b>, a Java based GUI client called,
- implements all the functionality present in the LinuxSampler engine.<br>
+       providing a modern skin-based user interface</li>
- Due to the Java virtual machine it uses a bit more memory than the
+ </ul>
- qsampler GUI (around 30MB or so)<br>
+ At the moment JSampler is more advanced than QSampler as it implements all
- but on a 1GB+ RAM box the difference should be negligible.<br>
+ the functionality present in the LinuxSampler engine. Due to the Java
- <br>
+ virtual machine however it occupies a bit more RAM than the
- Quickstart:<br>
+ QSsampler GUI (around 30MB or so) and takes a bit longer for startup,
- start<br>
+ but on a 1GB+ RAM box the difference should be negligible.
- LinuxSampler -&gt; LinuxSampler<br>
- then<br>
+ <a name="requirements"></a>
- LinuxSampler -&gt; Fantasa<br>
+ <h3>2.&nbsp; Requirements</h3>
- <br>
+ <ul>
- <br style="font-weight: bold;">
+   <li>Windows 2000, ME, XP or Vista</li>
- <big style="font-weight: bold;">1) setting up MIDI input</big><span
+   <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>
-  style="font-weight: bold;">:</span><br>
+   <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>
- once the GUI opens, click on the left round button in the MIDI devices
+   <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>
- tab.<br>
+   <li>sound card with <a href="http://en.wikipedia.org/wiki/Audio_Stream_Input/Output">ASIO</a> driver</li>
- At this point a window will open where you can create a new MIDI device.<br>
+ </ul>
- Press Create. The window will close and the MIDI device will be created.<br>
+ <a name="asio_tip"></a>
- (MIDI Device 0 MME).<br>
+ <b>Tip:</b> For consumer audio cards which do not come with their own ASIO
- Now click on the right arrow which points downwards.<br>
+ drivers you can install <a href="http://www.asio4all.com/">ASIO4ALL</a> to be
- You can see that a MIDI device with a single Port (Port 0) was created.<br>
+ 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
+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 <br>
+ connected to a single MME port.
- MME port.<br>
  To select the MIDI input port you must click on the field located on
- the left of PORT. <br>
+ 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.<br>
+ the procedure above.
- Each MIDI input device is connected to a single Windows MME MIDI port.<br>
+ 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. <br>
+ ports.
- Each MIDI device can be routed to arbitrary sampler channels.<br>
+ Each MIDI device can be routed to arbitrary sampler channels.
- <br>
- <br>
+ <a name="setup_audio"></a>
- <big><span style="font-weight: bold;">2) setting up AUDIO output:</span></big><br>
+ <h3>4.2&nbsp; Setting up Audio Output</h3>
- <br>
+ LinuxSampler currently only supports the ASIO driver model for audio output
- LinuxSampler currently uses the ASIO driver model for audio output.<br>
+ on Windows. ASIO drivers ensure reliable low-latency operation and are
- ASIO drivers ensure reliable low-latency operation and are virtually
+ virtually available for any soundcard (see <a href="#asio_tip">
- available<br>
+ ASIO requirements tip</a>).<br>
- for any soundcard.<br>
+ <br>
- (For consumer audio cards which do not come with their own ASIO drivers
+ Click on the left round button in the Audio Devices tab.
- you need<br>
+ At this point a window will open where you can create a new MIDI device.
- to install ASIO4ALL:&nbsp; http://www.asio4all.com/<br>
+ When creating the Audio device you can set several parameters:
- We recommend to use version 2.7 , perhaps on Vista 2.8beta1 works
+ <ul>
- better but<br>
+   <li><b>CARD</b> : The name of the soundcard, in case you have multiple cards
- we did not perform tests on Vista so we cannot tell it. Let us know
+       installed. It will show the default value (first card found).</li>
- about your findings<br>
+   <li><b>CHANNELS</b> : Number of audio output channels, can range from 1 to
- so we can share them here)<br>
+       maximum number of channels your soundcard supports. We recommend to
- <br>
+       leave the default value which is the maximum number of channels your
- Click on the left round button in the Audio Devices tab.<br>
+       soundcard supports.</li>
- At this point a window will open where you can create a new MIDI device.<br>
+   <li><b>FRAGMENTSIZE</b> : ASIO buffer size in samples. The card's default
- When creating the Audio device you can set several parameters.<br>
+       value is shown. If you experience clicks and pops during audio
- - CARD : the name of the soundcard, in case you have multiple cards
+       playback then initialize the audio output device with bigger values.
- installed.<br>
+       (better if it's always a power of 2:&nbsp; e.g. 256, 512, 1024)</li>
- it will show the default value (first card found)<br>
+   <li><b>SAMPLERATE</b> : Sets the samplerate. The default value is shown.<br>
- - CHANNELS: number of audio output channels, can range from 1 to
+ </ul>
- maximum number<br>
+ Now Press "Create". The window will close and the Audio device will be
- of channels your soundcard supports. We recommend to leave the default
+ created: "AUDIO DEVICE 0 (ASIO)" appears.
- value which<br>
- is maximum number of channels.<br>
+ <a name="load_samples"></a>
- - FRAGMENTSIZE: ASIO buffer size in samples. The card's default value
+ <h3>4.3&nbsp; Loading Samples</h3>
- is shown.<br>
+ In the middle of the screen below the volume slider, you see the sampler
- If you experience clicks and pops during audio playback then initialize
+ channel strip pane. press on the round button located on the left.
- the <br>
+ This will create a new sampler channel. Click on "Load Instrument".
- audio output device with bigger values. <br>
+ This opens a dialog which allows you to select an instrument to be
- (better if it's always a power of 2:&nbsp; eg. 256, 512, 1024)<br>
+ loaded in the sampler channel
- <br>
- SAMPLERATE: sets the samplerate. The default value is shown.<br>
+ (for information on how to use "orchestras" <a
- <br>
+  href="http://www.linuxsampler.org/jsampler/manual/html/jsampler.html#USING_ORCHESTRAS">click
- Now Press Create. The window will close and the Audio device will be
+ here</a>, but note: orchestras, a.k.a "instruments database" is not yet supported in this
- created.<br>
+ first Windows version of LinuxSampler, but will certainly be on the next Windows release).
- AUDIO DEVICE 0 (ASIO)<br>
- <big style="font-weight: bold;"><br>
-) Loading samples:</big><br>
- <br>
- In the middle of the screen below the volume slider you see the sampler
- channel strip pane.<br>
- press on the round button located on the left. <br>
- This will create a new sampler channel.<br>
- - click on Load Instrument <br>
- this opens a dialog which allows you to select an instrument to be
- loaded in the sampler channel.<br>
- For now ignore the upper part (Select instrument form orchestra) as
- this feature is not implemented<br>
- on Windows yet.<br>
  On the row&nbsp; "Select instrument from file" click on the orange icon
- located on the right side.<br>
+ located on the right side. This opens a file dialog which allows you to
- This opens a file dialog which allows you to select a sample to be
+ select a sample to be loaded
- loaded <br>
+ (currently only the GIG format is supported).
- (currently only the GIG format is supported).<br>
+ Select the sample to be loaded and then click on "Open".
- select the sample to be loaded and then click on Open.<br>
+ At this point the fields Instrument file shows the filename.
- At this point the fields Instrument file shows the filename.<br>
  You can click on the Instrument index and select the specific
- instrument contained in the<br>
+ instrument contained in the instrument file. Now press "OK".<br>
- instrument file.<br>
+ <br>
- Now press OK<br>
+ While it loads you see: "Loading" .. "90%" .. "100%" <br>
- While it loads you see: Loading .. 90% .. 100% <br>
+ <br>
- Once loaded you see the Instrument's name: ie&nbsp; FreePiano<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.<br>
+ "Options".
  This pane permits to set MIDI input device, port and channel and oudio
- output channel.<br>
+ output channel.
- Notice that under Windows MME the Port value is always 0.<br>
+ Notice that under Windows MME the Port value is always 0.
- So the only values you can change MIDI device (normally 0 if you
+ So the only values you can change is "MIDI device" (normally 0 if you
- created only a single<br>
+ created only a single
- MIDI input device) and the MIDI channel (from 1 to 16).<br>
+ MIDI input device) and the MIDI channel (from 1 to 16).
- <br>
- Saving a sampler session:<br>
+ <a name="save_session"></a>
- click on the 3rd icon from the left on the row where you see the round
+ <h3>4.4&nbsp; Saving a Sampler Session</h3>
- icon with the S logo.<br>
+ Click on the 3rd icon from the left on the row where you see the round
- <br>
+ icon with the LinuxSampler "S"-shape logo.
- Now select the directory where you want to save the file to ( extension
+ Now select the directory where you want to save the file to (extension
- .lscp = Linux Sampler Control Protocol).<br>
+ .lscp = <i>Linux Sampler Control Protocol</i>).
- enter the name and press save. (add .lscp at end of file otherwise you
+ Enter the name and press save (add .lscp at end of file otherwise you
- will not see it when loading it)<br>
+ 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 <br>
+ from the left, then select a .lscp file in the file dialog and press "Open".
- then select a .lscp file in the file dialog and press Open.<br>
  This will automatically set up the MIDI devices and audio devices,
- create the sampler channels<br>
+ create the sampler channels and load all the samples that were previously
- and load all the samples that were loaded.<br>
+ loaded by you in the saved sampler session.
- <br>
- <span style="font-weight: bold;">Bugs and Problems: <br>
+ <a name="houston"></a>
- <small><span style="font-weight: bold;"></span></small></span>since the
+ <h3>5.&nbsp; Installation Troubleshooting</h3>
- Windows port is very young there could be several bugs which we hope to
+ It could happen that due to previous installations of Gtk+ and gtkmm DLLs
- root out soon.<br>
+ even after deinstallation leave some stale keys in the windows registry which
- so be sure to report them using our bug tracking system <a
+ could fool the installer into
-  href="http://bugs.linuxsampler.org/">http://bugs.linuxsampler.org/</a><br>
+ believing that the needed DLLs are already installed therefore skipping
- <br>
+ its installation which will
- some bugs and problems I discovered:<br>
+ cause the sampler not being able to start due to the missing DLLs.
- - when adding a channel there noises could occur while playing on other
+ We recommend in this case to install gtk+ and gtkmm manually as described
- channels<br>
+ above in "<a href="#install_wo_inet">Installation without Internet</a>".
- - if you overload the sampler (CPU overload or disk overload) it
+ Just install those mentioned Gtk+ and gtkmm versions and then LinuxSampler
- produces noises<br>
+ should work correctly.
- - then editing an instrument using gigedit<br>
- <br>
+ <a name="docs"></a>
- <br>
+ <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>
+ 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>

 Legend:



Removed from v.1575
 


changed lines


 
Added in v.1593
 Legend:



Removed from v.1575
 


changed lines


 
Added in v.1593
-Removed from v.1575
+Added in v.1593

	ViewVC Help
Powered by ViewVC