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 |
56 |
system.<br> |
system.<br> |
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 ( bin/linuxsampler ) |
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> |
74 |
<li>PPC or Intel Mac (an Intel Mac should provide much better performance) |
<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> |
<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 |
|
<li><A HREF="http://pete.yandell.com/software/">Pete Yandell's MIDI Patchbay</A> or a similar tool</li> |
78 |
</ul> |
</ul> |
|
<a name="asio_tip"></a> |
|
|
|
|
79 |
|
|
80 |
<a name="installation"></a> |
<a name="installation"></a> |
81 |
<h3>3.a Installation</h3> |
<h3>3.a Installation</h3> |
82 |
Simply download the latest version of the LinuxSampler Mac OS X installer |
<ol> |
83 |
from the <a href="http://www.linuxsampler.org/downloads.html">LinuxSampler |
<li>Install <A HREF="http://www.jackosx.com">JackOSX</A> |
84 |
Download Page</a>, and install it as any OS X application. |
(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". Copy this |
91 |
|
folder to wherever you like (e.g. under /Applications). |
92 |
|
</li> |
93 |
|
</ol> |
94 |
|
|
95 |
<a name="using"></a> |
<a name="using"></a> |
96 |
<h3>4. Using the Applications</h3> |
<h3>4. Using the Applications</h3> |
97 |
Now that we installed everything, let's get wet and start the applications: |
The folder contains three items, "bin", "linuxsampler" and |
98 |
|
"qsampler". |
99 |
<ol> |
<ol> |
100 |
<li>Start qsampler, the GUI frontend. It should automatically start linuxsampler the backend application</li> |
<li>Start qsampler.app. The application launches, and you |
101 |
|
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 |
|
</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> |
</ol> |
|
</div> |
|
112 |
|
|
113 |
<a name="setup_midi"></a> |
<a name="setup_midi"></a> |
114 |
<h3>4.1 Setting up MIDI Input</h3> |
<h3>4.1 Setting up MIDI Input</h3> |
115 |
In qsampler click on the device configuration tab. |
In qsampler click on the device configuration tab. |
116 |
Click on the MIDI devices icon and then on Create. |
Click on the MIDI devices icon and then on Create. |
|
|
|
117 |
<br> |
<br> |
118 |
<br> |
<br> |
119 |
You can create an arbitrary number of MIDI input devices by repeating |
If you need multiple MIDI input device, set the "Number of ports" to 2, 3, ... before creating the MIDI device. The multiple ports will be accessible from other MIDI applications as "Linuxsampler_in_0", "Linuxsampler_in_1", etc. |
120 |
the procedure above. |
<br> |
121 |
Each MIDI device can be routed to arbitrary sampler channels. |
<br> |
122 |
|
(You should be able to create an arbitrary number of MIDI input devices by repeating "Create", but this feature does not work well yet.) |
123 |
|
|
124 |
<a name="setup_audio"></a> |
<a name="setup_audio"></a> |
125 |
<h3>4.2 Setting up Audio Output</h3> |
<h3>4.2 Setting up Audio Output</h3> |
127 |
on Mac OS X. |
on Mac OS X. |
128 |
Click on AUDIO devices icon and then on Create. |
Click on AUDIO devices icon and then on Create. |
129 |
<br> |
<br> |
130 |
<br> |
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 |
|
<li> |
134 |
|
Connect audio ports: |
135 |
|
In the "Connections Manager" pane of JackPilot: linuxsampler --> Built-in audio: in1 & in2 |
136 |
|
or |
137 |
|
In the "Connections" window of qjackctl: linuxsampler --> coreaudio<br> |
138 |
|
<a href="http://download.linuxsampler.org/pix/screenshots/osx_qjackctl.jpg"> |
139 |
|
<img src="screenshots/osx_qjackctl_preview.png" border="0"> |
140 |
|
</a> |
141 |
|
</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 |
|
MIDI Output<br> |
145 |
|
<a href="http://download.linuxsampler.org/pix/screenshots/osx_patchbay.jpg"> |
146 |
|
<img src="screenshots/osx_patchbay_preview.png" border="0"> |
147 |
|
</a> |
148 |
|
</li> |
149 |
|
</ol> |
150 |
|
|
151 |
<a name="load_samples"></a> |
<a name="load_samples"></a> |
152 |
<h3>4.3 Loading Samples</h3> |
<h3>4.3 Loading Samples</h3> |
153 |
Click on Add Channel. A dialog will appear. |
Click on Add Channel. A dialog will appear. |
154 |
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, |
155 |
Audio device, MIDI device, MIDI port and channel. |
Audio device, MIDI device, MIDI port and channel. |
156 |
Click OK. |
Click OK. |
157 |
<a name="houston"></a> |
<a name="houston"></a> |
158 |
<h3>5. Installation Troubleshooting</h3> |
<h3>5. Installation Troubleshooting</h3> |
159 |
|
TODO |
160 |
|
|
161 |
<a name="docs"></a> |
<a name="docs"></a> |
162 |
<h3>6. Detailed Documentation</h3> |
<h3>6. Detailed Documentation</h3> |
192 |
linuxsampler subprocess is still running and I need to stop it by |
linuxsampler subprocess is still running and I need to stop it by |
193 |
"killall linuxsampler". |
"killall linuxsampler". |
194 |
</li> |
</li> |
195 |
|
<li> |
196 |
|
JackPilot may not launch automatically after QSampler launches. On the other hand, if it is already running, the screen of JackPilot may not display correctly the current status of the jack daemon. In such cases please quit and restart JackPilot manually. |
197 |
|
</li> |
198 |
</ul> |
</ul> |
199 |
|
|
200 |
|
<a name="credits"></a> |
201 |
|
<h3>8. Credits</h3> |
202 |
|
Thanks to Stephane Letz (Initial OS X port) and Ebrahim Mayat (OSX Howto fixes, testing, screenshots) |
203 |
|
|
204 |
<a name="contact"></a> |
<a name="contact"></a> |
205 |
<h3>8. Contact</h3> |
<h3>9. Contact</h3> |
206 |
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, |
207 |
subscribe to the <a href="http://www.linuxsampler.org/developers.html"> |
subscribe to the <a href="http://www.linuxsampler.org/developers.html"> |
208 |
LinuxSampler Developer's mailing list</a>. |
LinuxSampler Developer's mailing list</a>. |
209 |
<br><br> |
<br><br> |
210 |
That's it, enjoy!<br> |
That's it, enjoy!<br> |
211 |
<br> |
<br> |