Installing the software on Apple OS X


You will need to unpack the downloaded file in the location you have chosen to hold the executable files. Typically this might be in /usr/bin, or perhaps $HOME/bin/. You would then unpack the files using tar -zxf archivename.tgz, which will create a directory Argyll_VX.X.X, where X.X.X is the version number, and the executables will be in Argyll_VX.X.X/bin You will also have to configure your $PATH environment variable to give access to the executables from your command line environment. If you are unfamiliar with how to do this, consult an appropriate tutorial, e.g. <ShellIntro>. The .tgz file also contains several useful reference files (such as acquisition device chart recognition templates, sample illumination spectrum etc.) in the ref sub-directory, as well as all the current documentation in a doc sub-directory.

For most devices there is nothing special to do. Plug in and go. For some devices though (specifically, if you want to use the HCFR colorimeter), the default OS X class drivers will grab the device, preventing Argyll from accessing it. To overcome this, you need to install a codeless kernel extension if you wish to use the HCFR colorimeter, that prevents this from happening. From the command line you need to create a directory called Argyll.kext somewhere convenient, and then place in it one file called Info.plist, containing the following:

    ----------------- cut here ---------------------
   <?xml version="1.0" encoding="UTF-8"?>
   <!DOCTYPE plist PUBLIC "-//Apple Computer//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
   <plist version="1.0">
   <dict>
       <key>CFBundleDevelopmentRegion</key> <string>English</string>
       <key>CFBundleGetInfoString</key> <string>Libusb USB device Shield</string>
       <key>CFBundleIdentifier</key> <string>com.libusb.USB_Shield</string>
       <key>CFBundleInfoDictionaryVersion</key> <string>6.0</string>
       <key>CFBundleName</key> <string>Libusb USB device Shield</string>
       <key>CFBundlePackageType</key> <string>KEXT</string>
       <key>CFBundleSignature</key> <string>????</string>
       <key>CFBundleVersion</key> <string>6.0</string>
       <key>IOKitPersonalities</key>
       <dict>
           <key>HCFR</key>
           <dict>
               <key>CFBundleIdentifier</key> <string>com.apple.driver.AppleUSBComposite</string>
               <key>IOClass</key> <string>AppleUSBComposite</string>
               <key>IOProviderClass</key> <string>IOUSBDevice</string>
               <key>idVendor</key> <integer>1243</integer>
               <key>idProduct</key> <integer>91</integer>
           </dict>
       </dict>
       <key>OSBundleCompatibleVersion</key> <string>1.8</string>
       <key>OSBundleLibraries</key>
       <dict>
           <key>com.apple.kernel.iokit</key> <string>6.0</string>
       </dict>
   </dict>
   </plist>
    ----------------- cut here ---------------------

(You can also copy this from the source installation in libusb/Argyll.kext)

You then need to install it by using:

  sudo cp -R Argyll.kext /System/Library/Extensions

supplying the appropriate root password when prompted.
Reboot the system to activate the extension.