From Eulorum
Jump to: navigation, search

Installing eulora on Mac OS X requires building from source but we made the process as painless as possible. If you run into any problems with the installation, please bring them to the attention of phf on the #eulora channel on Freenode.

1. "I just want to play the game" instructions[edit]

This is the easiest option if you don't already have homebrew installed and just want to play the game. It keeps things isolated and allows for easy cleanup: just delete eulora directory and start from scratch. Note that homebrew is a package manager for mac, and it's worthwhile to have it installed globally and know how to operate it. If you'd like to give it a try, visit http://brew.sh and follow their installation instructions, then come back and start with section 2.

Install homebrew into a "eulora" directory in your home directory.

mkdir eulora && curl -L https://github.com/Homebrew/homebrew/tarball/master | tar xz --strip 1 -C eulora

Note that if you don't have xcode development tools installed Mac OS X will prompt you for your Administrator password and install the tools automatically.

Add eulora recipes to the newly installed homebrew.

~/eulora/bin/brew tap pf/eulora

Install eulora itself. This step takes 20 minutes on a 2011 macbook pro, since it compiles eulora and all its dependencies from scratch.

~/eulora/bin/brew install eulora

To run eulora navigate to eulora/opt/eulora directory in your home directory and run euclient.app, or execute from command line

open ~/eulora/opt/eulora/euclient.app

(optional) In order to upgrade eulora run

~/eulora/bin/brew update && ~/eulora/bin/brew upgrade eulora

2. I have homebrew already[edit]

If you already have homebrew installed you need to tap eulora formulas

brew tap pf/eulora

and install eulora

brew install eulora

you can now run brew linkapps --local eulora and you'll have "euclient.app" in ~/Applications, or else you can start it directly, open $(~/eulora_homebrew/bin/brew --prefix eulora)/euclient.app

The formulas in the tap are cal3d, cs and eulora.

3. (optional) Verification[edit]

All the installation commands and patches are inside the tap directory, which is a git repository. Running brew tap-info pf/eulora will give you location of the repository on your machine. All the patches inside the repository are pgp signed, so if you run git log --show-signature inside the tap directory you will see one or more log entries with corresponding "Good signature from" lines. Unfortunately there's no straightforward way to automate or enforce all this with homebrew, so verification is left as an exercise for a dedicated user. Homebrew itself downloads the source code from the urls in taps and then checks their sha256 sums, so as long as the tap repository is verified you should be safe.