# Installation Instructions

# Prerequisites:

First, install these and make sure they work.

## Python:

A recent release is needed. Developement took place using the 2.3.x release series. Any 2.X release should work, but hasn't been tested. Under MacOSX 10.3 (panther), Python is installed by default. Installation instructions are available at the python website: www.python.org

## PySerial

This is needed to communicate with the serial port. It is available from sourceforge: http://pyserial.sourceforge.net/. Download and install it. Use version 2.0.

## WxPython (optional):

WxPython is needed if you want to use the pretty graphical interface to sensor data and DTC management. It's available at www.wxpython.org. Version 2.4 is required. pyOBD will not work with the 2.5 release series.

## Ncurses (optional):

In addition to wxpython, there is a text/ncurses interface. To use it, enable the ncurses module when you build python. It isn't very polished and use is not recommended.

# Installation:

After those requirements, installation is a snap. Simply download the release tarball and uncompress it. To "install" pyOBD on the system, simply copy the release directory to wherever you want (i.e. /opt, /usr/local). To use the wx interface run python wxgui.py. If you're using MacOSX, substitute "pythonw" for "python".

-- Donour Sizemore