ViewVC logotype

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

Parent Directory Parent Directory | Revision Log Revision Log

Revision 1633 - (hide annotations) (download) (as text)
Sun Jan 6 19:15:32 2008 UTC (16 years, 1 month ago) by senoner
File MIME type: text/html
File size: 9124 byte(s)
OS X Howto update

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     <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 schoenebeck 1616 <h2><center>LinuxSampler for Mac OS X &nbsp; <img src="gfx/logos/apple.png"> &nbsp; HOWTO by Toshi Nagata&nbsp;</center></h2>
12 senoner 1614 <br>
13 senoner 1628 <center>January&nbsp;6th,&nbsp;2008</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     <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 schoenebeck 1632 <a href="#credits">8.&nbsp; Credits</a><br>
27 schoenebeck 1630 <a href="#contact">9.&nbsp; Contact</a><br>
28 senoner 1614 </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 senoner 1615 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 senoner 1614 <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 senoner 1615 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 senoner 1614 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 schoenebeck 1630 of LinuxSampler will be suboptimal.<br>
67     <a href="http://download.linuxsampler.org/pix/screenshots/osx_qsampler_0_2_1.jpg">
68 senoner 1631 <img src="screenshots/osx_qsampler_0_2_1_preview.png" border="0">
69 schoenebeck 1630 </a>
70 senoner 1614
71     <a name="requirements"></a>
72     <h3>2.&nbsp; Requirements</h3>
73     <ul>
74     <li>PPC or Intel Mac (an Intel Mac should provide much better performance)
75     <li>Mac OS Tiger or later (Leopard should work too)</li>
76     <li><A HREF="http://www.jackosx.com">JackOSX</A>. Install it before LinuxSampler</li>
77 senoner 1633 <li><A HREF="http://pete.yandell.com/software/">Pete Yandell's MIDI Patchbay</A> or a similar tool</li>
78 senoner 1614 </ul>
80     <a name="installation"></a>
81     <h3>3.a&nbsp; Installation</h3>
82 schoenebeck 1618 <ol>
83     <li>Install <A HREF="http://www.jackosx.com">JackOSX</A>
84     (if you don't have it already).
85     </li>
86     <li>Download the latest version of the LinuxSampler Mac OS X installer
87     from the <a href="http://www.linuxsampler.org/downloads.html">LinuxSampler
88     Download Page</a>, and mount it on Finder.
89     </li>
90     <li>You will find a single folder "linuxsampler051-mac-20080102". Copy this
91     folder to wherever you like (e.g. under /Applications).
92     </li>
93     </ol>
95     <a name="using"></a>
96     <h3>4.&nbsp; Using the Applications</h3>
97 senoner 1615 The folder contains three items, "bin", "linuxsampler" and
98 senoner 1628 "qsampler".
99     <ol>
100     <li>Start qsampler.app. The application launches, and you
101 senoner 1615 will see messages saying that linuxsampler is now running. After a
102     while, you will also see that the JackPilot application (installed by
103     the JackOSX installer) automatically launches showing the Jack server
104     already running.
105 senoner 1628 </li>
106     <li>
107     Since CoreMIDI is sometimes too slow to respond when creating a new MIDI device.
108     so you need to increase "Timeout" parameter in the
109     Options:Server Settings to, 10000 msec.
110     </li>
111     </ol>
112 senoner 1614
113     <a name="setup_midi"></a>
114     <h3>4.1&nbsp; Setting up MIDI Input</h3>
115     In qsampler click on the device configuration tab.
116     Click on the MIDI devices icon and then on Create.
118     <br>
119     <br>
120     You can create an arbitrary number of MIDI input devices by repeating
121     the procedure above.
122     Each MIDI device can be routed to arbitrary sampler channels.
124     <a name="setup_audio"></a>
125     <h3>4.2&nbsp; Setting up Audio Output</h3>
126     LinuxSampler currently only supports the jack driver model for audio output
127     on Mac OS X.
128     Click on AUDIO devices icon and then on Create.
129     <br>
130 senoner 1628 You can of course save and load sampler session as LSCP files which will
131     automaticall set up audio and midi devices and load samples into the channel strips.
132     <ol>
133 schoenebeck 1630 <li>
134 senoner 1628 Connect audio ports:
135     In the "Connections Manager" pane of JackPilot: linuxsampler --> Built-in audio: in1 & in2
136     or
137 schoenebeck 1630 In the "Connections" window of qjackctl: linuxsampler --> coreaudio<br>
138     <a href="http://download.linuxsampler.org/pix/screenshots/osx_qjackctl.jpg">
139 senoner 1631 <img src="screenshots/osx_qjackctl_preview.png" border="0">
140 schoenebeck 1630 </a>
141 senoner 1628 </li>
142     <li>
143     Start MIDI Patchbay.app and connect your MIDI Input instance (probably your MIDI interface or USB-enabled keyboard) to the "LinuxSampler_in_0"
144 schoenebeck 1630 MIDI Output<br>
145     <a href="http://download.linuxsampler.org/pix/screenshots/osx_patchbay.jpg">
146 senoner 1631 <img src="screenshots/osx_patchbay_preview.png" border="0">
147 schoenebeck 1630 </a>
148     </li>
149 senoner 1628 </ol>
150 senoner 1614
151     <a name="load_samples"></a>
152     <h3>4.3&nbsp; Loading Samples</h3>
153     Click on Add Channel. A dialog will appear.
154 senoner 1615 Select the GIG file you want to load, the instrument within the GIG file,
155 senoner 1614 Audio device, MIDI device, MIDI port and channel.
156     Click OK.
157     <a name="houston"></a>
158     <h3>5.&nbsp; Installation Troubleshooting</h3>
159 schoenebeck 1618 TODO
160 senoner 1614
161     <a name="docs"></a>
162     <h3>6.&nbsp; Detailed Documentation</h3>
163     You find more detailed documentation about our software on our official <a href="http://linuxsampler.org/documentation.html">
164     LinuxSampler documentation site</a>.
166     <a name="bugs"></a>
167     <h3>7.&nbsp; Bugs, Problems and Feature Requests</h3>
168     There could be several bugs in the Mac OS X version of LinuxSampler which we hope to root out soon.
169     Please report them using our bug tracking system:<br>
170     <br>
171     &nbsp;&nbsp;&nbsp;&nbsp;<a href="http://bugs.linuxsampler.org/">http://bugs.linuxsampler.org/</a><br>
172     <br>
173     Some bugs and problems we discovered so far:
174     <ul>
175     <li>The current LinuxSampler for Mac OS X binary distribution does not ship with gigedit yet
176     <br>
177     Toshi writes: I tried gigedit with X11 and gtk on my Mac. It worked, but the
178     installation process was too much complicated for ordinary users (so
179     complicated that I cannot remember exactly how I did that myself). We
180     still have a long way before gigedit can be part of binary distribution
181     for Mac.
182     </li>
183     <li>if you overload the sampler (CPU overload or disk overload) it
184     produces noises</li>
185     <li>
186     QSampler crashes when one tries to create a second port of jack.
187     An error dialog saying the device was not created, after the dialog is dismissed the QSampler crashes.
188     </li>
189     <li>
190     Another problem in QSampler. It sometimes fails to quit
191     gracefully, and I need to do "Force Quit". After force quitting, the
192     linuxsampler subprocess is still running and I need to stop it by
193     "killall linuxsampler".
194     </li>
195     </ul>
197 schoenebeck 1630 <a name="credits"></a>
198     <h3>8.&nbsp; Credits</h3>
199     Thanks to Stephane Letz (Initial OS X port) and Ebrahim Mayat (OSX Howto fixes, testing, screenshots)
201 senoner 1614 <a name="contact"></a>
202 schoenebeck 1630 <h3>9.&nbsp; Contact</h3>
203 senoner 1614 If you have questions or want to help us to improve the sampler,
204     subscribe to the <a href="http://www.linuxsampler.org/developers.html">
205 schoenebeck 1630 LinuxSampler Developer's mailing list</a>.
206 senoner 1614 <br><br>
207     That's it, enjoy!<br>
208     <br>
209 schoenebeck 1630
210 senoner 1614 </body>
211     </html>

  ViewVC Help
Powered by ViewVC