tools/osx_packaging/README.rtf

   1 {\rtf1\mac\ansicpg10000\cocoartf824\cocoasubrtf390
   2 {\fonttbl\f0\fswiss\fcharset77 Helvetica;}
   3 {\colortbl;\red255\green255\blue255;}
   4 \margl1440\margr1440\vieww9000\viewh8400\viewkind0
   5 \pard\tx720\tx1440\tx2160\tx2880\tx3600\tx4320\tx5040\tx5760\tx6480\tx7200\tx7920\tx8640\ql\qnatural\pardirnatural
   6
   7 \f0\fs24 \cf0 This is the Mac OS X version of Ardour (http://ardour.org)\
   8 \
   9 You don't need a lot of stuff to get Ardour running on OS X. You will need:\
  10 \
  11     * At least OS X 10.4\
  12 \
  13     * Apple's X11 which is found on your OS X install CD (or a large download)\
  14 \
  15     * JACK (either JackOSX - http://jackosx.com or "regular" JACK.) In\
  16       general, we recommend JackOSX for new users, specifically version\
  17       0.72 or above. It should run on OS X versions 10.3.x and above,\
  18       including Tiger.  Version 0.73 or above must be used for Mac Intel\
  19       universal binary support.\
  20 \
  21 See http://ardour.org/requirements_osx for more information.\
  22 \
  23 The universal binary of Ardour should run on OSX versions >= 10.4. A version\
  24 that also runs on Panther should also be available.\
  25 Please report any problems to osx-support@ardour.org or on the #ardour \
  26 IRC channel at irc.freenode.net.  And include any output from the \
  27 console.log as shown in the Applications->Utilities->Console application \
  28 in the report.\
  29 \
  30 IMPORTANT: before starting Ardour, you should configure and start the\
  31 JACK server. You can either use JackPilot, which comes with the\
  32 JackOSX package, or you can use the more advanced QJackCtl. A disk\
  33 image for QJackCtl is available at http://ardour.org/requirements_osx,\
  34 please read the included README carefully for initial setup\
  35 instructions.\
  36 \
  37 Because ardour does not come with any effect plugins, we are providing\
  38 installable packages for some of the top LADSPA plugins sets.  Please\
  39 download and install them from http://ardour.org/requirements_osx\
  40 page.\
  41 \
  42 Also see the online documentation at http://ardour.org/manual/ for\
  43 basic usage of the software.\
  44 \
  45 \
  46 FAQ\
  47 ------------------------\
  48 \
  49 Q: When I click on the Ardour icon, the program will not start\
  50 \
  51 First, check a few basic issues:\
  52    1. Are you running at least OS X 10.4 ?\
  53    2. Did you install Apple's X11 application?\
  54    3. Did you install a suitable version of JACK ?\
  55    4. Did you start JACK running before trying to run Ardour?\
  56       (Typically this is done using a JACK control app like JackPilot or qjackctl.)\
  57 \
  58 If the answer is yes to all of the above\
  59    1. Launch "Console", which can be found in the "Applications->Utilities" folder\
  60    2. Look at the console.log in the Console app.\
  61       Press the "clear" button to remove any previous messages.\
  62    3. Try to launch Ardour again\
  63    4. Cut and paste the entire contents of the Console window\
  64       (including any data stored in the scrollback) into a new posting\
  65       in the ardour OS X forum at http://ardour.org/forums .\
  66       Include details of your OS version and processor type. \
  67 \
  68 }