/[svn]/web/trunk/www.linuxsampler.org/osx.html
ViewVC logotype

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

Parent Directory Parent Directory | Revision Log Revision Log | View Patch Patch

revision 1614 by senoner, Thu Jan 3 19:05:04 2008 UTC revision 1983 by senoner, Tue Aug 4 08:59:23 2009 UTC
# Line 8  Line 8 
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 &nbsp; <img src="gfx/logos/windows.png"> &nbsp; HOWTO by Toshi Nagata&nbsp;</center></h2>  <h2><center>LinuxSampler for Mac OS X &nbsp; <img src="gfx/logos/apple.png"> &nbsp; HOWTO by Toshi Nagata&nbsp;</center></h2>
12  <br>  <br>
13  <center>December&nbsp;18th,&nbsp;2007</center><br>  <center>January&nbsp;6th,&nbsp;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.&nbsp; Introduction</a><br>  <a href="#intro">1.&nbsp; Introduction</a><br>
16  <a href="#requirements">2.&nbsp; Requirements</a><br>  <a href="#requirements">2.&nbsp; Requirements</a><br>
# Line 23  Line 23 
23  <a href="#houston">5.&nbsp; Installation Troubleshooting</a><br>  <a href="#houston">5.&nbsp; Installation Troubleshooting</a><br>
24  <a href="#docs">6.&nbsp; Detailed Documentation</a><br>  <a href="#docs">6.&nbsp; Detailed Documentation</a><br>
25  <a href="#bugs">7.&nbsp; Bugs, Problems and Feature Requests</a><br>  <a href="#bugs">7.&nbsp; Bugs, Problems and Feature Requests</a><br>
26  <a href="#contact">8.&nbsp; Contact</a><br>  <a href="#credits">8.&nbsp; Credits</a><br>
27    <a href="#contact">9.&nbsp; Contact</a><br>
28  </div>  </div>
29    <p>
30    <center>
31    <script type="text/javascript"><!--
32    google_ad_client = "pub-3408196773880325";
33    /* 728x90, created 8/3/09 */
34    google_ad_slot = "7744776541";
35    google_ad_width = 728;
36    google_ad_height = 90;
37    //-->
38    </script>
39    <script type="text/javascript"
40    src="http://pagead2.googlesyndication.com/pagead/show_ads.js">
41    </script>
42    </center>
43    </p>
44  <a name="intro"></a>  <a name="intro"></a>
45  <h3>1.&nbsp; Introduction</h3>  <h3>1.&nbsp; Introduction</h3>
46  The LinuxSampler development team is happy to announce the release of  The LinuxSampler development team is happy to announce the release of
# Line 37  as a standalone application. An AU/VST i Line 52  as a standalone application. An AU/VST i
52  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
53  Linux machines (Linux provides better performance) all controlled from a  Linux machines (Linux provides better performance) all controlled from a
54  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>
55    Even though LinuxSampler presently runs only as standalone app,
56    thanks to jack you can comfortably route the sampler's audio outs back into your sequencer.
57  <br>  <br>
58  LinuxSampler is implemented as a client/server application. This means  LinuxSampler is implemented as a client/server application. This means
59  the sampling engine (the server / backend) runs  the sampling engine (the server / backend) runs
# Line 53  low level, operating system functions an Line 70  low level, operating system functions an
70  system.<br>  system.<br>
71  <br>  <br>
72  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
73  install all the necessary modules to run both the server ( linuxsampler.exe )  install all the necessary modules to run both the server ( bin/linuxsampler )
74  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
75  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
76  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
77  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
78  virtual machine. We discourage running a virtual machine along with the sampler  virtual machine. We discourage running a virtual machine along with the sampler
79  as both applicationes are very CPU and RAM hungry therefore the performance  as both applicationes are very CPU and RAM hungry therefore the performance
80  of LinuxSampler will be suboptimal.  of LinuxSampler will be suboptimal.<br>
81  <br>  <a href="http://download.linuxsampler.org/pix/screenshots/osx_qsampler_0_2_1_color.jpg">
82  Download the DMG and mount it on Finder. You   <img src="screenshots/osx_qsampler_0_2_1_preview.png" border="0">
83  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.  
   
84    
85  <a name="requirements"></a>  <a name="requirements"></a>
86  <h3>2.&nbsp; Requirements</h3>  <h3>2.&nbsp; Requirements</h3>
# Line 80  already running. Line 88  already running.
88    <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)
89    <li>Mac OS Tiger or later (Leopard should work too)</li>    <li>Mac OS Tiger or later (Leopard should work too)</li>
90    <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>
91      <li><A HREF="http://pete.yandell.com/software/">Pete Yandell's MIDI Patchbay</A> or a similar tool</li>
92  </ul>  </ul>
 <a name="asio_tip"></a>  
   
93    
94  <a name="installation"></a>  <a name="installation"></a>
95  <h3>3.a&nbsp; Installation</h3>  <h3>3.a&nbsp; Installation</h3>
96  Simply download the latest version of the LinuxSampler Mac OS X installer  <ol>
97  from the <a href="http://www.linuxsampler.org/downloads.html">LinuxSampler    <li>Install <A HREF="http://www.jackosx.com">JackOSX</A>
98  Download Page</a>, and install it as any OS X application.    (if you don't have it already).
99      </li>
100      <li>Download the latest version of the LinuxSampler Mac OS X installer
101      from the <a href="http://www.linuxsampler.org/downloads.html">LinuxSampler
102      Download Page</a>, and mount it on Finder.
103      </li>
104      <li>You will find a single folder "linuxsampler051-mac". Copy this
105      folder to wherever you like (e.g. under /Applications).
106      </li>
107    </ol>
108    
109  <a name="using"></a>  <a name="using"></a>
110  <h3>4.&nbsp; Using the Applications</h3>  <h3>4.&nbsp; Using the Applications</h3>
111  Now that we installed everything, let's get wet and start the applications:  The folder contains three items, "bin", "linuxsampler" and
112    "qsampler".
113  <ol>  <ol>
114    <li>Start qsampler, the GUI frontend. It should automatically start linuxsampler the backend application</li>  <li>Start qsampler.app. The application launches, and you
115    will see messages saying that linuxsampler is now running. After a
116    while, you will also see that the JackPilot application (installed by
117    the JackOSX installer) automatically launches showing the Jack server
118    already running.
119    </li>
120    <li>
121    Since CoreMIDI is sometimes too slow to respond when creating a new MIDI device.
122    so you need to increase "Timeout" parameter in the
123    Options:Server Settings to 10000 msec. (Added note on Jan 7, 2008: this value is now set by default)
124    </li>
125  </ol>  </ol>
 </div>  
126    
127  <a name="setup_midi"></a>  <a name="setup_midi"></a>
128  <h3>4.1&nbsp; Setting up MIDI Input</h3>  <h3>4.1&nbsp; Setting up MIDI Input</h3>
129  In qsampler click on the device configuration tab.  In qsampler click on the device configuration tab.
130  Click on the MIDI devices icon and then on Create.  Click on the MIDI devices icon and then on Create.
   
131  <br>  <br>
132  <br>  <br>
133  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.
134  the procedure above.  <br>
135  Each MIDI device can be routed to arbitrary sampler channels.  <br>
136    (You should be able to create an arbitrary number of MIDI input devices by repeating "Create", but this feature does not work well yet.)
137    
138  <a name="setup_audio"></a>  <a name="setup_audio"></a>
139  <h3>4.2&nbsp; Setting up Audio Output</h3>  <h3>4.2&nbsp; Setting up Audio Output</h3>
# Line 116  LinuxSampler currently only supports the Line 141  LinuxSampler currently only supports the
141  on Mac OS X.  on Mac OS X.
142  Click on AUDIO devices icon and then on Create.  Click on AUDIO devices icon and then on Create.
143  <br>  <br>
144  <br>  You can of course save and load sampler session as LSCP files which will
145    automaticall set up audio and midi devices and load samples into the channel strips.
146    <ol>
147     <li>
148     Connect audio ports:
149     In the "Connections Manager" pane of JackPilot: linuxsampler --> Built-in audio: in1 & in2
150     or
151     In the "Connections" window of qjackctl: linuxsampler --> coreaudio<br>
152       <a href="http://download.linuxsampler.org/pix/screenshots/osx_qjackctl.jpg">
153        <img src="screenshots/osx_qjackctl_preview.png" border="0">
154       </a>
155       <br>Intel Mac Note: to use built-in audio in Jack, you need to create an "aggregated device" by using "Audio MIDI Setup". Please look up Jack manual for details.
156     </li>
157     <li>
158     Start MIDI Patchbay.app and connect your MIDI Input instance (probably your MIDI interface or USB-enabled keyboard) to  the "LinuxSampler_in_0"
159     MIDI Output<br>
160       <a href="http://download.linuxsampler.org/pix/screenshots/osx_patchbay.jpg">
161        <img src="screenshots/osx_patchbay_preview.png" border="0">
162       </a>
163     </li>
164    </ol>
165    
166  <a name="load_samples"></a>  <a name="load_samples"></a>
167  <h3>4.3&nbsp; Loading Samples</h3>  <h3>4.3&nbsp; Loading Samples</h3>
168  Click on Add Channel. A dialog will appear.  Click on Add Channel. A dialog will appear.
169  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,
170  Audio device, MIDI device, MIDI port and channel.  Audio device, MIDI device, MIDI port and channel.
171  Click OK.  Click OK.
172  <a name="houston"></a>  <a name="houston"></a>
173  <h3>5.&nbsp; Installation Troubleshooting</h3>  <h3>5.&nbsp; Installation Troubleshooting</h3>
174    TODO
175    
176  <a name="docs"></a>  <a name="docs"></a>
177  <h3>6.&nbsp; Detailed Documentation</h3>  <h3>6.&nbsp; Detailed Documentation</h3>
# Line 136  LinuxSampler documentation site</a>. Line 180  LinuxSampler documentation site</a>.
180    
181  <a name="bugs"></a>  <a name="bugs"></a>
182  <h3>7.&nbsp; Bugs, Problems and Feature Requests</h3>  <h3>7.&nbsp; Bugs, Problems and Feature Requests</h3>
183    Our Forum is a good place to ask for help:<br>
184    <br>
185    &nbsp;&nbsp;&nbsp;&nbsp;<a href="https://bb.linuxsampler.org">https://bb.linuxsampler.org</a><br>
186    <br>
187    We have a dedicated forum section for
188    newbies and support.<br>
189    <br>
190  There could be several bugs in the Mac OS X version of LinuxSampler which we hope to root out soon.  There could be several bugs in the Mac OS X version of LinuxSampler which we hope to root out soon.
191  Please report them using our bug tracking system:<br>  Please report them using our bug tracking system:<br>
192  <br>  <br>
# Line 163  gracefully, and I need to do "Force Quit Line 214  gracefully, and I need to do "Force Quit
214  linuxsampler subprocess is still running and I need to stop it by  linuxsampler subprocess is still running and I need to stop it by
215  "killall linuxsampler".  "killall linuxsampler".
216  </li>  </li>
217    <li>
218       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.
219    </li>
220  </ul>  </ul>
221    
222    <a name="credits"></a>
223    <h3>8.&nbsp; Credits</h3>
224    Thanks to Stephane Letz (Initial OS X port) and  Ebrahim Mayat (OSX Howto fixes, testing, screenshots)
225    
226  <a name="contact"></a>  <a name="contact"></a>
227  <h3>8.&nbsp; Contact</h3>  <h3>9.&nbsp; Contact</h3>
228  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,
229  subscribe to the <a href="http://www.linuxsampler.org/developers.html">  subscribe to the <a href="http://www.linuxsampler.org/developers.html">
230  LinuxSampler Developer's mailing list</a>.  LinuxSampler Developer's mailing list</a>.
231  <br><br>  <br><br>
232  That's it, enjoy!<br>  That's it, enjoy!<br>
233  <br>  <br>
Legend:
Removed from v.1614  
changed lines
  Added in v.1983
  ViewVC Help
Powered by ViewVC