Mute Build Instructions

Linux Build Instructions

Configuring and Building

First make sure you have these libraries and tools installed:

• python 2.4
• wxPython 2.6
• libsndfile
• ctypes for Python 2.4
• SCons
• Subversion
• gcc/g++
• LADSPA SDK
• libjack
• libalsa

For Debian/Ubuntu, you're going to need following packages:

sudo apt-get install build-essential python2.4 python-wxgtk2.6\
 libsndfile1 libsndfile1-dev scons ladspa-sdk python-ctypes libasound2-dev libjack0.100.0-dev

Next, check out the entire zzub svn, which includes source to Mute, Buzé, libzzub and plugins. You're going to need almost everything anyway. Subversion will also check out portaudio v19, which is going to be built statically into libzzub.

# svn co http://svn.zeitherrschaft.org/zzub/trunk zzub
# cd zzub

Now build the entire zzub tree:

# scons PREFIX=/usr/local

If that worked, install mute and update the dynamic library loader cache. Make sure that /usr/local/lib is mentioned in /etc/ld.so.conf:

# sudo scons install
# sudo ldconfig

To uninstall and clean the zzub tree later on, try:

# sudo scons -c install

You should uninstall and clean the tree whenever you are going to upgrade the repository.

Testing

Now you're ready to run mute:

[paniq@aspera zzub]$ mute
enumerating /usr/local/lib/zzub/libMatilde Tracker.so
loading machine '/usr/local/lib/zzub/libMatilde Tracker.so'
...

Try loading ../test/test.bmx for a sound test. You should hear some junglist massive.

Troubleshooting

• Q: I get a Segmentation Fault when I start mute with jack enabled.
• A: current svn (2006-10-04) has a broken Jack. Try applying this patch to the portaudio source tree.

Windows Build Instructions

Thanks to Pieter Holtzhausen for working out the instructions.

Configuring and Building

First make sure you have these libraries and tools installed:

• python (2.4 or 2.5)
• wxPython 2.6 (for either Python 2.4 or Python 2.5)
• ctypes (only for Python 2.4)
• SCons
• Subversion
• MinGW (gcc/g++) or Visual C++ 2005 Express Edition and the Platform SDK
• Steinberg ASIO SDK 2

At the moment, to get ASIO support, you need Visual C++ installed. Building with MinGW is untested, but we'd love to hear about your results.

Next, check out the entire zzub svn, which includes source to Mute, Buzé, libzzub and plugins. You're going to need almost everything anyway. You can either do this using Tortoise SVN or the command line client. Subversion will also check out portaudio v19, which is going to be built statically into libzzub, and libsndfile binaries for Windows, since you don't want to be bothered with building those as well.

C:\> svn co http://svn.zeitherrschaft.org/zzub/trunk zzub
C:\> cd zzub

Download the Steinberg ASIO SDK 2 and extract it into the zzub directory, so that its content is in ./ASIOSDK2.

Start up the Visual C++ Command prompt and build the project:

C:\> cd zzub
C:\zzub> scons PREFIX=

When everything is alright, you can either run Mute directly from this directory running Mute.bat, or you can install a fresh copy into a new directory, ready for deployment:

C:\zzub> scons DESTDIR=c:\mute_build

Of course you can substitute this path with something else.

Testing

Before you can run Mute, you need to make sure that Python is in your PATH. You can set this system wide, by opening My Computer -> Properties -> Advanced -> Environment Variables, selecting the PATH line in the System variables box, and appending your local Python path (e.g. ;C:\Python25). You can check out if this works, by opening Start -> Run... and entering python. You should see a Terminal Window.

When Python works, go to your zzub folder and run Mute.bat.

OS X Build Instructions

No build instructions yet.