Installing Pydon the Hard Way on OSX/Linux

Installation Dependencies


Dependencies are:

Optional dependencies:

Installation step by step

Step by step instructions are below, also always check the in the package for the latest information.

These step by step instructions are basically the commands carried out by the installation script.

The instructions below, need to be executed in the terminal. For each code snippet you see there, you have to copy them literally into the terminal, except when otherwise noted and except for the dollar sign, which indicates the command prompt.

On OSX you can find the program Terminal in the Applications folder, in the folder Utilities. Or with the Spotlight search.

On Linux you can usually find this in a menu like “Utilities”, and in some window managers if you press [ctrl]+[alt]+[t] it brings up a terminal window. Some file browsers also have shortcuts to open a terminal at a specific location.

[step 1] : unpack the package

Unpack the zip-file, and go to the folder you just created.

$ cd /location/of/my/pydon/download

where /location/of/my/pydon/download is the path in your file system.

On Linux systems, you can usually use tab-autocompletion to more easily find the path, i.e. type cd , then the first letters of the path, press tab, and the terminal will show you the possible completions, continue typing until only one option remains, and go to the next part of the path.

Rather than using the command line instructions below to unpack the three archives inside the zip (pyosc.tar.gz, pyserial-sensestage.tar.gz and XBee-2.0.1.tar.gz) you can also extract them with a graphical tool.

On OSX you can just doubleclick on them to extract them.

On Linux in the file manager there is usually a plugin to extract them.

[step 2] : check Python version

On some operating systems python will already be installed, before you go on, check whether you have the right version:

check which version you have:

$ python --version

If it is lower than 2.6 you will need to get a version higher than 2.6, but below version 3.

Make sure Python is in your path.

[step 3] : Install setuptools

Setuptools is a tool to manage dependencies for Python packages, you can get it at setuptools at and find install instructions there too.

  • Navigate to the extracted package
  • Type:

    $ python

  • Or as superuser (you’ll need to give your password)

    $ sudo python

Most Linux distributions also provide setuptools in their package manager, e.g. on Debian/Ubuntu you can install it with:

$ sudo apt-get install python-setuptools

[step 4] : Install the dependencies (from the pydon package you downloaded):


$ tar -xzvf pyosc.tar.gz
$ cd pyosc
$ sudo python install
$ cd ..

sudo is used in order to be able to execute commands as root, rather than as user. You may be asked for your password in order to execute the command – so you will need to have administrator rights on your computer.


$ tar -xzvf XBee-2.0.1.tar.gz
$ cd XBee-2.0.1
$ sudo python install
$ cd ..


$ tar -xzvf pyserial-sensestage.tar.gz
$ cd pyserial-sensestage
$ sudo python install
$ cd ..

[step 5] : Pydon

$ cd pydon
$ sudo python install
$ cd ..

For more information on python setup scripts, see the python documentation.

Starting the program

You can now start pydongui and pydoncli from anywhere on your system: