TAPESTREA : Build/Install Instructions

version: 0.1.x.x (tap tap)

home: http://taps.cs.princeton.edu/

Installing the Executable

If you are using the executable, you only need to put bin/osx-universal/taps (osx) or bin\win32\taps.exe (win32) somewhere convenient.

Installing for command line (optional)

To put taps in your path so it can be launched from the command line, do the following:

In MacOS X: in Terminal, go to the bin/osx-universal/ directory and type:

 %> sudo cp taps /usr/bin/
    (enter your password when prompted)

 %> sudo chmod 755 /usr/bin/taps

On Windows: put bin\win32\taps.exe (and the .dll files) in c:\windows\system32\. To run under windows: use start->run: cmd (or use cygwin)

At this point, you should be able to invoke taps from either Terminal (in OSX) or 'cmd' under windows, from any directory.

Launching taps:

Simply double-click on taps (os x) or taps.exe (windows).


(if installed for command line) open a terminal and type 'taps'

That's it for the binary release!

  1. Go to the src/ directory (replace tapestrea-x.x.x.x with the actual directory name):

    %> cd tapestrea-x.x.x.x/src/

  2. If you type 'make' here, you should get the following message:

    %> make
       [taps build]: please use one of the following configurations:
           make linux-oss, make linux-alsa, make linux-jack, 
           make osx, make osx-ub, or make win32

    If you'd like to change the default sample rate conversion settings, here is a detour.

    Note that taps needs a version of libxml2 with the file 'xmlwriter.h'. So you may need to install a more recent version of libxml2 to enable XML templates. To change the libxml include directory for your system, edit the "INCLUDES" line under "# for libxml" in the corresponding makefile. To disable XML templates, comment ("#") out all three lines under "# for libxml".

    To build on Windows using MSVC6.0, ignore steps 3 to 5 and use the project file 'tapestrea.dsp'.

  3. Now, type the command corresponding to your platform... for example, for MacOS X (Universal Binary):

    %> make osx-ub

    or for Linux (Alsa):

    %> make linux-alsa


  4. If you like, install taps (cp into /usr/bin by default). If you don't like the destination, simply edit the makefile under 'install', or skip this step altogether.

    # (optional: edit the makefile first)
    %> make install

  5. If you haven't received any error messages up to this point, then you should be done! There should be a 'taps' executable in the current directory. For a quick sanity check, execute the following (use './taps' if taps is not in your path), and see if taps runs:

    %> taps

    (If you do get error messages during compilation, or you run into some other problem - please let us know and we will do our best to provide support.)

  6. You are ready to use TAPESTREA!!! If this is your first time, you may want to look at the documentation, watch the video, and try some of the examples included in the distribution. Thank you very much. Go forth and design cool sounds.

taps | soundlab | cs | music