Installing Pydon the Hard Way on OSX/Linux
- python (version 2.6 or higher; but NOT version 3 or higher) – http://docs.python.org/index.html, or e.g. http://www.python.org/download/releases/2.7.6/
- pyOSC – http://gitorious.org/pyosc (included in the packaged version)
- python-xbee-api (XBee-2.0.1) – (included in the packaged version)
- pyserial (version 2.6 or higher) – http://pyserial.sourceforge.net/ – (included in the packaged version)
- libmapper – check the information at http://www.idmil.org/software/ libmapper
Installation step by step
Step by step instructions are below, also always check the
INSTALL.md 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
/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 (
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 pypi.python.org and find install instructions there too.
- Navigate to the extracted package
$ python ez_setup.py
Or as superuser (you’ll need to give your password)
$ sudo python ez_setup.py
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 setup.py 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 setup.py install $ cd ..
$ tar -xzvf pyserial-sensestage.tar.gz $ cd pyserial-sensestage $ sudo python setup.py install $ cd ..
[step 5] : Pydon
$ cd pydon $ sudo python setup.py 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: