/[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 1983 - (show annotations) (download) (as text)
Tue Aug 4 08:59:23 2009 UTC (14 years, 7 months ago) by senoner
File MIME type: text/html
File size: 10393 byte(s)
added Google AdSense ads to /ethernetmidi/index.html , windows.html
osx.html, debian.html, msys.html

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="http://download.linuxsampler.org/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 for Mac OS X &nbsp; <img src="gfx/logos/apple.png"> &nbsp; HOWTO by Toshi Nagata&nbsp;</center></h2>
12 <br>
13 <center>January&nbsp;6th,&nbsp;2008</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; Installation</a><br>
18 <a href="#using">4.&nbsp; Using the Applications</a><br>
19 <a href="#setup_midi">&nbsp;&nbsp;&nbsp;&nbsp;4.1&nbsp; Setting up MIDI Input</a><br>
20 <a href="#setup_audio">&nbsp;&nbsp;&nbsp;&nbsp;4.2&nbsp; Setting up Audio Output</a><br>
21 <a href="#load_samples">&nbsp;&nbsp;&nbsp;&nbsp;4.3&nbsp; Loading Samples</a><br>
22 <a href="#save_session">&nbsp;&nbsp;&nbsp;&nbsp;4.4&nbsp; Saving a Sampler Session</a><br>
23 <a href="#houston">5.&nbsp; Installation Troubleshooting</a><br>
24 <a href="#docs">6.&nbsp; Detailed Documentation</a><br>
25 <a href="#bugs">7.&nbsp; Bugs, Problems and Feature Requests</a><br>
26 <a href="#credits">8.&nbsp; Credits</a><br>
27 <a href="#contact">9.&nbsp; Contact</a><br>
28 </div>
29 <p>
30 <center>
31 <script type="text/javascript"><!--
32 google_ad_client = "pub-3408196773880325";
33 /* 728x90, created 8/3/09 */
34 google_ad_slot = "7744776541";
35 google_ad_width = 728;
36 google_ad_height = 90;
37 //-->
38 </script>
39 <script type="text/javascript"
40 src="http://pagead2.googlesyndication.com/pagead/show_ads.js">
41 </script>
42 </center>
43 </p>
44 <a name="intro"></a>
45 <h3>1.&nbsp; Introduction</h3>
46 The LinuxSampler development team is happy to announce the release of
47 a new version of LinuxSampler of Mac OS X. More information will be added here soon, so check back frequently.<br>
48 <br>
49 For now the sampler supports the CoreMIDI interface
50 for MIDI input and <A HREF="http://www.jackosx.com">jack</A> for audio out. This means it currently runs only
51 as a standalone application. An AU/VST interface will follow at a later stage, along with
52 a network module to run multiple sampler slaves distributed on OS/X, Windows or
53 Linux machines (Linux provides better performance) all controlled from a
54 OS X or Windows box i.e. running the AU / VST sequencer.<br>
55 Even though LinuxSampler presently runs only as standalone app,
56 thanks to jack you can comfortably route the sampler's audio outs back into your sequencer.
57 <br>
58 LinuxSampler is implemented as a client/server application. This means
59 the sampling engine (the server / backend) runs
60 independently from the GUI (the client / frontend). Sampling engine and
61 client can be run on the same box or on different machines too, connected
62 over the network.<br>
63 <br>
64 The Mac OS X version provides all the features of the Linux version
65 since it is built from the same source code base.
66 This means when new features will come out the
67 Mac OS X version will usually provide the same feature set as the Linux
68 version. This was made possible by the very modular design of both
69 low level, operating system functions and flexible audio / MIDI driver
70 system.<br>
71 <br>
72 The Mac OS X version comes as an easy to install DMG file which will
73 install all the necessary modules to run both the server ( bin/linuxsampler )
74 and the GUI client. For now it installs only the qsampler GUI client
75 as JSampler, the sampler frontend written in Java requires Java 1.6 which is not
76 available on OS X yet. Of course you can run JSampler on a Windows or Linux box
77 connected over the network to your OS X box or you could try to run it in a windows
78 virtual machine. We discourage running a virtual machine along with the sampler
79 as both applicationes are very CPU and RAM hungry therefore the performance
80 of LinuxSampler will be suboptimal.<br>
81 <a href="http://download.linuxsampler.org/pix/screenshots/osx_qsampler_0_2_1_color.jpg">
82 <img src="screenshots/osx_qsampler_0_2_1_preview.png" border="0">
83 </a>
84
85 <a name="requirements"></a>
86 <h3>2.&nbsp; Requirements</h3>
87 <ul>
88 <li>PPC or Intel Mac (an Intel Mac should provide much better performance)
89 <li>Mac OS Tiger or later (Leopard should work too)</li>
90 <li><A HREF="http://www.jackosx.com">JackOSX</A>. Install it before LinuxSampler</li>
91 <li><A HREF="http://pete.yandell.com/software/">Pete Yandell's MIDI Patchbay</A> or a similar tool</li>
92 </ul>
93
94 <a name="installation"></a>
95 <h3>3.a&nbsp; Installation</h3>
96 <ol>
97 <li>Install <A HREF="http://www.jackosx.com">JackOSX</A>
98 (if you don't have it already).
99 </li>
100 <li>Download the latest version of the LinuxSampler Mac OS X installer
101 from the <a href="http://www.linuxsampler.org/downloads.html">LinuxSampler
102 Download Page</a>, and mount it on Finder.
103 </li>
104 <li>You will find a single folder "linuxsampler051-mac". Copy this
105 folder to wherever you like (e.g. under /Applications).
106 </li>
107 </ol>
108
109 <a name="using"></a>
110 <h3>4.&nbsp; Using the Applications</h3>
111 The folder contains three items, "bin", "linuxsampler" and
112 "qsampler".
113 <ol>
114 <li>Start qsampler.app. The application launches, and you
115 will see messages saying that linuxsampler is now running. After a
116 while, you will also see that the JackPilot application (installed by
117 the JackOSX installer) automatically launches showing the Jack server
118 already running.
119 </li>
120 <li>
121 Since CoreMIDI is sometimes too slow to respond when creating a new MIDI device.
122 so you need to increase "Timeout" parameter in the
123 Options:Server Settings to 10000 msec. (Added note on Jan 7, 2008: this value is now set by default)
124 </li>
125 </ol>
126
127 <a name="setup_midi"></a>
128 <h3>4.1&nbsp; Setting up MIDI Input</h3>
129 In qsampler click on the device configuration tab.
130 Click on the MIDI devices icon and then on Create.
131 <br>
132 <br>
133 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.
134 <br>
135 <br>
136 (You should be able to create an arbitrary number of MIDI input devices by repeating "Create", but this feature does not work well yet.)
137
138 <a name="setup_audio"></a>
139 <h3>4.2&nbsp; Setting up Audio Output</h3>
140 LinuxSampler currently only supports the jack driver model for audio output
141 on Mac OS X.
142 Click on AUDIO devices icon and then on Create.
143 <br>
144 You can of course save and load sampler session as LSCP files which will
145 automaticall set up audio and midi devices and load samples into the channel strips.
146 <ol>
147 <li>
148 Connect audio ports:
149 In the "Connections Manager" pane of JackPilot: linuxsampler --> Built-in audio: in1 & in2
150 or
151 In the "Connections" window of qjackctl: linuxsampler --> coreaudio<br>
152 <a href="http://download.linuxsampler.org/pix/screenshots/osx_qjackctl.jpg">
153 <img src="screenshots/osx_qjackctl_preview.png" border="0">
154 </a>
155 <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.
156 </li>
157 <li>
158 Start MIDI Patchbay.app and connect your MIDI Input instance (probably your MIDI interface or USB-enabled keyboard) to the "LinuxSampler_in_0"
159 MIDI Output<br>
160 <a href="http://download.linuxsampler.org/pix/screenshots/osx_patchbay.jpg">
161 <img src="screenshots/osx_patchbay_preview.png" border="0">
162 </a>
163 </li>
164 </ol>
165
166 <a name="load_samples"></a>
167 <h3>4.3&nbsp; Loading Samples</h3>
168 Click on Add Channel. A dialog will appear.
169 Select the GIG file you want to load, the instrument within the GIG file,
170 Audio device, MIDI device, MIDI port and channel.
171 Click OK.
172 <a name="houston"></a>
173 <h3>5.&nbsp; Installation Troubleshooting</h3>
174 TODO
175
176 <a name="docs"></a>
177 <h3>6.&nbsp; Detailed Documentation</h3>
178 You find more detailed documentation about our software on our official <a href="http://linuxsampler.org/documentation.html">
179 LinuxSampler documentation site</a>.
180
181 <a name="bugs"></a>
182 <h3>7.&nbsp; Bugs, Problems and Feature Requests</h3>
183 Our Forum is a good place to ask for help:<br>
184 <br>
185 &nbsp;&nbsp;&nbsp;&nbsp;<a href="https://bb.linuxsampler.org">https://bb.linuxsampler.org</a><br>
186 <br>
187 We have a dedicated forum section for
188 newbies and support.<br>
189 <br>
190 There could be several bugs in the Mac OS X version of LinuxSampler which we hope to root out soon.
191 Please report them using our bug tracking system:<br>
192 <br>
193 &nbsp;&nbsp;&nbsp;&nbsp;<a href="http://bugs.linuxsampler.org/">http://bugs.linuxsampler.org/</a><br>
194 <br>
195 Some bugs and problems we discovered so far:
196 <ul>
197 <li>The current LinuxSampler for Mac OS X binary distribution does not ship with gigedit yet
198 <br>
199 Toshi writes: I tried gigedit with X11 and gtk on my Mac. It worked, but the
200 installation process was too much complicated for ordinary users (so
201 complicated that I cannot remember exactly how I did that myself). We
202 still have a long way before gigedit can be part of binary distribution
203 for Mac.
204 </li>
205 <li>if you overload the sampler (CPU overload or disk overload) it
206 produces noises</li>
207 <li>
208 QSampler crashes when one tries to create a second port of jack.
209 An error dialog saying the device was not created, after the dialog is dismissed the QSampler crashes.
210 </li>
211 <li>
212 Another problem in QSampler. It sometimes fails to quit
213 gracefully, and I need to do "Force Quit". After force quitting, the
214 linuxsampler subprocess is still running and I need to stop it by
215 "killall linuxsampler".
216 </li>
217 <li>
218 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.
219 </li>
220 </ul>
221
222 <a name="credits"></a>
223 <h3>8.&nbsp; Credits</h3>
224 Thanks to Stephane Letz (Initial OS X port) and Ebrahim Mayat (OSX Howto fixes, testing, screenshots)
225
226 <a name="contact"></a>
227 <h3>9.&nbsp; Contact</h3>
228 If you have questions or want to help us to improve the sampler,
229 subscribe to the <a href="http://www.linuxsampler.org/developers.html">
230 LinuxSampler Developer's mailing list</a>.
231 <br><br>
232 That's it, enjoy!<br>
233 <br>
234
235 </body>
236 </html>

  ViewVC Help
Powered by ViewVC