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 <img src="gfx/logos/windows.png"> HOWTO by Toshi Nagata </center></h2> |
12 |
<br> |
13 |
<center>December 18th, 2007</center><br> |
14 |
<div style="background-color: #F4F4FF; margin: 1em 3em 1em 3em; padding: 1em 1em 1em 2.2em;"> |
15 |
<a href="#intro">1. Introduction</a><br> |
16 |
<a href="#requirements">2. Requirements</a><br> |
17 |
<a href="#installation">3. Installation</a><br> |
18 |
<a href="#using">4. Using the Applications</a><br> |
19 |
<a href="#setup_midi"> 4.1 Setting up MIDI Input</a><br> |
20 |
<a href="#setup_audio"> 4.2 Setting up Audio Output</a><br> |
21 |
<a href="#load_samples"> 4.3 Loading Samples</a><br> |
22 |
<a href="#save_session"> 4.4 Saving a Sampler Session</a><br> |
23 |
<a href="#houston">5. Installation Troubleshooting</a><br> |
24 |
<a href="#docs">6. Detailed Documentation</a><br> |
25 |
<a href="#bugs">7. Bugs, Problems and Feature Requests</a><br> |
26 |
<a href="#contact">8. Contact</a><br> |
27 |
</div> |
28 |
|
29 |
<a name="intro"></a> |
30 |
<h3>1. Introduction</h3> |
31 |
The LinuxSampler development team is happy to announce the release of |
32 |
a new version of LinuxSampler of Mac OS X. More information will be added here soon, so check back frequently.<br> |
33 |
<br> |
34 |
For now the sampler supports the CoreMIDI interface |
35 |
for MIDI input and <A HREF="http://www.jackosx.com">jack</A> for audio out. This means it currently runs only |
36 |
as a standalone application. An AU/VST interface will follow at a later stage, along with |
37 |
a network module to run multiple sampler slaves distributed on OS/X, Windows or |
38 |
Linux machines (Linux provides better performance) all controlled from a |
39 |
OS X or Windows box i.e. running the AU / VST sequencer.<br> |
40 |
<br> |
41 |
LinuxSampler is implemented as a client/server application. This means |
42 |
the sampling engine (the server / backend) runs |
43 |
independently from the GUI (the client / frontend). Sampling engine and |
44 |
client can be run on the same box or on different machines too, connected |
45 |
over the network.<br> |
46 |
<br> |
47 |
The Mac OS X version provides all the features of the Linux version |
48 |
since it is built from the same source code base. |
49 |
This means when new features will come out the |
50 |
Mac OS X version will usually provide the same feature set as the Linux |
51 |
version. This was made possible by the very modular design of both |
52 |
low level, operating system functions and flexible audio / MIDI driver |
53 |
system.<br> |
54 |
<br> |
55 |
The Mac OS X version comes as an easy to install DMG file which will |
56 |
install all the necessary modules to run both the server ( linuxsampler.exe ) |
57 |
and the GUI client. For now it installes only the qsampler GUI client |
58 |
as Jsampler, the sampler frontend written in JAVA requires Java 1.6 which is not |
59 |
available on OS/X yet. Of course you can run JSampler on a Windows or Linux box |
60 |
connected over the network to your OS X box or you could try to run it in a windows |
61 |
virtual machine. We discourage running a virtual machine along with the sampler |
62 |
as both applicationes are very CPU and RAM hungry therefore the performance |
63 |
of LinuxSampler will be suboptimal. |
64 |
<br> |
65 |
Download the DMG and mount it on Finder. You |
66 |
will find a single folder "linuxsampler051-mac-20080102". Copy this |
67 |
folder to wherever you like (e.g. under /Applications). |
68 |
<br> |
69 |
The folder contains three items, "bin", "linuxsampler" and |
70 |
"qsampler". Double-click on qsampler. The application launches, and you |
71 |
will see messages saying that linuxsampler is now running. After a |
72 |
while, you will also see that the JackPilot application (installed by |
73 |
the JackOSX installer) automatically launches showing the Jack server |
74 |
already running. |
75 |
|
76 |
|
77 |
<a name="requirements"></a> |
78 |
<h3>2. Requirements</h3> |
79 |
<ul> |
80 |
<li>PPC or Intel Mac (an Intel Mac should provide much better performance) |
81 |
<li>Mac OS Tiger or later (Leopard should work too)</li> |
82 |
<li><A HREF="http://www.jackosx.com">JackOSX</A>. Install it before LinuxSampler</li> |
83 |
</ul> |
84 |
<a name="asio_tip"></a> |
85 |
|
86 |
|
87 |
<a name="installation"></a> |
88 |
<h3>3.a Installation</h3> |
89 |
Simply download the latest version of the LinuxSampler Mac OS X installer |
90 |
from the <a href="http://www.linuxsampler.org/downloads.html">LinuxSampler |
91 |
Download Page</a>, and install it as any OS X application. |
92 |
|
93 |
|
94 |
<a name="using"></a> |
95 |
<h3>4. Using the Applications</h3> |
96 |
Now that we installed everything, let's get wet and start the applications: |
97 |
<ol> |
98 |
<li>Start qsampler, the GUI frontend. It should automatically start linuxsampler the backend application</li> |
99 |
</ol> |
100 |
</div> |
101 |
|
102 |
<a name="setup_midi"></a> |
103 |
<h3>4.1 Setting up MIDI Input</h3> |
104 |
In qsampler click on the device configuration tab. |
105 |
Click on the MIDI devices icon and then on Create. |
106 |
|
107 |
<br> |
108 |
<br> |
109 |
You can create an arbitrary number of MIDI input devices by repeating |
110 |
the procedure above. |
111 |
Each MIDI device can be routed to arbitrary sampler channels. |
112 |
|
113 |
<a name="setup_audio"></a> |
114 |
<h3>4.2 Setting up Audio Output</h3> |
115 |
LinuxSampler currently only supports the jack driver model for audio output |
116 |
on Mac OS X. |
117 |
Click on AUDIO devices icon and then on Create. |
118 |
<br> |
119 |
<br> |
120 |
|
121 |
|
122 |
<a name="load_samples"></a> |
123 |
<h3>4.3 Loading Samples</h3> |
124 |
Click on Add Channel. A dialog will appear. |
125 |
Select the GIG file you want to load, the instrument within the GIG file. |
126 |
Audio device, MIDI device, MIDI port and channel. |
127 |
Click OK. |
128 |
<a name="houston"></a> |
129 |
<h3>5. Installation Troubleshooting</h3> |
130 |
|
131 |
|
132 |
<a name="docs"></a> |
133 |
<h3>6. Detailed Documentation</h3> |
134 |
You find more detailed documentation about our software on our official <a href="http://linuxsampler.org/documentation.html"> |
135 |
LinuxSampler documentation site</a>. |
136 |
|
137 |
<a name="bugs"></a> |
138 |
<h3>7. Bugs, Problems and Feature Requests</h3> |
139 |
There could be several bugs in the Mac OS X version of LinuxSampler which we hope to root out soon. |
140 |
Please report them using our bug tracking system:<br> |
141 |
<br> |
142 |
<a href="http://bugs.linuxsampler.org/">http://bugs.linuxsampler.org/</a><br> |
143 |
<br> |
144 |
Some bugs and problems we discovered so far: |
145 |
<ul> |
146 |
<li>The current LinuxSampler for Mac OS X binary distribution does not ship with gigedit yet |
147 |
<br> |
148 |
Toshi writes: I tried gigedit with X11 and gtk on my Mac. It worked, but the |
149 |
installation process was too much complicated for ordinary users (so |
150 |
complicated that I cannot remember exactly how I did that myself). We |
151 |
still have a long way before gigedit can be part of binary distribution |
152 |
for Mac. |
153 |
</li> |
154 |
<li>if you overload the sampler (CPU overload or disk overload) it |
155 |
produces noises</li> |
156 |
<li> |
157 |
QSampler crashes when one tries to create a second port of jack. |
158 |
An error dialog saying the device was not created, after the dialog is dismissed the QSampler crashes. |
159 |
</li> |
160 |
<li> |
161 |
Another problem in QSampler. It sometimes fails to quit |
162 |
gracefully, and I need to do "Force Quit". After force quitting, the |
163 |
linuxsampler subprocess is still running and I need to stop it by |
164 |
"killall linuxsampler". |
165 |
</li> |
166 |
|
167 |
</ul> |
168 |
|
169 |
<a name="contact"></a> |
170 |
<h3>8. Contact</h3> |
171 |
If you have questions or want to help us to improve the sampler, |
172 |
subscribe to the <a href="http://www.linuxsampler.org/developers.html"> |
173 |
LinuxSampler Developer's mailing list</a>. |
174 |
<br><br> |
175 |
That's it, enjoy!<br> |
176 |
<br> |
177 |
|
178 |
</body> |
179 |
</html> |