| 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 <img src="gfx/logos/apple.png"> HOWTO by Toshi Nagata </center></h2> |
| 12 |
senoner |
1614 |
<br> |
| 13 |
senoner |
1628 |
<center>January 6th, 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. 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 |
senoner |
1628 |
<a href="#contact">8. Credits</a><br> |
| 28 |
senoner |
1614 |
</div> |
| 29 |
|
|
|
| 30 |
|
|
<a name="intro"></a> |
| 31 |
|
|
<h3>1. 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 |
|
|
of LinuxSampler will be suboptimal. |
| 67 |
|
|
|
| 68 |
|
|
|
| 69 |
senoner |
1615 |
|
| 70 |
senoner |
1614 |
<a name="requirements"></a> |
| 71 |
|
|
<h3>2. 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> |
| 77 |
|
|
|
| 78 |
|
|
<a name="installation"></a> |
| 79 |
|
|
<h3>3.a Installation</h3> |
| 80 |
schoenebeck |
1618 |
<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> |
| 92 |
|
|
|
| 93 |
|
|
<a name="using"></a> |
| 94 |
|
|
<h3>4. Using the Applications</h3> |
| 95 |
senoner |
1615 |
The folder contains three items, "bin", "linuxsampler" and |
| 96 |
senoner |
1628 |
"qsampler". |
| 97 |
|
|
<ol> |
| 98 |
|
|
<li>Start qsampler.app. The application launches, and you |
| 99 |
senoner |
1615 |
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 |
senoner |
1628 |
</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> |
| 110 |
senoner |
1614 |
|
| 111 |
senoner |
1628 |
|
| 112 |
|
|
|
| 113 |
|
|
|
| 114 |
senoner |
1614 |
<a name="setup_midi"></a> |
| 115 |
|
|
<h3>4.1 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. |
| 118 |
|
|
|
| 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. |
| 124 |
|
|
|
| 125 |
|
|
<a name="setup_audio"></a> |
| 126 |
|
|
<h3>4.2 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 |
senoner |
1628 |
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 |
senoner |
1614 |
<br> |
| 146 |
senoner |
1628 |
<br> |
| 147 |
senoner |
1614 |
|
| 148 |
|
|
|
| 149 |
|
|
<a name="load_samples"></a> |
| 150 |
|
|
<h3>4.3 Loading Samples</h3> |
| 151 |
|
|
Click on Add Channel. A dialog will appear. |
| 152 |
senoner |
1615 |
Select the GIG file you want to load, the instrument within the GIG file, |
| 153 |
senoner |
1614 |
Audio device, MIDI device, MIDI port and channel. |
| 154 |
|
|
Click OK. |
| 155 |
|
|
<a name="houston"></a> |
| 156 |
|
|
<h3>5. Installation Troubleshooting</h3> |
| 157 |
schoenebeck |
1618 |
TODO |
| 158 |
senoner |
1614 |
|
| 159 |
|
|
<a name="docs"></a> |
| 160 |
|
|
<h3>6. 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>. |
| 163 |
|
|
|
| 164 |
|
|
<a name="bugs"></a> |
| 165 |
|
|
<h3>7. 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 |
|
|
<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> |
| 193 |
|
|
|
| 194 |
|
|
</ul> |
| 195 |
|
|
|
| 196 |
|
|
<a name="contact"></a> |
| 197 |
|
|
<h3>8. 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 |
senoner |
1628 |
<a name="credits"></a> |
| 205 |
|
|
<h3>8. Credits</h3> |
| 206 |
|
|
Thanks to Toshi Nagata (OS X patches), Stephane Letz (Initial OS X port), Ebrahim Mayat (OSX Howto fixes, testing, screenshots) |
| 207 |
senoner |
1614 |
</body> |
| 208 |
|
|
</html> |
Parent Directory
| 
Revision Log