Instructions for setting up Emacspeak on the Mac.

Emacspeak_OSX_installation_instructions.sh

### Step-by-step terminal instructions to install emacspeak on OS X.

### Note by Amanda Lacy
### This file is based on the set of instructions  at this link:
### https://gist.github.com/izahn/cd784303663083ee2c95
### Also, thanks to Haden Pike, Tyler Littlefield, David Tseng and others on the Program-L list for their extra tips on Emacspeak settup.
### Those extra steps are at the botom of this file.
### End note

### If you are feeling lucky you can copy and paste this whole file into
### your terminal. Otherwise, read on for step-by-step instructions.
### Much of the information presented here was copied from
### http://e-mac-speak.googlecode.com/svn/trunk/e-mac-speak-howto.org
### More useful settings may be found at https://github.com/ragb/emacs-ragb/blob/master/init.el

## 1. Install Xcode from the App Store

## 2. Install brew

# run in terminal:
/usr/bin/ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"

# See http://brew.sh/ and https://github.com/Homebrew/homebrew/tree/master/#share/doc/homebrew#readme for details

## 3. Install emacs with

# run in terminal:
brew install emacs --with-cocoa --with-librsvg --with-gnutls --with-imagemagic

## 4. Symlink emacs. NOTE: this assumes you have emacs 24.5. If you have a different version of emacs you will need to adjust the command accordingly.

brew link emacs
brew linkapps emacs
rm /Applications/Emacs.app
cp -r /usr/local/Cellar/emacs/24.5/Emacs.app /Applications/

## 5. Install wget

# run in terminal:
cd ~/
brew install wget

## 6. Download emacspeak. NOTE: check https://github.com/tvraman/emacspeak/releases before running. If there is a more recent release you should use it instead.

# run in terminal
wget https://github.com/tvraman/emacspeak/releases/download/44.0/emacspeak-44.0.tar.bz2

## 7. Extract emacspeak

# run in terminal:
tar -xvf emacspeak-43.0.tar.bz2

## 8. Build emacspeak

# run in terminal:
cd emacspeak-44.0
make config
make emacspeak

## 9. Move emacspeak to installation folder. NOTE: the installation folder can be anywhere you want it to be. I used ~/Source but you could use something else if you like.

# run in terminal:
cd ~/
mkdir -p ~/Source
mv emacspeak-43.0 ~/Source/emacspeak

## 10. Tell emacs where to find the lisp files

# run in terminal:
mkdir -p ~/.emacs.d
echo "

(require 'cl)
(setq load-path (cons \"~/Source/emacspeak/lisp\" load-path))
(setq emacspeak-directory \"~/Source/emacspeak\")
(setq dtk-program \"mac\")
(require 'emacspeak-setup)
(require 'mac-voices)
(emacspeak-tts-startup-hook)
(dtk-set-rate 300 t)

" >> ~/.emacs.d/init.el

### Additional instructions start here:
### Add this line to the bottom of your .profile or .bash_profile.
export DTK_PROGRAM=mac

### Under ~/ create a file called .emacs if one does not exist already.
### Add the following line of Emacs Lisp to .emacs (without the pound signs).
### (load-file "<path to emacspeak checkout>/lisp/emacspeak-setup.el")

### How to test the speech server:
### Type the following commands at a terminal prompt:
cd ~/source/emacspeak/servers
chmod +x ./mac
./ mac  #You should hear Emacspeak "server."
q “This is a test”
d #You should hear "this is a test."

## 11 Start emacs and be happy!