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
Installing for command line (optional)
To put taps in your path so it can be launched from the command line, do
In MacOS X: in Terminal, go to the bin/osx-universal/ directory
%> 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.
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!
- Go to the src/ directory (replace tapestrea-x.x.x.x with the actual
%> cd tapestrea-x.x.x.x/src/
- If you type 'make' here, you should get the following message:
[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
- Now, type the command corresponding to your platform...
for example, for MacOS X (Universal Binary):
or for Linux (Alsa):
- 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
- 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:
(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
- 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.