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

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

Parent Directory Parent Directory | Revision Log Revision Log


Revision 2656 - (hide annotations) (download) (as text)
Thu Jun 19 13:36:49 2014 UTC (9 years, 9 months ago) by schoenebeck
File MIME type: text/html
File size: 11153 byte(s)
* updated documentation page.

1 senoner 1614 <!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 iliev 1997 <link rel="shortcut icon" href="/favicon.ico" type="image/x-icon">
8 senoner 1614 <link rel="stylesheet" type="text/css" href="libgig/css/content.css" title="content" media="all">
9     </head>
10     <body>
11 iliev 1997 <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 senoner 1614 <br>
13 iliev 1997 <center>September&nbsp;20th,&nbsp;2009</center><br>
14 senoner 1614 <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 iliev 1997 <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 senoner 1614 </div>
24 senoner 1983 <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 persson 2479 src="//pagead2.googlesyndication.com/pagead/show_ads.js">
36 senoner 1983 </script>
37     </center>
38     </p>
39 schoenebeck 2656
40     <p class="caution">
41     <b>NOTE:</b> This HOWTO is currently completely out-dated!
42     </b>
43    
44 senoner 1614 <a name="intro"></a>
45     <h3>1.&nbsp; Introduction</h3>
46    
47 iliev 1997 The LinuxSampler development team is delighted to announce the release of LinuxSampler-1.0.0 for Mac OS X.
48     LinuxSampler is an open-source disc-streaming software sampler that enables the expressive emulation
49     of instruments by the means of MIDI-triggered rendering of large sample sets. While the modular design
50     of LinuxSampler allows for multi-engine and multi-format features, the present implementation of the Gig
51     engine already has the capability for producing virtual instruments with realistic emulations. VST (Linux, Windows)
52     and Audio Unit (OS X) plug-ins for digital audio workstations (DAWs) facilitate the use of this sampler within audio
53     and MIDI sequencer applications. With its LinuxSampler Control Protocol (LSCP), LinuxSampler can be controlled over
54     a computer network so that a cluster can be used as a gigantic sampler. Since this network protocol is ASCII-based,
55     frontends for it can be written in any programming language and for any operating system. LinuxSampler itself is a server
56     application that can be controlled by GUI frontends like the C++-based Qsampler and the Java-implemented Fantasia. The
57     present release can be deployed on Linux, OS X and Windows. The instructions for using the OS X binaries are outlined here.
58    
59    
60 senoner 1614 <a name="requirements"></a>
61     <h3>2.&nbsp; Requirements</h3>
62     <ul>
63 iliev 1997 <li>PPC or Intel Mac
64     <li>Mac OS X Leopard and Snow Leopard </li>
65     <li> For the LinuxSampler(JACK) package: <A HREF="http://www.jackosx.com">JackOSX</A>. Install it before LinuxSampler(JACK)</li>
66     <li><A HREF="http://www.apple.com/downloads/macosx/audio/midipatchbay.html">Pete Yandell's MIDI Patchbay</A> </li>
67 senoner 1614 </ul>
68    
69     <a name="installation"></a>
70 iliev 1997 <h3>3.&nbsp; The LinuxSampler package</h3>
71 schoenebeck 1618 <ol>
72 iliev 1997
73     <li>Combined binaries of LinuxSampler and its derivatives for both Intel- and PowerPC-based Apple
74     machines can be obtained by downloading the "LinuxSampler-1.0.0-OS_X.universal.dmg" disk image
75 schoenebeck 1618 from the <a href="http://www.linuxsampler.org/downloads.html">LinuxSampler
76 iliev 1997 Download Page</a>.
77 schoenebeck 1618 </li>
78 iliev 1997 <br>
79     <li> After mounting and extracting the contents of the disk image on your computer's desktop,
80     open the "linuxsampler-1.0.0" volume. The following choices are available:
81 schoenebeck 1618 </li>
82 iliev 1997 <ol><ol>
83     <br>
84     <img src="screenshots/linuxsampler-1-0-0-dmg.png" border="0">
85     </ol></ol></ol>
86     <br>
87     <li> This disk image contains two sets of universal binaries. The first set designated simply <i>LinuxSampler</i> is linked to
88     Apple's proprietary CoreAudio driver while the second <i>LinuxSampler(JACK)</i> folder contains binaries linked to the
89     third-party JACK (Jack Audio Connection Kit) audio server framework. In addition there is also the <i>LinuxSamplerAU.component</i>
90     Audio Unit plug-in which can be used within OS X-deployed DAWs for loading up virtual instruments.
91     </li>
92     <br>
93     The <i>LinuxSampler</i> folder contains the triple-architecture (ppc/i386/x86_64) universal binaries of "linuxsampler" and the
94     "LinuxSamplerAU.component" DAW plug-in.
95     <br><br>
96     The <i>LinuxSamplerAU.component</i> plug-in should be dragged and dropped into the /Library/Audio/Plug-Ins/Components folder as
97     shown by the rightward arrow. In a similar way, place the <i>LinuxSampler</i> folder into the /Applications folder
98     <ol><ol>
99     <h3>3.1.&nbsp; Loading a Virtual Instrument in your DAW</h3>
100     <li> For a basic demonstration, we will load up the LinuxSamplerAU plug-in into GarageBand. First open the "Track Info" window:
101     Track / Show track Info. Then in the Track Info window select "LinuxSampler Unit" from the "Generator" tab.
102     </li>
103     <br>
104     </ol></ol>
105     <img src="screenshots/garageband-trackinfo.jpg"" border="0">
106     <br><br>
107     <li> A gig file can then be loaded using the "qsampler" or "Fantasia" application. Click on the "Add channel" icon
108     in qsampler in order to load a gig file.
109     </li>
110     <br>
111     <a href="http://download.linuxsampler.org/pix/screenshots/osx_qsampler_0_2_1.jpg">
112     <img src="screenshots/qs_0_2_2_osx_1.jpg" border="0">
113     </a>
114     <br><br>
115     You are now ready to lay down your track...
116     <br><br>
117     (Note: JackOSX installation is NOT recommended in this setup since the Jack Audio Connection Kit hinders the initialization
118     of both <i>qsampler</i> and <i>Fantasia</i>.)
119 iliev 2001 <br>
120 iliev 2002 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>.
121 iliev 1997 </ol></ol>
122 iliev 2000 <h3>4.&nbsp; The LinuxSampler(JACK) package</h3>
123 schoenebeck 1618 </ol>
124 senoner 1628 <li>
125 iliev 1997 This archive contains dual-architecture ppc/i386 binaries of <i>linuxsampler</i> and "qsampler" which function together with
126     <A HREF="http://www.jackosx.com">JackOSX</A>. This setup can be used for running various Jack-enabled applications simultaneously: a setup
127     that is particularly useful for live situations.
128     </li>
129     <br>
130     <li>
131     After opening the linuxsampler-1.0.0 volume, place the <i>LinuxSampler(JACK)</i> folder into the /Applications directory as
132     indicated by the leftward arrow at the bottom.
133     </li>
134     <ol><ol>
135     <br>
136     <img src="screenshots/linuxsampler-1-0-0-dmg.png" border="0">
137 senoner 1614 <a name="setup_midi"></a>
138     <h3>4.1&nbsp; Setting up MIDI Input</h3>
139 iliev 1997 In qsampler click on the "Device configuration" icon and then on Create.
140     <br><br>
141     </ol></ol>
142     <img src="screenshots/qs_midi_device.jpg" border="0">
143     <br><br>
144 iliev 2000 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.
145 nagata 1634 <br>
146     <br>
147     (You should be able to create an arbitrary number of MIDI input devices by repeating "Create", but this feature does not work well yet.)
148 iliev 1997 <ol><ol>
149 senoner 1614 <a name="setup_audio"></a>
150     <h3>4.2&nbsp; Setting up Audio Output</h3>
151 iliev 1997 Start the Jack audio server using JackPilot.app. The <i>qsampler</i> application can then be launched by double-clicking on its icon.
152 senoner 1614 <br>
153 iliev 2003 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,
154     the instrument within the GIG file, the Audio device, the MIDI device and the MIDI port and channel.
155     <br><br>
156     <img src="screenshots/qs_0_2_2_osx_channel_setup.jpg" border="0">
157 iliev 1997
158     <ol><br>
159 iliev 2000
160 senoner 1628 Connect audio ports:
161     In the "Connections Manager" pane of JackPilot: linuxsampler --> Built-in audio: in1 & in2
162     or
163 iliev 1997 In the "Connections" window of qjackctl: LinuxSampler --> system<br>
164     <br>
165 schoenebeck 1630 <a href="http://download.linuxsampler.org/pix/screenshots/osx_qjackctl.jpg">
166 iliev 1997
167     <img src="screenshots/qjackctl-osx.jpg" border="0">
168 schoenebeck 1630 </a>
169 iliev 1997 <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.
170 iliev 2000
171 iliev 1997 <br>
172 iliev 2000
173     <h3>4.3&nbsp; Configuring MIDI Input/Output</h3>
174 senoner 1628 Start MIDI Patchbay.app and connect your MIDI Input instance (probably your MIDI interface or USB-enabled keyboard) to the "LinuxSampler_in_0"
175 iliev 1997 MIDI Output<br><br>
176     </ol></ol>
177 schoenebeck 1630 <a href="http://download.linuxsampler.org/pix/screenshots/osx_patchbay.jpg">
178 iliev 1997 <img src="screenshots/midi-patchbay-osx.jpg" border="0">
179 schoenebeck 1630 </a>
180 iliev 2000
181 iliev 1997 <ol>
182 senoner 1614
183     <a name="load_samples"></a>
184 iliev 2003 <h3>4.4&nbsp; Loading Additional Samples</h3>
185     After loading additional gig files, the user can then save *.lscp files for convenient future use.
186     In this way, the user can automatically set up audio and midi devices and
187 iliev 1997 load samples into the channel strips when recalling a setup.
188 senoner 1614 <a name="houston"></a>
189    
190     <a name="docs"></a>
191 iliev 1997 <br><br>
192     </ol>
193     <img src="screenshots/qs_0_2_2_osx_2.jpg" border="0">
194     </ol></ol>
195     <h3>5.&nbsp; Detailed Documentation</h3>
196     You can find more detailed documentation about our software on our official <a href="http://linuxsampler.org/documentation.html">
197 senoner 1614 LinuxSampler documentation site</a>.
198    
199     <a name="bugs"></a>
200 iliev 1997 <h3>6.&nbsp; Bugs, Problems and Feature Requests</h3>
201 schoenebeck 1676 Our Forum is a good place to ask for help:<br>
202     <br>
203     &nbsp;&nbsp;&nbsp;&nbsp;<a href="https://bb.linuxsampler.org">https://bb.linuxsampler.org</a><br>
204     <br>
205     We have a dedicated forum section for
206     newbies and support.<br>
207     <br>
208 iliev 1997
209     Please report any bugs using our bug tracking system:<br>
210 senoner 1614 <br>
211     &nbsp;&nbsp;&nbsp;&nbsp;<a href="http://bugs.linuxsampler.org/">http://bugs.linuxsampler.org/</a><br>
212     <br>
213     Some bugs and problems we discovered so far:
214     <ul>
215 iliev 1997 <li>The current LinuxSampler for Mac OS X binary distribution does not ship with gigedit yet.
216     While gigedit works using gtk with X11.app, the large number of dependencies
217     on external libraries makes it very arduous to prepare a universal binary.
218 senoner 1614 </li>
219 iliev 1997 <li>Overloading the sampler (CPU overload or disk overload)
220     produces noise.</li>
221 senoner 1614 <li>
222     QSampler crashes when one tries to create a second port of jack.
223 iliev 2000 An error dialog saying that "the device was not created" appears. After the dialog is dismissed qsampler crashes.
224 senoner 1614 </li>
225     <li>
226 iliev 1997 Sometimes qsampler fails to quit gracefully; this calls for "Force Quit". After force quitting, the
227     linuxsampler subprocess is still running. In this case, simply invoke "killall linuxsampler" from Terminal.app to terminate
228     linuxsampler.
229 senoner 1614 </li>
230 iliev 1997
231 senoner 1614 </ul>
232    
233 schoenebeck 1630 <a name="credits"></a>
234 iliev 1997 <h3>7.&nbsp; Credits</h3>
235     LinuxSampler was conceived and created by the collective effort of
236     <a href="http://www.linuxsampler.org/developers.html">a dedicated group of individuals</a><br>
237 schoenebeck 1630
238 senoner 1614 <a name="contact"></a>
239 iliev 1997 <h3>8.&nbsp; Contact</h3>
240 senoner 1614 If you have questions or want to help us to improve the sampler,
241     subscribe to the <a href="http://www.linuxsampler.org/developers.html">
242 schoenebeck 1630 LinuxSampler Developer's mailing list</a>.
243 senoner 1614 <br><br>
244     That's it, enjoy!<br>
245     <br>
246 schoenebeck 1630
247 senoner 1614 </body>
248     </html>

  ViewVC Help
Powered by ViewVC