WUU on OS X

From WUUki

Jump to: navigation, search

As of 1.4.320, WUU is also distributed as a pre-compiled .app, with all dependencies already included - see the front page for more details - the below instructions is for running WUU from the source distribution


To run WUU from source on Mac OS X, you need at least Python 2.4+ (2.5[1] preferred) and wxPython 2.6+ (2.8[2] preferred) installed. Mac OS X ships with Python 2.3, so you need to download a more recent build before you use WUU.

Contents

[edit] Getting started

These instructions were tested on an Intel Mac running OS X 10.4.9. There should be no difference on a PowerPC Mac. OS X 10.3.9 may or may not work. Older versions can't run WoW anyway, so too bad for them.

First, run the Python and wxPython installers, in that order. Make sure they both complete successfully.

There are two ways to run WUU on a Mac: via the terminal or by building a double-clickable application bundle.

[edit] To run WUU via Terminal

Python is an interpreted language, so you can run the program directly from the source code.

  1. Download the WUU source distribution. Double-click to decompress it.
  2. Open a terminal window.
  3. Type: cd <WUU directory> (if you're not familiar with Terminal, just drag the WUU source folder from the Finder onto the terminal window, and OS X will fill out the directory automatically.)
  4. Type: python wuu.py

[edit] To build an application bundle

This is slightly more involved but will keep you from having to open new terminal windows every time you want to run WUU.
You need to have Python setuptools[3] installed for this one.

  1. Download the WUU source distribution. Double-click to decompress it.
  2. Open a terminal window.
  3. Type: cd <WUU directory>
  4. Type: python setup.py py2app -r logconfig.ini (The -r switch is important, if you don't do this, WUU will not run)
  5. Wait a minute while setup.py builds the application bundle for you.
  6. There should be two new folders in the WUU source folder: "build" and "dist". Open "dist".
  7. Run WUU.app. You can move it to /Applications or wherever.

[edit] Notes on using the application bundle

This generated application should be able to run on a Mac that doesn't have Python installed, although this is untested. You'll notice it is very large, about 40MB--this is because a complete copy of the required Python libraries are included.

Don't use the auto-updater if you use WUU this way. I haven't tried it but I don't think it would go too well.

Right now, WUU will store its settings inside the application bundle itself. If you build a new version of WUU and replace the old one, your preferences will be reset. To copy preferences from one WUU bundle to another: Right-click/control-click on the old version of WUU. Choose "Show Package Contents". Open the Contents folder that appears, then the Resources folder inside that. Do the same thing to the new version of WUU. Drag the "settings.wurm.xml" and "site_re.txt" files from the old Resources to the new one. Close all the windows. You can replace the old WUU with the new one now.

Retrieved from "http://wuu.vagabonds.info/wuuki/WUU_on_OS_X"
Personal tools