8 |
<link rel="stylesheet" type="text/css" href="libgig/css/content.css" title="content" media="all"> |
<link rel="stylesheet" type="text/css" href="libgig/css/content.css" title="content" media="all"> |
9 |
</head> |
</head> |
10 |
<body> |
<body> |
11 |
<h2><center>LinuxSampler for Mac OS X <img src="gfx/logos/windows.png"> HOWTO by Toshi Nagata </center></h2> |
<h2><center>LinuxSampler for Mac OS X <img src="gfx/logos/apple.png"> HOWTO by Toshi Nagata </center></h2> |
12 |
<br> |
<br> |
13 |
<center>December 18th, 2007</center><br> |
<center>January 6th, 2008</center><br> |
14 |
<div style="background-color: #F4F4FF; margin: 1em 3em 1em 3em; padding: 1em 1em 1em 2.2em;"> |
<div style="background-color: #F4F4FF; margin: 1em 3em 1em 3em; padding: 1em 1em 1em 2.2em;"> |
15 |
<a href="#intro">1. Introduction</a><br> |
<a href="#intro">1. Introduction</a><br> |
16 |
<a href="#requirements">2. Requirements</a><br> |
<a href="#requirements">2. Requirements</a><br> |
23 |
<a href="#houston">5. Installation Troubleshooting</a><br> |
<a href="#houston">5. Installation Troubleshooting</a><br> |
24 |
<a href="#docs">6. Detailed Documentation</a><br> |
<a href="#docs">6. Detailed Documentation</a><br> |
25 |
<a href="#bugs">7. Bugs, Problems and Feature Requests</a><br> |
<a href="#bugs">7. Bugs, Problems and Feature Requests</a><br> |
26 |
<a href="#contact">8. Contact</a><br> |
<a href="#credits">8. Credits</a><br> |
27 |
|
<a href="#contact">9. Contact</a><br> |
28 |
</div> |
</div> |
29 |
|
|
30 |
<a name="intro"></a> |
<a name="intro"></a> |
38 |
a network module to run multiple sampler slaves distributed on OS/X, Windows or |
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 |
Linux machines (Linux provides better performance) all controlled from a |
40 |
OS X or Windows box i.e. running the AU / VST sequencer.<br> |
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> |
<br> |
44 |
LinuxSampler is implemented as a client/server application. This means |
LinuxSampler is implemented as a client/server application. This means |
45 |
the sampling engine (the server / backend) runs |
the sampling engine (the server / backend) runs |
57 |
<br> |
<br> |
58 |
The Mac OS X version comes as an easy to install DMG file which will |
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 ) |
install all the necessary modules to run both the server ( linuxsampler.exe ) |
60 |
and the GUI client. For now it installes only the qsampler GUI client |
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 |
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 |
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 |
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 |
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 |
as both applicationes are very CPU and RAM hungry therefore the performance |
66 |
of LinuxSampler will be suboptimal. |
of LinuxSampler will be suboptimal.<br> |
67 |
<br> |
<a href="http://download.linuxsampler.org/pix/screenshots/osx_qsampler_0_2_1.jpg"> |
68 |
Download the DMG and mount it on Finder. You |
<img src="screenshots/osx_qsampler_0_2_1_preview.png" border="0"> |
69 |
will find a single folder "linuxsampler051-mac-20080102". Copy this |
</a> |
|
folder to wherever you like (e.g. under /Applications). |
|
|
<br> |
|
|
The folder contains three items, "bin", "linuxsampler" and |
|
|
"qsampler". Double-click on qsampler. The application launches, and you |
|
|
will see messages saying that linuxsampler is now running. After a |
|
|
while, you will also see that the JackPilot application (installed by |
|
|
the JackOSX installer) automatically launches showing the Jack server |
|
|
already running. |
|
|
|
|
70 |
|
|
71 |
<a name="requirements"></a> |
<a name="requirements"></a> |
72 |
<h3>2. Requirements</h3> |
<h3>2. Requirements</h3> |
75 |
<li>Mac OS Tiger or later (Leopard should work too)</li> |
<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> |
<li><A HREF="http://www.jackosx.com">JackOSX</A>. Install it before LinuxSampler</li> |
77 |
</ul> |
</ul> |
|
<a name="asio_tip"></a> |
|
|
|
|
78 |
|
|
79 |
<a name="installation"></a> |
<a name="installation"></a> |
80 |
<h3>3.a Installation</h3> |
<h3>3.a Installation</h3> |
81 |
Simply download the latest version of the LinuxSampler Mac OS X installer |
<ol> |
82 |
from the <a href="http://www.linuxsampler.org/downloads.html">LinuxSampler |
<li>Install <A HREF="http://www.jackosx.com">JackOSX</A> |
83 |
Download Page</a>, and install it as any OS X application. |
(if you don't have it already). |
84 |
|
</li> |
85 |
|
<li>Download the latest version of the LinuxSampler Mac OS X installer |
86 |
|
from the <a href="http://www.linuxsampler.org/downloads.html">LinuxSampler |
87 |
|
Download Page</a>, and mount it on Finder. |
88 |
|
</li> |
89 |
|
<li>You will find a single folder "linuxsampler051-mac-20080102". Copy this |
90 |
|
folder to wherever you like (e.g. under /Applications). |
91 |
|
</li> |
92 |
|
</ol> |
93 |
|
|
94 |
<a name="using"></a> |
<a name="using"></a> |
95 |
<h3>4. Using the Applications</h3> |
<h3>4. Using the Applications</h3> |
96 |
Now that we installed everything, let's get wet and start the applications: |
The folder contains three items, "bin", "linuxsampler" and |
97 |
|
"qsampler". |
98 |
<ol> |
<ol> |
99 |
<li>Start qsampler, the GUI frontend. It should automatically start linuxsampler the backend application</li> |
<li>Start qsampler.app. The application launches, and you |
100 |
|
will see messages saying that linuxsampler is now running. After a |
101 |
|
while, you will also see that the JackPilot application (installed by |
102 |
|
the JackOSX installer) automatically launches showing the Jack server |
103 |
|
already running. |
104 |
|
</li> |
105 |
|
<li> |
106 |
|
Since CoreMIDI is sometimes too slow to respond when creating a new MIDI device. |
107 |
|
so you need to increase "Timeout" parameter in the |
108 |
|
Options:Server Settings to, 10000 msec. |
109 |
|
</li> |
110 |
</ol> |
</ol> |
|
</div> |
|
111 |
|
|
112 |
<a name="setup_midi"></a> |
<a name="setup_midi"></a> |
113 |
<h3>4.1 Setting up MIDI Input</h3> |
<h3>4.1 Setting up MIDI Input</h3> |
126 |
on Mac OS X. |
on Mac OS X. |
127 |
Click on AUDIO devices icon and then on Create. |
Click on AUDIO devices icon and then on Create. |
128 |
<br> |
<br> |
129 |
<br> |
You can of course save and load sampler session as LSCP files which will |
130 |
|
automaticall set up audio and midi devices and load samples into the channel strips. |
131 |
|
<ol> |
132 |
|
<li> |
133 |
|
Connect audio ports: |
134 |
|
In the "Connections Manager" pane of JackPilot: linuxsampler --> Built-in audio: in1 & in2 |
135 |
|
or |
136 |
|
In the "Connections" window of qjackctl: linuxsampler --> coreaudio<br> |
137 |
|
<a href="http://download.linuxsampler.org/pix/screenshots/osx_qjackctl.jpg"> |
138 |
|
<img src="screenshots/osx_qjackctl_preview.png" border="0"> |
139 |
|
</a> |
140 |
|
</li> |
141 |
|
<li> |
142 |
|
Start MIDI Patchbay.app and connect your MIDI Input instance (probably your MIDI interface or USB-enabled keyboard) to the "LinuxSampler_in_0" |
143 |
|
MIDI Output<br> |
144 |
|
<a href="http://download.linuxsampler.org/pix/screenshots/osx_patchbay.jpg"> |
145 |
|
<img src="screenshots/osx_patchbay_preview.png" border="0"> |
146 |
|
</a> |
147 |
|
</li> |
148 |
|
</ol> |
149 |
|
|
150 |
<a name="load_samples"></a> |
<a name="load_samples"></a> |
151 |
<h3>4.3 Loading Samples</h3> |
<h3>4.3 Loading Samples</h3> |
152 |
Click on Add Channel. A dialog will appear. |
Click on Add Channel. A dialog will appear. |
153 |
Select the GIG file you want to load, the instrument within the GIG file. |
Select the GIG file you want to load, the instrument within the GIG file, |
154 |
Audio device, MIDI device, MIDI port and channel. |
Audio device, MIDI device, MIDI port and channel. |
155 |
Click OK. |
Click OK. |
156 |
<a name="houston"></a> |
<a name="houston"></a> |
157 |
<h3>5. Installation Troubleshooting</h3> |
<h3>5. Installation Troubleshooting</h3> |
158 |
|
TODO |
159 |
|
|
160 |
<a name="docs"></a> |
<a name="docs"></a> |
161 |
<h3>6. Detailed Documentation</h3> |
<h3>6. Detailed Documentation</h3> |
191 |
linuxsampler subprocess is still running and I need to stop it by |
linuxsampler subprocess is still running and I need to stop it by |
192 |
"killall linuxsampler". |
"killall linuxsampler". |
193 |
</li> |
</li> |
|
|
|
194 |
</ul> |
</ul> |
195 |
|
|
196 |
|
<a name="credits"></a> |
197 |
|
<h3>8. Credits</h3> |
198 |
|
Thanks to Stephane Letz (Initial OS X port) and Ebrahim Mayat (OSX Howto fixes, testing, screenshots) |
199 |
|
|
200 |
<a name="contact"></a> |
<a name="contact"></a> |
201 |
<h3>8. Contact</h3> |
<h3>9. Contact</h3> |
202 |
If you have questions or want to help us to improve the sampler, |
If you have questions or want to help us to improve the sampler, |
203 |
subscribe to the <a href="http://www.linuxsampler.org/developers.html"> |
subscribe to the <a href="http://www.linuxsampler.org/developers.html"> |
204 |
LinuxSampler Developer's mailing list</a>. |
LinuxSampler Developer's mailing list</a>. |
205 |
<br><br> |
<br><br> |
206 |
That's it, enjoy!<br> |
That's it, enjoy!<br> |
207 |
<br> |
<br> |