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

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

Parent Directory Parent Directory | Revision Log Revision Log


Revision 2003 - (show annotations) (download) (as text)
Sat Oct 10 13:04:22 2009 UTC (10 years, 4 months ago) by iliev
File MIME type: text/html
File size: 11072 byte(s)
updated osx howto

1 <!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 Mac OS X</title>
7 <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">
9 </head>
10 <body>
11 <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>
13 <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;">
15 <a href="#intro">1.&nbsp; Introduction</a><br>
16 <a href="#requirements">2.&nbsp; Requirements</a><br>
17 <a href="#installation">3.&nbsp; The LinuxSampler package</a><br>
18 <a href="#installation">4.&nbsp; The LinuxSampler(JACK) package</a><br>
19 <a href="#docs">5.&nbsp; Detailed Documentation</a><br>
20 <a href="#bugs">6.&nbsp; Bugs, Problems and Feature Requests</a><br>
21 <a href="#credits">7.&nbsp; Credits</a><br>
22 <a href="#contact">8.&nbsp; Contact</a><br>
23 </div>
24 <p>
25 <center>
26 <script type="text/javascript"><!--
27 google_ad_client = "pub-3408196773880325";
28 /* 728x90, created 8/3/09 */
29 google_ad_slot = "7744776541";
30 google_ad_width = 728;
31 google_ad_height = 90;
32 //-->
33 </script>
34 <script type="text/javascript"
35 src="http://pagead2.googlesyndication.com/pagead/show_ads.js">
36 </script>
37 </center>
38 </p>
39 <a name="intro"></a>
40 <h3>1.&nbsp; Introduction</h3>
41
42 The LinuxSampler development team is delighted to announce the release of LinuxSampler-1.0.0 for Mac OS X.
43 LinuxSampler is an open-source disc-streaming software sampler that enables the expressive emulation
44 of instruments by the means of MIDI-triggered rendering of large sample sets. While the modular design
45 of LinuxSampler allows for multi-engine and multi-format features, the present implementation of the Gig
46 engine already has the capability for producing virtual instruments with realistic emulations. VST (Linux, Windows)
47 and Audio Unit (OS X) plug-ins for digital audio workstations (DAWs) facilitate the use of this sampler within audio
48 and MIDI sequencer applications. With its LinuxSampler Control Protocol (LSCP), LinuxSampler can be controlled over
49 a computer network so that a cluster can be used as a gigantic sampler. Since this network protocol is ASCII-based,
50 frontends for it can be written in any programming language and for any operating system. LinuxSampler itself is a server
51 application that can be controlled by GUI frontends like the C++-based Qsampler and the Java-implemented Fantasia. The
52 present release can be deployed on Linux, OS X and Windows. The instructions for using the OS X binaries are outlined here.
53
54
55 <a name="requirements"></a>
56 <h3>2.&nbsp; Requirements</h3>
57 <ul>
58 <li>PPC or Intel Mac
59 <li>Mac OS X Leopard and Snow Leopard </li>
60 <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://www.apple.com/downloads/macosx/audio/midipatchbay.html">Pete Yandell's MIDI Patchbay</A> </li>
62 </ul>
63
64 <a name="installation"></a>
65 <h3>3.&nbsp; The LinuxSampler package</h3>
66 <ol>
67
68 <li>Combined binaries of LinuxSampler and its derivatives for both Intel- and PowerPC-based Apple
69 machines can be obtained by downloading the "LinuxSampler-1.0.0-OS_X.universal.dmg" disk image
70 from the <a href="http://www.linuxsampler.org/downloads.html">LinuxSampler
71 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>
77 <ol><ol>
78 <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>
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 </li>
105 <br>
106 <a href="http://download.linuxsampler.org/pix/screenshots/osx_qsampler_0_2_1.jpg">
107 <img src="screenshots/qs_0_2_2_osx_1.jpg" border="0">
108 </a>
109 <br><br>
110 You are now ready to lay down your track...
111 <br><br>
112 (Note: JackOSX installation is NOT recommended in this setup since the Jack Audio Connection Kit hinders the initialization
113 of both <i>qsampler</i> and <i>Fantasia</i>.)
114 <br>
115 You may also read the <a href="jsampler/manual/html/jsampler.html">JSampler Manual</a> to find out how to configure LinuxSampler using <a href="screenshots/fantasia-osx.png">Fantasia</a>.
116 </ol></ol>
117 <h3>4.&nbsp; The LinuxSampler(JACK) package</h3>
118 </ol>
119 <li>
120 This archive contains dual-architecture ppc/i386 binaries of <i>linuxsampler</i> and "qsampler" which function together with
121 <A HREF="http://www.jackosx.com">JackOSX</A>. This setup can be used for running various Jack-enabled applications simultaneously: a setup
122 that is particularly useful for live situations.
123 </li>
124 <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>
133 <h3>4.1&nbsp; Setting up MIDI Input</h3>
134 In qsampler click on the "Device configuration" icon and then on Create.
135 <br><br>
136 </ol></ol>
137 <img src="screenshots/qs_midi_device.jpg" border="0">
138 <br><br>
139 If you need multiple MIDI input devices, 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>
141 <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.)
143 <ol><ol>
144 <a name="setup_audio"></a>
145 <h3>4.2&nbsp; Setting up Audio Output</h3>
146 Start the Jack audio server using JackPilot.app. The <i>qsampler</i> application can then be launched by double-clicking on its icon.
147 <br>
148 Load a gig file into qsampler by clicking on <i>Add Channel</i>. A dialog will appear. Select the GIG file you want to load,
149 the instrument within the GIG file, the Audio device, the MIDI device and the MIDI port and channel.
150 <br><br>
151 <img src="screenshots/qs_0_2_2_osx_channel_setup.jpg" border="0">
152
153 <ol><br>
154
155 Connect audio ports:
156 In the "Connections Manager" pane of JackPilot: linuxsampler --> Built-in audio: in1 & in2
157 or
158 In the "Connections" window of qjackctl: LinuxSampler --> system<br>
159 <br>
160 <a href="http://download.linuxsampler.org/pix/screenshots/osx_qjackctl.jpg">
161
162 <img src="screenshots/qjackctl-osx.jpg" border="0">
163 </a>
164 <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.
165
166 <br>
167
168 <h3>4.3&nbsp; Configuring MIDI Input/Output</h3>
169 Start MIDI Patchbay.app and connect your MIDI Input instance (probably your MIDI interface or USB-enabled keyboard) to the "LinuxSampler_in_0"
170 MIDI Output<br><br>
171 </ol></ol>
172 <a href="http://download.linuxsampler.org/pix/screenshots/osx_patchbay.jpg">
173 <img src="screenshots/midi-patchbay-osx.jpg" border="0">
174 </a>
175
176 <ol>
177
178 <a name="load_samples"></a>
179 <h3>4.4&nbsp; Loading Additional Samples</h3>
180 After loading additional gig files, the user can then save *.lscp files for convenient future use.
181 In this way, the user can automatically set up audio and midi devices and
182 load samples into the channel strips when recalling a setup.
183 <a name="houston"></a>
184
185 <a name="docs"></a>
186 <br><br>
187 </ol>
188 <img src="screenshots/qs_0_2_2_osx_2.jpg" border="0">
189 </ol></ol>
190 <h3>5.&nbsp; Detailed Documentation</h3>
191 You can find more detailed documentation about our software on our official <a href="http://linuxsampler.org/documentation.html">
192 LinuxSampler documentation site</a>.
193
194 <a name="bugs"></a>
195 <h3>6.&nbsp; Bugs, Problems and Feature Requests</h3>
196 Our Forum is a good place to ask for help:<br>
197 <br>
198 &nbsp;&nbsp;&nbsp;&nbsp;<a href="https://bb.linuxsampler.org">https://bb.linuxsampler.org</a><br>
199 <br>
200 We have a dedicated forum section for
201 newbies and support.<br>
202 <br>
203
204 Please report any bugs using our bug tracking system:<br>
205 <br>
206 &nbsp;&nbsp;&nbsp;&nbsp;<a href="http://bugs.linuxsampler.org/">http://bugs.linuxsampler.org/</a><br>
207 <br>
208 Some bugs and problems we discovered so far:
209 <ul>
210 <li>The current LinuxSampler for Mac OS X binary distribution does not ship with gigedit yet.
211 While gigedit works using gtk with X11.app, the large number of dependencies
212 on external libraries makes it very arduous to prepare a universal binary.
213 </li>
214 <li>Overloading the sampler (CPU overload or disk overload)
215 produces noise.</li>
216 <li>
217 QSampler crashes when one tries to create a second port of jack.
218 An error dialog saying that "the device was not created" appears. After the dialog is dismissed qsampler crashes.
219 </li>
220 <li>
221 Sometimes qsampler fails to quit gracefully; this calls for "Force Quit". After force quitting, the
222 linuxsampler subprocess is still running. In this case, simply invoke "killall linuxsampler" from Terminal.app to terminate
223 linuxsampler.
224 </li>
225
226 </ul>
227
228 <a name="credits"></a>
229 <h3>7.&nbsp; Credits</h3>
230 LinuxSampler was conceived and created by the collective effort of
231 <a href="http://www.linuxsampler.org/developers.html">a dedicated group of individuals</a><br>
232
233 <a name="contact"></a>
234 <h3>8.&nbsp; Contact</h3>
235 If you have questions or want to help us to improve the sampler,
236 subscribe to the <a href="http://www.linuxsampler.org/developers.html">
237 LinuxSampler Developer's mailing list</a>.
238 <br><br>
239 That's it, enjoy!<br>
240 <br>
241
242 </body>
243 </html>

  ViewVC Help
Powered by ViewVC