ViewVC logotype

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

Parent Directory Parent Directory | Revision Log Revision Log

Revision 1628 - (show annotations) (download) (as text)
Sun Jan 6 15:08:42 2008 UTC (16 years, 1 month ago) by senoner
File MIME type: text/html
File size: 8587 byte(s)
OS X Howto additions

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

  ViewVC Help
Powered by ViewVC