diff options
Diffstat (limited to 'doc/Installing_OSX.html')
-rw-r--r-- | doc/Installing_OSX.html | 283 |
1 files changed, 283 insertions, 0 deletions
diff --git a/doc/Installing_OSX.html b/doc/Installing_OSX.html new file mode 100644 index 0000000..d3f9057 --- /dev/null +++ b/doc/Installing_OSX.html @@ -0,0 +1,283 @@ +<!DOCTYPE HTML PUBLIC "-//w3c//dtd html 4.0 transitional//en"> +<html> +<head> + <meta http-equiv="Content-Type" + content="text/html; charset=ISO-8859-1"> + <meta http-equiv="content-type" + content="text/html; charset=ISO-8859-1"> + <meta name="GENERATOR" + content="Mozilla/4.73 [en] (WinNT; I) [Netscape]"> + <title>Argyll Installation on Apple OS X</title> +</head> +<body> +<h1> +<u>Installing the software on Apple OS X<br> +</u></h1> +<br> +You +will need to unpack the downloaded file in the location you have chosen +to hold the executable files. Typically this might be in <span + style="font-style: italic;">/usr/bin</span>, or perhaps <span + style="font-style: italic;">$HOME/bin/</span>.<br> +<br> +You can unpack it by control-click on the downloaded file +and “Open With” BOMArchiveHelper or Archive Utility. Drag the resulting +folder to where you want it, e.g. into your home folder (/Users/usrnam +where usrnam is your username).<br> +<br> +Alternatively you can unpack it on the command line using the +command <span style="font-weight: bold;">tar -zxf</span> <span + style="font-weight: bold;">archivename.tgz</span>, which will create a +directory <span style="font-weight: bold;">Argyll_VX.X.X</span>, where +X.X.X is the version number, and the executables will be in <span + style="font-weight: bold;">Argyll_VX.X.X/bin</span>. <br> +<br> +Open a Terminal shell. This will be in +Applications->Utilities->Terminal (Dragging it to the dock is a +good idea to make it more accessible).<br> +<br> +You will have to +configure your $PATH environment variable to give access to the +executables from your command line environment, by editing your <span + style="font-weight: bold;">.profile</span> file.<br> +You can do this using a graphical editor, by using the open command:<br> +<br> + ~$open .profile<br> +<br> +or by using some other editor, such as <span style="font-weight: bold;">vi</span>.<br> +<br> +And add the following line to your .path file<br> +<br> + PATH=$PATH:$HOME/Argyll_V1.1.1/bin<br> +<br> +If you are unfamiliar +with how to do this, consult an appropriate tutorial, e.g. <<a + href="http://heather.cs.ucdavis.edu/matloff/public_html/UnixAndC/Unix/ShellIntro.pdf">ShellIntro</a>>. +The +.tgz +file +also +contains +several +useful +reference files (such as +scanner chart recognition templates, sample illumination spectrum +etc.) in the ref sub-directory, as well as +all the current documentation in a doc sub-directory.<br> +<br> +For most devices there is nothing special to do. Plug in and go. Some +devices may not work without some extra help though:<br> +<h3><a name="ColorMunki"></a><span style="text-decoration: underline;">X-Rite +ColorMunki</span></h3> +Some version of X-Rite's ColorMunki drivers released between 2009 and +2011 install an X-Rite +daemon that runs as root and grabs the device, preventing any other +programs (such as Argyll) from opening them. Latter versions seem to be +more cooperative, and don't suffer from this problem. There are three +ways of +working around this problem:<br> +<br> +1) Turn off the X-Rite service for the ColorMunki. See <<a + class="moz-txt-link-freetext" + href="http://www.xrite.com/product_overview.aspx?ID=1161&Action=support&SupportID=4980">http://www.xrite.com/product_overview.aspx?ID=1161&Action=support&SupportID=4980</a>>.<br> +<br> +2) Run all Argyll programs that need to access the instrument as root. +For instance:<br> +<br> + sudo spotread<br> +<br> +and then you will be asked for the root password.<br> +While these methods will work, they are incovenient. <br> +<br> +3) Alter the X-Rite drivers Daeomon so that it runs under your user +account.<br> +<br> +To do this you need to edit the script that controls the X-Rite Daemon.<br> +<br> + cd ~<br> + whoami<br> + cp +/Library/LaunchDaemons/com.xrite.device.colormunki.plist temp.plist<br> + open temp.plist<br> +<br> +and add one child below the root:<br> +<br> + <span style="text-decoration: underline;">Item +Type +Value +</span><br> + UserName + +string +myusername<br> +<br> +where "myusername" is your username shown by whoami, and save the file. +You then need +to copy the modified file back: <br> +<br> + sudo cp temp.plist +/Library/LaunchDaemons/com.xrite.device.colormunki.plist<br> +<br> +You will then need to restart the machine for this change to take +effect, or invoke the following commands:<br> +<br> + sudo launchctl unload +/Library/LaunchDaemons/com.xrite.device.colormunki.plist<br> + sudo launchctl load +/Library/LaunchDaemons/com.xrite.device.colormunki.plist<br> +<br> +<span style="font-weight: bold;">NOTE</span> that after running Argyll +tools, you may have to turn the X-Rite service off then on again, or +disconnect and reconnect the instrument.<br> +<br> +<h3><a name="ColorMunki"></a><span style="text-decoration: underline;">X-Rite +EyeOne +Pro</span><br> +</h3> +Some version of X-Rite's EyeOne Pro drivers drivers released between +2009 and +2011 install an X-Rite +daemon that runs as root and grabs the device, preventing any other +programs (such as Argyll) from opening them. Latter versions seem to be +more cooperative, and don't suffer from this problem. There are three +ways of +working around this problem:<br> +<br> +1) Turn off the X-Rite service for the EyeOne Pro. See <<a + class="moz-txt-link-freetext" + href="http://www.xrite.com/product_overview.aspx?ID=1161&Action=support&SupportID=4980">http://www.xrite.com/product_overview.aspx?ID=1161&Action=support&SupportID=4980</a>>.<br> +<br> +2) Run all Argyll programs that need to access the instrument as root. +For instance:<br> +<br> + sudo spotread<br> +<br> +and then you will be asked for the root password.<br> +While these methods will work, they are incovenient. <br> +<br> +3) Alter the X-Rite drivers Daeomon so that it runs under your user +account.<br> +<br> +To do this you need to edit the script that controls the X-Rite Daemon.<br> +<br> + cd ~<br> + whoami<br> + cp +/Library/LaunchDaemons/com.xrite.device.i1.plist temp.plist<br> + open temp.plist<br> +<br> +and add one child below the root:<br> +<br> + <span style="text-decoration: underline;">Item +Type +Value +</span><br> + UserName + +string +myusername<br> +<br> +where "myusername" is your username shown by whoami, and save the file. +You then need +to copy the modified file back: <br> +<br> + sudo cp temp.plist +/Library/LaunchDaemons/com.xrite.device.i1.plist<br> +<br> +You will then need to restart the machine for this change to take +effect, or invoke the following commands:<br> +<br> + sudo launchctl unload +/Library/LaunchDaemons/com.xrite.device.i1.plist<br> + sudo launchctl load +/Library/LaunchDaemons/com.xrite.device.i1.plist<br> +<br> +<span style="font-weight: bold;">NOTE</span> that after running Argyll +tools, you may have to turn the X-Rite service off then on again, or +disconnect and reconnect the instrument.<br> +<br> +<h3><a name="HCFR"></a>HCFR Colorimeter</h3> +The default OS X class +drivers will grab this 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:<br> +<br> + ----------------- cut here ---------------------<br> + <?xml version="1.0" encoding="UTF-8"?><br> + <!DOCTYPE plist PUBLIC "-//Apple Computer//DTD PLIST +1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd"><br> + <plist version="1.0"><br> + <dict><br> + +<key>CFBundleDevelopmentRegion</key> +<string>English</string><br> + <key>CFBundleGetInfoString</key> +<string>Libusb USB device Shield</string><br> + +<key>CFBundleIdentifier</key> +<string>com.libusb.USB_Shield</string><br> + +<key>CFBundleInfoDictionaryVersion</key> +<string>6.0</string><br> + <key>CFBundleName</key> +<string>Libusb USB device Shield</string><br> + <key>CFBundlePackageType</key> +<string>KEXT</string><br> + <key>CFBundleSignature</key> +<string>????</string><br> + <key>CFBundleVersion</key> +<string>6.0</string><br> + +<key>IOKitPersonalities</key><br> + <dict><br> + +<key>HCFR</key><br> + <dict><br> + +<key>CFBundleIdentifier</key> +<string>com.apple.driver.AppleUSBComposite</string><br> + +<key>IOClass</key> +<string>AppleUSBComposite</string><br> + +<key>IOProviderClass</key> +<string>IOUSBDevice</string><br> + + <key>idVendor</key> +<integer>1243</integer><br> + + +<key>idProduct</key> +<integer>91</integer><br> + </dict><br> + </dict><br> + +<key>OSBundleCompatibleVersion</key> +<string>1.8</string><br> + <key>OSBundleLibraries</key><br> + <dict><br> + +<key>com.apple.kernel.iokit</key> +<string>6.0</string><br> + </dict><br> + </dict><br> + </plist><br> + ----------------- cut here ---------------------<br> +<br> +(You can also copy this from the source installation in +usb/Argyll.kext)<br> +<br> +You then need to install it by using:<br> +<br> + sudo cp -R Argyll.kext /System/Library/Extensions<br> +<br> +supplying the appropriate root password when prompted.<br> +Reboot the system to activate the extension.<br> +<br> +<p><br> +</p> +</body> +</html> |