/[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 2001 - (hide annotations) (download) (as text)
Mon Sep 28 14:30:43 2009 UTC (14 years, 6 months ago) by iliev
File MIME type: text/html
File size: 10864 byte(s)
added link to the JSampler manual

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     src="http://pagead2.googlesyndication.com/pagead/show_ads.js">
36     </script>
37     </center>
38     </p>
39 senoner 1614 <a name="intro"></a>
40     <h3>1.&nbsp; Introduction</h3>
41    
42 iliev 1997 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 senoner 1614 <a name="requirements"></a>
56     <h3>2.&nbsp; Requirements</h3>
57     <ul>
58 iliev 1997 <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 senoner 1614 </ul>
63    
64     <a name="installation"></a>
65 iliev 1997 <h3>3.&nbsp; The LinuxSampler package</h3>
66 schoenebeck 1618 <ol>
67 iliev 1997
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 schoenebeck 1618 from the <a href="http://www.linuxsampler.org/downloads.html">LinuxSampler
71 iliev 1997 Download Page</a>.
72 schoenebeck 1618 </li>
73 iliev 1997 <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 schoenebeck 1618 </li>
77 iliev 1997 <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 iliev 2001 <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 <i>Fantasia</i>.
116 iliev 1997 </ol></ol>
117 iliev 2000 <h3>4.&nbsp; The LinuxSampler(JACK) package</h3>
118 schoenebeck 1618 </ol>
119 senoner 1628 <li>
120 iliev 1997 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 senoner 1614 <a name="setup_midi"></a>
133     <h3>4.1&nbsp; Setting up MIDI Input</h3>
134 iliev 1997 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 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.
140 nagata 1634 <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 iliev 1997 <ol><ol>
144 senoner 1614 <a name="setup_audio"></a>
145     <h3>4.2&nbsp; Setting up Audio Output</h3>
146 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.
147 senoner 1614 <br>
148 iliev 1997
149     <ol><br>
150 iliev 2000
151 senoner 1628 Connect audio ports:
152     In the "Connections Manager" pane of JackPilot: linuxsampler --> Built-in audio: in1 & in2
153     or
154 iliev 1997 In the "Connections" window of qjackctl: LinuxSampler --> system<br>
155     <br>
156 schoenebeck 1630 <a href="http://download.linuxsampler.org/pix/screenshots/osx_qjackctl.jpg">
157 iliev 1997
158     <img src="screenshots/qjackctl-osx.jpg" border="0">
159 schoenebeck 1630 </a>
160 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.
161 iliev 2000
162 iliev 1997 <br>
163 iliev 2000
164     <h3>4.3&nbsp; Configuring MIDI Input/Output</h3>
165 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"
166 iliev 1997 MIDI Output<br><br>
167     </ol></ol>
168 schoenebeck 1630 <a href="http://download.linuxsampler.org/pix/screenshots/osx_patchbay.jpg">
169 iliev 1997 <img src="screenshots/midi-patchbay-osx.jpg" border="0">
170 schoenebeck 1630 </a>
171 iliev 2000
172 iliev 1997 <ol>
173 senoner 1614
174     <a name="load_samples"></a>
175 iliev 2000 <h3>4.4&nbsp; Loading Samples</h3>
176 senoner 1614 Click on Add Channel. A dialog will appear.
177 senoner 1615 Select the GIG file you want to load, the instrument within the GIG file,
178 senoner 1614 Audio device, MIDI device, MIDI port and channel.
179 iliev 1997 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
180     load samples into the channel strips when recalling a setup.
181 senoner 1614 <a name="houston"></a>
182    
183     <a name="docs"></a>
184 iliev 1997 <br><br>
185     </ol>
186     <img src="screenshots/qs_0_2_2_osx_2.jpg" border="0">
187     </ol></ol>
188     <h3>5.&nbsp; Detailed Documentation</h3>
189     You can find more detailed documentation about our software on our official <a href="http://linuxsampler.org/documentation.html">
190 senoner 1614 LinuxSampler documentation site</a>.
191    
192     <a name="bugs"></a>
193 iliev 1997 <h3>6.&nbsp; Bugs, Problems and Feature Requests</h3>
194 schoenebeck 1676 Our Forum is a good place to ask for help:<br>
195     <br>
196     &nbsp;&nbsp;&nbsp;&nbsp;<a href="https://bb.linuxsampler.org">https://bb.linuxsampler.org</a><br>
197     <br>
198     We have a dedicated forum section for
199     newbies and support.<br>
200     <br>
201 iliev 1997
202     Please report any bugs using our bug tracking system:<br>
203 senoner 1614 <br>
204     &nbsp;&nbsp;&nbsp;&nbsp;<a href="http://bugs.linuxsampler.org/">http://bugs.linuxsampler.org/</a><br>
205     <br>
206     Some bugs and problems we discovered so far:
207     <ul>
208 iliev 1997 <li>The current LinuxSampler for Mac OS X binary distribution does not ship with gigedit yet.
209     While gigedit works using gtk with X11.app, the large number of dependencies
210     on external libraries makes it very arduous to prepare a universal binary.
211 senoner 1614 </li>
212 iliev 1997 <li>Overloading the sampler (CPU overload or disk overload)
213     produces noise.</li>
214 senoner 1614 <li>
215     QSampler crashes when one tries to create a second port of jack.
216 iliev 2000 An error dialog saying that "the device was not created" appears. After the dialog is dismissed qsampler crashes.
217 senoner 1614 </li>
218     <li>
219 iliev 1997 Sometimes qsampler fails to quit gracefully; this calls for "Force Quit". After force quitting, the
220     linuxsampler subprocess is still running. In this case, simply invoke "killall linuxsampler" from Terminal.app to terminate
221     linuxsampler.
222 senoner 1614 </li>
223 iliev 1997
224 senoner 1614 </ul>
225    
226 schoenebeck 1630 <a name="credits"></a>
227 iliev 1997 <h3>7.&nbsp; Credits</h3>
228     LinuxSampler was conceived and created by the collective effort of
229     <a href="http://www.linuxsampler.org/developers.html">a dedicated group of individuals</a><br>
230 schoenebeck 1630
231 senoner 1614 <a name="contact"></a>
232 iliev 1997 <h3>8.&nbsp; Contact</h3>
233 senoner 1614 If you have questions or want to help us to improve the sampler,
234     subscribe to the <a href="http://www.linuxsampler.org/developers.html">
235 schoenebeck 1630 LinuxSampler Developer's mailing list</a>.
236 senoner 1614 <br><br>
237     That's it, enjoy!<br>
238     <br>
239 schoenebeck 1630
240 senoner 1614 </body>
241     </html>

  ViewVC Help
Powered by ViewVC