InstallSoftware

O2S runs under Windows (cygwin), Linux, and Mac OS X. This page describes how to install the necessary software to run O2S.

NOTE: Be sure to install software listed in both the Required Software and Additional Modules sections.

For deprecated (historical) instructions, see OldInstallSoftware.

Contents

1. Required Software
   1. Subversion
   2. Python & GNU Tools
      1. Python: Windows
      2. Mac OS X
      3. GNU/Linux
   3. Zeroconf/Bonjour: mDNSResponder and Avahi
      1. mDNSResponder
         1. Windows
         2. Mac OS X
         3. GNU/Linux
      2. Avahi
2. Additional Modules
3. Advanced: Compiling Additional (Python) Modules
   1. Windows
   2. Mac OS X

Required Software

At a minimum, you will need

• Subversion (to check out the O2S codebase)

• Python and GNU Tools (to run O2S)

• Zeroconf/Bonjour (for resource discovery)

Subversion

Install subversion:

• Windows: See below (Installing Cygwin).

• Mac OS X: Download here: http://www.codingmonkeys.de/mbo/

• GNU/Linux (Debian): apt-get install subversion

Python & GNU Tools

O2S requires Python 2.3 or higher (2.4 preferred), as well as standard GNU utilities (e.g., make).

Python: Windows

First, install Cygwin: http://www.cygwin.com/. Be sure to install subversion.

Then, download and install Win32 Python 2.4.3: [ Python Installer]

Finally, /SetupCygwin

Mac OS X

With Tiger OS X 10.4, Python 2.3 is installed by default. However, we recommend that you install [ Universal Binary MacPython 2.4]. Additionally, you will still need to install the GNU development tools (notably for make), which can be found on the Tiger Install CD (install the Xcode development tools).

GNU/Linux

You should have most GNU tools installed by default. To get Python on debian:

% apt-get install python

Zeroconf/Bonjour: mDNSResponder and Avahi

IETF Zeroconf (a.k.a. Apple Bonjour) specifies the mDNS (for naming) and dns-sd (for resource discovery) standards. Apple's mDNSResponder is an implementation of Zeroconf/Bonjour and is known to run on Microsoft Windows, Mac OS X, and GNU/Linux. [ Avahi] is an alternative implementation and runs only on GNU/Linux.

mDNSResponder

Instructions for installing mDNSResponder:

Windows

See below (Additional Modules) for installer.

Mac OS X

Nothing to do; mDNSResponder is shipped standard with Mac OS X 10.4.

GNU/Linux

Check out the o2s-libs directory from subversion (see CheckOut for details). Read o2s-libs/zeroconf/README.NOW for build instructions.

Avahi

TODO

---

Additional Modules

You will also need the following Python extension modules:

• Bonjour-Python bindings

• [ PyAudio] ([ PortAudio v19] Python bindings)

• [ libMAD] and [ PyMAD] (MP3 decoder)

• py-xmlrpc (FastXMLRPC)

• [ wxPython]

The O2S Libraries installer will fetch and install pre-compiled binaries for the above packages (and possibly others). If you wish to build these modules from source, see the next section. Installers are available here:

• [ All O2S Libraries for Windows]

• [ All O2S Libraries for Mac OS X]

Alternatively, URL shortcuts to these installers are in o2s/libraries/ (see CheckOut for details).

---

Advanced: Compiling Additional (Python) Modules

All source code for the additional Python modules is available in subversion; see CheckOut. To build these modules from source, you will also need to install:

Windows

• Compiler/Linker: [ MinGW]

• Installer/Packager: [ NSIS]

Mac OS X

• Universal Binary SDK: [ Xcode 2.4]

Additionally, you will also need to download or compile [ SWIG] for a few of the modules. See individual README files for build instructions.

---