From: Todd Lehman Subject: Preparing for installation of Clips software There are 7 additional software components needed for full operation of the Clips script compiler. I'll list them below, first with a brief description of what they are and why they are required, followed by instructions or where/how to obtain the software. Once these are installed, you won't ever need to think about them again -- the Clips software will know how to access them. OVERVIEW 1. [Optional] Mac OS X Speech Synthesis voices. In addition to the two high-quality voices that are preinstalled on every new Mac, there are 14 other English-speaking voices which can be installed, two of which are quite good and are much better than the defaults. If you're certain that you'll be replacing all of the computer- generated audio with your own recorded voice, then these can be skipped (or added later) and you can start with the preinstalled, lower-quality voices. The optional voices are easy to install, but together will require 5 to 7 GB of disk space. 2. Xcode Development Tools. This is a very large software tool from Apple which allows anyone to develop new software for Mac OS X, and is a prerequisite for installing the remaining items. This will require 4 to 5 GB of disk space. 3. MacPorts. This is a software tool with which other software tools can be installed. It is needed for the remaining components. 4. ImageMagick. This is for doing all sorts of image manipulation and is needed by Clips for converting PDF documents to PNG images. 5. pdftk (PDF ToolKit). This is needed by Clips for splitting a PDF document apart into separate pages. 6. sox (SOund eXchange). This is needed by Clips for optimizing and transcoding the audio into MP4 and OGG audio formats for cross-browser compatibility and running in a web browser. 7. Graphviz. This is used for generating a node graph showing the interrelations of the Clips frames, which is useful in visualizing and checking the complex branching of a lesson while it is being developed. INSTALLATION 1. For the speech synthesis voices, the place to start is System Preferences. Go to the "Dictation & Speech" settings and select the "Text to Speech" tab. From there, click the drop-down list labeled "System Voice" and select "Customize..." at the bottom of the list. A smaller popup window will appear. In that window, checkmark the following and then click "OK": English (United States) -- Female [x] Allison [x] Ava [x] Samantha [x] Susan English (United States) -- Male [x] Alex [x] Tom English (Australia) [x] Karen [x] Lee English (India) [x] Veena English (Ireland) [x] Moira English (Scottish Standard English) [x] Fiona English (South Africa) [x] Tessa English (United Kingdom) [x] Daniel [x] Kate [x] Oliver [x] Serena Your computer will then begin downloading each of these voices from Apple. It will take at least an hour, as the files for the voices are large. I recommend leaving the System Preferrences pane open in order to check on the download progress periodically. 2. Xcode must be installed via the Mac App Store. Launch the "App Store" application (in your computer's Applications folder) and sign in using your Apple ID (if necessary). Then, in the search box in the upper right corner, type "Xcode" and press Return. The first search result should say "Xcode Developer Tools"; it has an icon depicting a hammer and a blueprint. Next to that icon, click "GET" and then "INSTALL APP". This will begin the (long) process of downloading Xcode from the App Store and onto your computer. The easiest way to check on the download progress is to go into Launchpad (via either the F4 button on your laptop or by going to the "Launchpad" application in your Applications folder). When Xcode has finished downloading, I believe it will automatically install itself in your Dock. But if not, you can always launch it from the Applications folder. Launch Xcode to verify that it was installed correctly, and then simply Quit it. Next, there is a sub-component of Xcode to install called the "Command Line Tools." These are needed for doing any serious software work inside the Terminal application. To install the tools, open a web browser and navigate to: https://developer.apple.com/downloads/index.action There, in the search box at the upper left (but not the one at the upper right!), type "Command Line Tools" and press Enter. At the top of the search results should be an item labeled "Command Line Tools (OS X 10.10) for Xcode - Xcode 6.1.1" dated December 2, 2014. This is the appropriate item to download for your OS X 10.10 Yosemite system. Click on the disclosure triangle and then click the blue link at the right, next to the little paper with the hard drive icon. This will begin downloading a 100 MB disk image file into your Downloads folder, which should take only a couple of minutes. When the download completes, look for it in your Downloads folder (it will be a file called "commandlinetoolsosx10.10forxcode6.1.1.dmg") and double-click it to open it. A small Finder window containing a brown and yellow box icon in a will appear. Double-click the box icon (it should say "Command Line Tools (OS X 10.10).pkg" below it) and follow the installation steps, accepting the defaults. When the installer completes and exits, you can then eject the Command Line Tools disk image using the Finder and then move the disk image (.dmg) file to the trash, as it will no longer be needed. At this point the command line tools should be installed. To verify this, open the Terminal application (in Applications > Utilities) and at the command prompt type "which gcc" and press Enter. If all is good, it should print out "/usr/bin/gcc". One final step with Xcode is to accept its license. In a Terminal window, type "sudo xcodebuild -license" and press Return. This will prompt you for your computer's password as a security precaution. The reason for the security precaution is because the "sudo" command causes the following commands to be run as the computer's superuser (a Unix idiosyncrasy, sometimes called the Administrator account). Following acceptance of your password, it will display the terms of the software license and ask you to accept. 3. To install MacPorts, navigate to: https://www.macports.org/install.php and click the Quickstart link labeled "OS X 10.10 Yosemite." This will download a small file called "MacPorts-2.3.3-10.10-Yosemite.pkg" (or it might have a slightly different name) into your Downloads folder. When the download is complete, double-click the .pkg file to launch the installer. Follow the installation steps, accepting the defaults. You will probably be prompted for your computer's password again, as the software needs special privileges. When the installer completes and exits, you can move the .pkg file to the trash. At this point, MacPorts should be installed. To verify this, open a Terminal window and type "port help" and press Return. It should display a bunch of help text, which you can ignore. 4-7. The last steps are easy for you, but they will make the computer work very hard for possibly up to an hour. Using the MacPorts installer, you can install all of the remaining software using a single typed command. In a Terminal window, type the following and press Return: sudo port install ImageMagick pdftk sox graphviz Depending on how much time has elapsed since the last "sudo" command, you may or may not need to re-enter your computer's password. (If you're curious: "port" is the actual name of the MacPorts software program, and "sudo" is the portion of the command line which tells your system to run "port" as the superuser. "install" is a subcommand of "port", and the remaining four words are the names of the software packages that "port" is supposed to install.) Your computer will display lots and lots of text in the Terminal window as it automatically fetches and builds these four programs and their dependencies. It may take up to an hour to do this, and your computer's fan might make noise, which is normal for this step. When the installation is complete, you should see a "$" prompt again, and hopefully there were no error messages displayed (which would appear directly above it). To confirm that the installation was successful, type the following and press Return: port list installed This will list several dozen packages. Among them should be ImageMagick, pdftk, sox, and graphviz. The others are packages which were installed automatically as dependencies. If everything looks good, you can close the Terminal window by typing "exit" and pressing Return. --Todd