Installing vlab on Mac OSX

The download is a DMG disk image. Opening it, you will find:

  • browser — the application bundle containing the main vlab application;
  • oofs — a directory containing example objects;
  • raserver — the “remote access server”, which lets you share vlab objects over a network.

To run vlab, simply copy the browser application to your /Applications directory and open it from there; this will open the vlab browser, which you can use to open the sample oofs, or your own.

You can also run vlab and its components from the command line; all of the executables are in the directory
/Applications/browser.app/Contents/MacOS/dbin
You can add it to your system path by executing the following command in a Terminal:
export PATH=$PATH:/Applications/browser.app/Contents/MacOS/dbin
Finally, you can simply run the browser by typing:
/Applications/browser.app/Contents/MacOS/dbin/browser
The advantage of running vlab from the Terminal is that messages (e.g. error messages) will appear there.

To use the simulators lpfg, vv, and vve, you will need to have a C++ compiler installed. The easiest way to do this is to install g++, which is part of the “Command Line Tools for Xcode” package. This package can be downloaded directly from Apple at developer.apple.com/downloads (you have to sign up for a (free) Apple ID before downloading). The program you need to download depends on your OS version:

  • 10.5 “Leopard” — Download Xcode 3.0
  • 10.6 “Snow Leopard” — Download Xcode 3.2
  • 10.7 “Lion” and up — Download “Command Line Tools for Xcode” for your particular version

Back to Software