/[svn]/web/trunk/www.linuxsampler.org/osx.html
ViewVC logotype

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

Parent Directory Parent Directory | Revision Log Revision Log | View Patch Patch

revision 1996 by senoner, Tue Aug 4 08:59:23 2009 UTC revision 1997 by iliev, Fri Sep 25 19:59:24 2009 UTC
# Line 4  Line 4 
4    <meta content="text/html; charset=ISO-8859-1"    <meta content="text/html; charset=ISO-8859-1"
5   http-equiv="content-type">   http-equiv="content-type">
6    <title>LinuxSampler For Mac OS X</title>    <title>LinuxSampler For Mac OS X</title>
7    <link rel="shortcut icon" href="http://download.linuxsampler.org/favicon.ico" type="image/x-icon">    <link rel="shortcut icon" href="/favicon.ico" type="image/x-icon">
8    <link rel="stylesheet" type="text/css" href="libgig/css/content.css" title="content" media="all">    <link rel="stylesheet" type="text/css" href="libgig/css/content.css" title="content" media="all">
9  </head>  </head>
10  <body>  <body>
11  <h2><center>LinuxSampler for Mac OS X &nbsp; <img src="gfx/logos/apple.png"> &nbsp; HOWTO by Toshi Nagata&nbsp;</center></h2>  <h2><center>LinuxSampler-1.0.0 on Mac OS X &nbsp; <img src="gfx/logos/apple.png"> &nbsp; HOWTO by Ebrahim Mayat and Grigor Iliev&nbsp;</center></h2>
12  <br>  <br>
13  <center>January&nbsp;6th,&nbsp;2008</center><br>  <center>September&nbsp;20th,&nbsp;2009</center><br>
14  <div style="background-color: #F4F4FF; margin: 1em 3em 1em 3em; padding: 1em 1em 1em 2.2em;">  <div style="background-color: #F4F4FF; margin: 1em 3em 1em 3em; padding: 1em 1em 1em 2.2em;">
15  <a href="#intro">1.&nbsp; Introduction</a><br>  <a href="#intro">1.&nbsp; Introduction</a><br>
16  <a href="#requirements">2.&nbsp; Requirements</a><br>  <a href="#requirements">2.&nbsp; Requirements</a><br>
17  <a href="#installation">3.&nbsp; Installation</a><br>  <a href="#installation">3.&nbsp; The LinuxSampler package</a><br>
18  <a href="#using">4.&nbsp; Using the Applications</a><br>  <a href="#installation">4.&nbsp; The LinuxSampler(JACK) package</a><br>
19  <a href="#setup_midi">&nbsp;&nbsp;&nbsp;&nbsp;4.1&nbsp; Setting up MIDI Input</a><br>  <a href="#docs">5.&nbsp; Detailed Documentation</a><br>
20  <a href="#setup_audio">&nbsp;&nbsp;&nbsp;&nbsp;4.2&nbsp; Setting up Audio Output</a><br>  <a href="#bugs">6.&nbsp; Bugs, Problems and Feature Requests</a><br>
21  <a href="#load_samples">&nbsp;&nbsp;&nbsp;&nbsp;4.3&nbsp; Loading Samples</a><br>  <a href="#credits">7.&nbsp; Credits</a><br>
22  <a href="#save_session">&nbsp;&nbsp;&nbsp;&nbsp;4.4&nbsp; Saving a Sampler Session</a><br>  <a href="#contact">8.&nbsp; Contact</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="#credits">8.&nbsp; Credits</a><br>  
 <a href="#contact">9.&nbsp; Contact</a><br>  
23  </div>  </div>
24  <p>  <p>
25  <center>  <center>
# Line 43  src="http://pagead2.googlesyndication.co Line 38  src="http://pagead2.googlesyndication.co
38  </p>  </p>
39  <a name="intro"></a>  <a name="intro"></a>
40  <h3>1.&nbsp; Introduction</h3>  <h3>1.&nbsp; Introduction</h3>
41  The LinuxSampler development team is happy to announce the release of  
42  a new version of LinuxSampler of Mac OS X. More information will be added here soon, so check back frequently.<br>  The LinuxSampler development team is delighted to announce the release of LinuxSampler-1.0.0 for Mac OS X.
43  <br>  LinuxSampler is an open-source disc-streaming software sampler that enables the expressive emulation
44  For now the sampler supports the CoreMIDI interface  of instruments by the means of MIDI-triggered rendering of large sample sets. While the modular design
45  for MIDI input and <A HREF="http://www.jackosx.com">jack</A> for audio out. This means it currently runs only  of LinuxSampler allows for multi-engine and multi-format features, the present implementation of the Gig
46  as a standalone application. An AU/VST interface will follow at a later stage, along with  engine already has the capability for producing virtual instruments with realistic emulations. VST (Linux, Windows)
47  a network module to run multiple sampler slaves distributed on OS/X, Windows or  and Audio Unit (OS X) plug-ins for digital audio workstations (DAWs) facilitate the use of this sampler within audio
48  Linux machines (Linux provides better performance) all controlled from a  and MIDI sequencer applications. With its LinuxSampler Control Protocol (LSCP), LinuxSampler can be controlled over
49  OS X or Windows box i.e. running the AU / VST sequencer.<br>  a computer network so that a cluster can be used as a gigantic sampler. Since this network protocol is ASCII-based,
50  Even though LinuxSampler presently runs only as standalone app,  frontends for it can be written in any programming language and for any operating system. LinuxSampler itself is a server
51  thanks to jack you can comfortably route the sampler's audio outs back into your sequencer.  application that can be controlled by GUI frontends like the C++-based Qsampler and the Java-implemented Fantasia. The
52  <br>  present release can be deployed on Linux, OS X and Windows. The instructions for using the OS X binaries are outlined here.
53  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 Mac OS X version provides all the features of the Linux version  
 since it is built from the same source code base.  
 This means when new features will come out the  
 Mac OS X 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 Mac OS X version comes as an easy to install DMG file which will  
 install all the necessary modules to run both the server ( bin/linuxsampler )  
 and the GUI client. For now it installs only the qsampler GUI client  
 as JSampler, the sampler frontend written in Java requires Java 1.6 which is not  
 available on OS X yet. Of course you can run JSampler on a Windows or Linux box  
 connected over the network to your OS X box or you could try to run it in a windows  
 virtual machine. We discourage running a virtual machine along with the sampler  
 as both applicationes are very CPU and RAM hungry therefore the performance  
 of LinuxSampler will be suboptimal.<br>  
 <a href="http://download.linuxsampler.org/pix/screenshots/osx_qsampler_0_2_1_color.jpg">  
  <img src="screenshots/osx_qsampler_0_2_1_preview.png" border="0">  
 </a>  
54    
55  <a name="requirements"></a>  <a name="requirements"></a>
56  <h3>2.&nbsp; Requirements</h3>  <h3>2.&nbsp; Requirements</h3>
57  <ul>  <ul>
58    <li>PPC or Intel Mac (an Intel Mac should provide much better performance)    <li>PPC or Intel Mac
59    <li>Mac OS Tiger or later (Leopard should work too)</li>    <li>Mac OS X Leopard and Snow Leopard </li>
60    <li><A HREF="http://www.jackosx.com">JackOSX</A>. Install it before LinuxSampler</li>    <li> For the LinuxSampler(JACK) package: <A HREF="http://www.jackosx.com">JackOSX</A>. Install it before LinuxSampler(JACK)</li>
61    <li><A HREF="http://pete.yandell.com/software/">Pete Yandell's MIDI Patchbay</A> or a similar tool</li>    <li><A HREF="http://www.apple.com/downloads/macosx/audio/midipatchbay.html">Pete Yandell's MIDI Patchbay</A> </li>
62  </ul>  </ul>
63    
64  <a name="installation"></a>  <a name="installation"></a>
65  <h3>3.a&nbsp; Installation</h3>  <h3>3.&nbsp; The LinuxSampler package</h3>
66  <ol>  <ol>
67    <li>Install <A HREF="http://www.jackosx.com">JackOSX</A>    
68    (if you don't have it already).    <li>Combined binaries of LinuxSampler and its derivatives for both Intel- and PowerPC-based Apple
69    </li>    machines can be obtained by downloading the "LinuxSampler-1.0.0-OS_X.universal.dmg" disk image
   <li>Download the latest version of the LinuxSampler Mac OS X installer  
70    from the <a href="http://www.linuxsampler.org/downloads.html">LinuxSampler    from the <a href="http://www.linuxsampler.org/downloads.html">LinuxSampler
71    Download Page</a>, and mount it on Finder.    Download Page</a>.
72      </li>
73      <br>
74      <li> After mounting and extracting the contents of the disk image on your computer's desktop,
75      open the "linuxsampler-1.0.0" volume. The following choices are available:
76    </li>    </li>
77    <li>You will find a single folder "linuxsampler051-mac". Copy this    <ol><ol>
78    folder to wherever you like (e.g. under /Applications).    <br>
79       <img src="screenshots/linuxsampler-1-0-0-dmg.png" border="0">
80      </ol></ol></ol>
81      <br>
82      <li> This disk image contains two sets of universal binaries. The first set designated simply <i>LinuxSampler</i> is linked to
83    Apple's proprietary CoreAudio driver while the second <i>LinuxSampler(JACK)</i> folder contains binaries linked to the
84    third-party JACK (Jack Audio Connection Kit) audio server framework. In addition there is also the <i>LinuxSamplerAU.component</i>
85    Audio Unit plug-in which can be used within OS X-deployed DAWs for loading up virtual instruments.
86    </li>    </li>
87      <br>
88    The <i>LinuxSampler</i> folder contains the triple-architecture (ppc/i386/x86_64) universal binaries of "linuxsampler" and the
89    "LinuxSamplerAU.component" DAW plug-in.
90    <br><br>
91    The <i>LinuxSamplerAU.component</i> plug-in should be dragged and dropped into the /Library/Audio/Plug-Ins/Components folder as
92    shown by the rightward arrow. In a similar way, place the <i>LinuxSampler</i> folder into the /Applications folder
93      <ol><ol>
94    <h3>3.1.&nbsp; Loading a Virtual Instrument in your DAW</h3>
95      <li> For a basic demonstration, we will load up the LinuxSamplerAU plug-in into GarageBand. First open the "Track Info" window:
96    Track / Show track Info. Then in the Track Info window select "LinuxSampler Unit" from the "Generator" tab.
97      </li>  
98      <br>
99      </ol></ol>
100      <img src="screenshots/garageband-trackinfo.jpg"" border="0">
101      <br><br>
102      <li> A gig file can then be loaded using the "qsampler" or "Fantasia" application. Click on the "Add channel" icon
103      in qsampler in order to load a gig file.
104            
105              
106      </li>
107    <br>
108    <a href="http://download.linuxsampler.org/pix/screenshots/osx_qsampler_0_2_1.jpg">
109     <img src="screenshots/qs_0_2_2_osx_1.jpg" border="0">
110    </a>
111    <br><br>
112    You are now ready to lay down your track...
113    <br><br>
114    (Note: JackOSX installation is NOT recommended in this setup since the Jack Audio Connection Kit hinders the initialization
115    of both <i>qsampler</i> and <i>Fantasia</i>.)
116    </ol></ol>
117    <h3>5.&nbsp; The LinuxSampler(JACK) package</h3>
118  </ol>  </ol>
   
 <a name="using"></a>  
 <h3>4.&nbsp; Using the Applications</h3>  
 The folder contains three items, "bin", "linuxsampler" and  
 "qsampler".  
 <ol>  
 <li>Start qsampler.app. The application launches, and you  
 will see messages saying that linuxsampler is now running. After a  
 while, you will also see that the JackPilot application (installed by  
 the JackOSX installer) automatically launches showing the Jack server  
 already running.  
 </li>  
119  <li>  <li>
120  Since CoreMIDI is sometimes too slow to respond when creating a new MIDI device.  This archive contains dual-architecture ppc/i386 binaries of <i>linuxsampler</i> and "qsampler" which function together with
121  so you need to increase "Timeout" parameter in the   <A HREF="http://www.jackosx.com">JackOSX</A>. This setup can be used for running various Jack-enabled applications simultaneously: a setup
122  Options:Server Settings to 10000 msec. (Added note on Jan 7, 2008: this value is now set by default)   that is particularly useful for live situations.
123  </li>   </li>
124  </ol>   <br>
125     <li>
126     After opening the linuxsampler-1.0.0 volume, place the <i>LinuxSampler(JACK)</i> folder into the /Applications directory as
127     indicated by the leftward arrow at the bottom.
128     </li>
129     <ol><ol>
130      <br>
131     <img src="screenshots/linuxsampler-1-0-0-dmg.png" border="0">
132  <a name="setup_midi"></a>  <a name="setup_midi"></a>
133  <h3>4.1&nbsp; Setting up MIDI Input</h3>  <h3>4.1&nbsp; Setting up MIDI Input</h3>
134  In qsampler click on the device configuration tab.  In qsampler click on the "Device configuration" icon and then on Create.
135  Click on the MIDI devices icon and then on Create.  <br><br>
136  <br>  </ol></ol>
137  <br>  <img src="screenshots/qs_midi_device.jpg" border="0">
138    <br><br>
139  If you need multiple MIDI input device, set the "Number of ports" to 2, 3, ... before creating the MIDI device. The multiple ports will be accessible from other MIDI applications as "Linuxsampler_in_0", "Linuxsampler_in_1", etc.  If you need multiple MIDI input device, set the "Number of ports" to 2, 3, ... before creating the MIDI device. The multiple ports will be accessible from other MIDI applications as "Linuxsampler_in_0", "Linuxsampler_in_1", etc.
140  <br>  <br>
141  <br>  <br>
142  (You should be able to create an arbitrary number of MIDI input devices by repeating "Create", but this feature does not work well yet.)  (You should be able to create an arbitrary number of MIDI input devices by repeating "Create", but this feature does not work well yet.)
143    <ol><ol>
144  <a name="setup_audio"></a>  <a name="setup_audio"></a>
145  <h3>4.2&nbsp; Setting up Audio Output</h3>  <h3>4.2&nbsp; Setting up Audio Output</h3>
146  LinuxSampler currently only supports the jack driver model for audio output  Start the Jack audio server using JackPilot.app. The <i>qsampler</i> application can then be launched by double-clicking on its icon.
 on Mac OS X.  
 Click on AUDIO devices icon and then on Create.  
147  <br>  <br>
148  You can of course save and load sampler session as LSCP files which will  
149  automaticall set up audio and midi devices and load samples into the channel strips.  <ol><br>
 <ol>  
150   <li>   <li>
151   Connect audio ports:   Connect audio ports:
152   In the "Connections Manager" pane of JackPilot: linuxsampler --> Built-in audio: in1 & in2   In the "Connections Manager" pane of JackPilot: linuxsampler --> Built-in audio: in1 & in2
153   or   or
154   In the "Connections" window of qjackctl: linuxsampler --> coreaudio<br>   In the "Connections" window of qjackctl: LinuxSampler --> system<br>
155     <br>
156     <a href="http://download.linuxsampler.org/pix/screenshots/osx_qjackctl.jpg">     <a href="http://download.linuxsampler.org/pix/screenshots/osx_qjackctl.jpg">
157      <img src="screenshots/osx_qjackctl_preview.png" border="0">    
158        <img src="screenshots/qjackctl-osx.jpg" border="0">
159     </a>     </a>
160     <br>Intel Mac Note: to use built-in audio in Jack, you need to create an "aggregated device" by using "Audio MIDI Setup". Please look up Jack manual for details.     <br><br>Intel Mac Note: to use built-in audio in Jack, you need to create an "aggregated device" by using "Audio MIDI Setup". Please look up Jack manual for details.
161   </li>   </li>
162     <br>
163   <li>   <li>
164   Start MIDI Patchbay.app and connect your MIDI Input instance (probably your MIDI interface or USB-enabled keyboard) to  the "LinuxSampler_in_0"   Start MIDI Patchbay.app and connect your MIDI Input instance (probably your MIDI interface or USB-enabled keyboard) to  the "LinuxSampler_in_0"
165   MIDI Output<br>   MIDI Output<br><br>
166     </ol></ol>
167     <a href="http://download.linuxsampler.org/pix/screenshots/osx_patchbay.jpg">     <a href="http://download.linuxsampler.org/pix/screenshots/osx_patchbay.jpg">
168      <img src="screenshots/osx_patchbay_preview.png" border="0">      <img src="screenshots/midi-patchbay-osx.jpg" border="0">
169     </a>     </a>
170   </li>   </li>
171  </ol>  <ol>
172    
173  <a name="load_samples"></a>  <a name="load_samples"></a>
174  <h3>4.3&nbsp; Loading Samples</h3>  <h3>4.3&nbsp; Loading Samples</h3>
175  Click on Add Channel. A dialog will appear.  Click on Add Channel. A dialog will appear.
176  Select the GIG file you want to load, the instrument within the GIG file,  Select the GIG file you want to load, the instrument within the GIG file,
177  Audio device, MIDI device, MIDI port and channel.  Audio device, MIDI device, MIDI port and channel.
178  Click OK.  Click OK. The user can then save *.lscp files for convenient future use. In this way, the user can automatically set up audio and midi devices and
179    load samples into the channel strips when recalling a setup.
180  <a name="houston"></a>  <a name="houston"></a>
 <h3>5.&nbsp; Installation Troubleshooting</h3>  
 TODO  
181    
182  <a name="docs"></a>  <a name="docs"></a>
183  <h3>6.&nbsp; Detailed Documentation</h3>  <br><br>
184  You find more detailed documentation about our software  on our official <a href="http://linuxsampler.org/documentation.html">  </ol>
185     <img src="screenshots/qs_0_2_2_osx_2.jpg" border="0">
186    </ol></ol>
187    <h3>5.&nbsp; Detailed Documentation</h3>
188    You can find more detailed documentation about our software  on our official <a href="http://linuxsampler.org/documentation.html">
189  LinuxSampler documentation site</a>.  LinuxSampler documentation site</a>.
190    
191  <a name="bugs"></a>  <a name="bugs"></a>
192  <h3>7.&nbsp; Bugs, Problems and Feature Requests</h3>  <h3>6.&nbsp; Bugs, Problems and Feature Requests</h3>
193  Our Forum is a good place to ask for help:<br>  Our Forum is a good place to ask for help:<br>
194  <br>  <br>
195  &nbsp;&nbsp;&nbsp;&nbsp;<a href="https://bb.linuxsampler.org">https://bb.linuxsampler.org</a><br>  &nbsp;&nbsp;&nbsp;&nbsp;<a href="https://bb.linuxsampler.org">https://bb.linuxsampler.org</a><br>
# Line 187  Our Forum is a good place to ask for hel Line 197  Our Forum is a good place to ask for hel
197  We have a dedicated forum section for  We have a dedicated forum section for
198  newbies and support.<br>  newbies and support.<br>
199  <br>  <br>
200  There could be several bugs in the Mac OS X version of LinuxSampler which we hope to root out soon.  
201  Please report them using our bug tracking system:<br>  Please report any bugs using our bug tracking system:<br>
202  <br>  <br>
203  &nbsp;&nbsp;&nbsp;&nbsp;<a href="http://bugs.linuxsampler.org/">http://bugs.linuxsampler.org/</a><br>  &nbsp;&nbsp;&nbsp;&nbsp;<a href="http://bugs.linuxsampler.org/">http://bugs.linuxsampler.org/</a><br>
204  <br>  <br>
205  Some bugs and problems we discovered so far:  Some bugs and problems we discovered so far:
206  <ul>  <ul>
207  <li>The current LinuxSampler for Mac OS X binary distribution does not ship with gigedit yet  <li>The current LinuxSampler for Mac OS X binary distribution does not ship with gigedit yet.
208  <br>  While gigedit works using gtk with X11.app, the large number of dependencies
209  Toshi writes: I tried gigedit with X11 and gtk on my Mac. It worked, but the  on external libraries makes it very arduous to prepare a universal binary.
 installation process was too much complicated for ordinary users (so  
 complicated that I cannot remember exactly how I did that myself). We  
 still have a long way before gigedit can be part of binary distribution  
 for Mac.  
210  </li>  </li>
211    <li>if you overload the sampler (CPU overload or disk overload) it    <li>Overloading the sampler (CPU overload or disk overload)
212    produces noises</li>    produces noise.</li>
213  <li>    <li>  
214    QSampler crashes when one tries to create a second port of jack.    QSampler crashes when one tries to create a second port of jack.
215    An error dialog saying the device was not created, after the dialog is dismissed the QSampler crashes.    An error dialog saying the device was not created, after the dialog is dismissed the QSampler crashes.
216  </li>  </li>
217  <li>  <li>
218     Another problem in QSampler. It sometimes fails to quit     Sometimes qsampler fails to quit gracefully; this calls for "Force Quit". After force quitting, the
219  gracefully, and I need to do "Force Quit". After force quitting, the  linuxsampler subprocess is still running. In this case, simply invoke "killall linuxsampler" from Terminal.app to terminate
220  linuxsampler subprocess is still running and I need to stop it by  linuxsampler.
 "killall linuxsampler".  
 </li>  
 <li>  
    JackPilot may not launch automatically after QSampler launches. On the other hand, if it is already running, the screen of JackPilot may not display correctly the current status of the jack daemon. In such cases please quit and restart JackPilot manually.  
221  </li>  </li>
222    
223  </ul>  </ul>
224    
225  <a name="credits"></a>  <a name="credits"></a>
226  <h3>8.&nbsp; Credits</h3>  <h3>7.&nbsp; Credits</h3>
227  Thanks to Stephane Letz (Initial OS X port) and  Ebrahim Mayat (OSX Howto fixes, testing, screenshots)  LinuxSampler was conceived and created by the collective effort of
228    <a href="http://www.linuxsampler.org/developers.html">a dedicated group of individuals</a><br>
229    
230  <a name="contact"></a>  <a name="contact"></a>
231  <h3>9.&nbsp; Contact</h3>  <h3>8.&nbsp; Contact</h3>
232  If you have questions or want to help us to improve the sampler,  If you have questions or want to help us to improve the sampler,
233  subscribe to the <a href="http://www.linuxsampler.org/developers.html">  subscribe to the <a href="http://www.linuxsampler.org/developers.html">
234  LinuxSampler Developer's mailing list</a>.  LinuxSampler Developer's mailing list</a>.
Legend:
Removed from v.1996  
changed lines
  Added in v.1997
  ViewVC Help
Powered by ViewVC