Emacspeak Mac OS X installation instructions

Emacspeak_OSX_installation_instructions.sh

### Step-by-step terminal instructions to install emacspeak on OS X.
### Copy-paste each step (one step at a time!) into the terminal.
### 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

## WARNING: These steps worked for me, but they may not work for you. In fact they may break things, turn your computer into
## a paperweight, and/or eat your kittens. These instructions are provided in the hope that they may be useful,
## but you are responsible for running them and for any damange doing so may cause.

## 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 and link python

# run in terminal:
brew install python
brew link --overwrite python

## 4. Install emacs 
## (Twice, yes, that is correct. Once for system emacs at /usr/local/bin/emacs, again for /Applications/Emaps.app)

# run in terminal:
rm -rf /Applications/Emacs.app
brew cask install emacs
brew install emacs --with-cocoa --with-librsvg --with-gnutls --with-imagemagic
brew link --overwrite emacs

## NOTE: sometimes the shell doesn't pick up the new emacs version in /usr/local/bin. 
## You can check which version your shell is picking up with
emacs --version
## if this reports less than 25.1 you should close the terminal application and restart 
## it before continuing to the next step.

## 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
rm -rf emacspeak*
wget https://github.com/tvraman/emacspeak/releases/download/45.0/emacspeak-45.0.tar.bz2
## 7. Extract emacspeak

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

## 8. Build emacspeak

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

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

# run in terminal:
cd ~/
mkdir -p ~/.emacs.d/emacspeak
mv emacspeak-45.0/* ~/.emacs.d/emacspeak

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

# run in terminal:
echo "

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

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


## 11 Start emacs and be happy!