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

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

Parent Directory | Revision Log | View Patch Patch

-revision 1618 by schoenebeck,
Thu Jan  3 21:15:16 2008 UTC
+revision 1983 by senoner,
Tue Aug  4 08:59:23 2009 UTC
 Line 10
  <body>
  <h2><center>LinuxSampler for Mac OS X &nbsp; <img src="gfx/logos/apple.png"> &nbsp; HOWTO by Toshi Nagata&nbsp;</center></h2>
  <br>
- <center>December&nbsp;18th,&nbsp;2007</center><br>
+ <center>January&nbsp;6th,&nbsp;2008</center><br>
  <div style="background-color: #F4F4FF; margin: 1em 3em 1em 3em; padding: 1em 1em 1em 2.2em;">
  <a href="#intro">1.&nbsp; Introduction</a><br>
  <a href="#requirements">2.&nbsp; Requirements</a><br>
 Line 23
  <a href="#houston">5.&nbsp; Installation Troubleshooting</a><br>
  <a href="#docs">6.&nbsp; Detailed Documentation</a><br>
  <a href="#bugs">7.&nbsp; Bugs, Problems and Feature Requests</a><br>
- <a href="#contact">8.&nbsp; Contact</a><br>
+ <a href="#credits">8.&nbsp; Credits</a><br>
+ <a href="#contact">9.&nbsp; Contact</a><br>
  </div>
+ <p>
+ <center>
+ <script type="text/javascript"><!--
+ google_ad_client = "pub-3408196773880325";
+ /* 728x90, created 8/3/09 */
+ google_ad_slot = "7744776541";
+ google_ad_width = 728;
+ google_ad_height = 90;
+ //-->
+ </script>
+ <script type="text/javascript"
+ src="http://pagead2.googlesyndication.com/pagead/show_ads.js">
+ </script>
+ </center>
+ </p>
  <a name="intro"></a>
  <h3>1.&nbsp; Introduction</h3>
  The LinuxSampler development team is happy to announce the release of
-Line 55 
 low level, operating system functions an
+Line 70 
 low level, operating system functions an
  system.<br>
  <br>
  The Mac OS X version comes as an easy to install DMG file which will
- install all the necessary modules to run both the server ( linuxsampler.exe )
+ install all the necessary modules to run both the server ( bin/linuxsampler )
  and the GUI client. For now it installs only the qsampler GUI client
  as JSampler, the sampler frontend written in Java requires Java 1.6 which is not
  available on OS X yet. Of course you can run JSampler on a Windows or Linux box
  connected over the network to your OS X box or you could try to run it in a windows
  virtual machine. We discourage running a virtual machine along with the sampler
  as both applicationes are very CPU and RAM hungry therefore the performance
- of LinuxSampler will be suboptimal.
+ of LinuxSampler will be suboptimal.<br>
+ <a href="http://download.linuxsampler.org/pix/screenshots/osx_qsampler_0_2_1_color.jpg">
+  <img src="screenshots/osx_qsampler_0_2_1_preview.png" border="0">
+ </a>
  <a name="requirements"></a>
  <h3>2.&nbsp; Requirements</h3>
-Line 72 
 of LinuxSampler will be suboptimal.
+Line 88 
 of LinuxSampler will be suboptimal.
    <li>PPC or Intel Mac (an Intel Mac should provide much better performance)
    <li>Mac OS Tiger or later (Leopard should work too)</li>
    <li><A HREF="http://www.jackosx.com">JackOSX</A>. Install it before LinuxSampler</li>
+   <li><A HREF="http://pete.yandell.com/software/">Pete Yandell's MIDI Patchbay</A> or a similar tool</li>
  </ul>
  <a name="installation"></a>
-Line 84 
 of LinuxSampler will be suboptimal.
+Line 101 
 of LinuxSampler will be suboptimal.
    from the <a href="http://www.linuxsampler.org/downloads.html">LinuxSampler
    Download Page</a>, and mount it on Finder.
    </li>
-   <li>You will find a single folder "linuxsampler051-mac-20080102". Copy this
+   <li>You will find a single folder "linuxsampler051-mac". Copy this
    folder to wherever you like (e.g. under /Applications).
    </li>
  </ol>
-Line 92 
 of LinuxSampler will be suboptimal.
+Line 109 
 of LinuxSampler will be suboptimal.
  <a name="using"></a>
  <h3>4.&nbsp; Using the Applications</h3>
  The folder contains three items, "bin", "linuxsampler" and
- "qsampler". Double-click on qsampler. The application launches, and you
+ "qsampler".
+ <ol>
+ <li>Start qsampler.app. 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.
+ </li>
+ <li>
+ Since CoreMIDI is sometimes too slow to respond when creating a new MIDI device.
+ so you need to increase "Timeout" parameter in the
+ Options:Server Settings to 10000 msec. (Added note on Jan 7, 2008: this value is now set by default)
+ </li>
+ </ol>
  <a name="setup_midi"></a>
  <h3>4.1&nbsp; Setting up MIDI Input</h3>
  In qsampler click on the device configuration tab.
  Click on the MIDI devices icon and then on Create.
  <br>
  <br>
- 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.
- the procedure above.
+ <br>
- Each MIDI device can be routed to arbitrary sampler channels.
+ <br>
+ (You should be able to create an arbitrary number of MIDI input devices by repeating "Create", but this feature does not work well yet.)
  <a name="setup_audio"></a>
  <h3>4.2&nbsp; Setting up Audio Output</h3>
-Line 115 
 LinuxSampler currently only supports the
+Line 141 
 LinuxSampler currently only supports the
  on Mac OS X.
  Click on AUDIO devices icon and then on Create.
  <br>
- <br>
+ You can of course save and load sampler session as LSCP files which will
+ automaticall set up audio and midi devices and load samples into the channel strips.
+ <ol>
+  <li>
+  Connect audio ports:
+  In the "Connections Manager" pane of JackPilot: linuxsampler --> Built-in audio: in1 & in2
+  or
+  In the "Connections" window of qjackctl: linuxsampler --> coreaudio<br>
+    <a href="http://download.linuxsampler.org/pix/screenshots/osx_qjackctl.jpg">
+     <img src="screenshots/osx_qjackctl_preview.png" border="0">
+    </a>
+    <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.
+  </li>
+  <li>
+  Start MIDI Patchbay.app and connect your MIDI Input instance (probably your MIDI interface or USB-enabled keyboard) to  the "LinuxSampler_in_0"
+  MIDI Output<br>
+    <a href="http://download.linuxsampler.org/pix/screenshots/osx_patchbay.jpg">
+     <img src="screenshots/osx_patchbay_preview.png" border="0">
+    </a>
+  </li>
+ </ol>
  <a name="load_samples"></a>
  <h3>4.3&nbsp; Loading Samples</h3>
-Line 135 
 LinuxSampler documentation site</a>.
+Line 180 
 LinuxSampler documentation site</a>.
  <a name="bugs"></a>
  <h3>7.&nbsp; Bugs, Problems and Feature Requests</h3>
+ Our Forum is a good place to ask for help:<br>
+ <br>
+ &nbsp;&nbsp;&nbsp;&nbsp;<a href="https://bb.linuxsampler.org">https://bb.linuxsampler.org</a><br>
+ <br>
+ We have a dedicated forum section for
+ newbies and support.<br>
+ <br>
  There could be several bugs in the Mac OS X version of LinuxSampler which we hope to root out soon.
  Please report them using our bug tracking system:<br>
  <br>
-Line 162 
 gracefully, and I need to do "Force Quit
+Line 214 
 gracefully, and I need to do "Force Quit
  linuxsampler subprocess is still running and I need to stop it by
  "killall linuxsampler".
  </li>
+ <li>
+    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.
+ </li>
  </ul>
+ <a name="credits"></a>
+ <h3>8.&nbsp; Credits</h3>
+ Thanks to Stephane Letz (Initial OS X port) and  Ebrahim Mayat (OSX Howto fixes, testing, screenshots)
  <a name="contact"></a>
- <h3>8.&nbsp; Contact</h3>
+ <h3>9.&nbsp; Contact</h3>
  If you have questions or want to help us to improve the sampler,
  subscribe to the <a href="http://www.linuxsampler.org/developers.html">
  LinuxSampler Developer's mailing list</a>.
  <br><br>
  That's it, enjoy!<br>
  <br>

 Legend:



Removed from v.1618
 


changed lines


 
Added in v.1983
 Legend:



Removed from v.1618
 


changed lines


 
Added in v.1983
-Removed from v.1618
+Added in v.1983

	ViewVC Help
Powered by ViewVC