At this point, one may read the file ~/stk/stk/INSTALL to find out how to configure and compile the STK. However, for Linux users with ALSA sound driver support, the following simplified procedure can be followed.
Download the file
stk4p2p1josoverlay.tar.gz
and unpack it as follows (assuming ~/stk/stk/
contains release
4.2.1 of the STK as prescribed above):
$ cd ~/stk $ # copy josoverlay package to current directory, \eg, $ scp -d ccrma-gate.stanford.edu:~jos/Web/stk4p2p1josoverlay.tar.gz . $ tar -zxf stk4p2p1josoverlay.tar.gz $ cp -rp stk4p2p1josoverlay/* stk/
Notice that one new directory (~/stk/stk/myproj) has appeared. This directory is logically parallel to the STK projects directory. It is kept separate so that it can be easily copied into new releases of the STK.
Now, as described in the new file ~/stk/stk/INSTALL.jos, to configure and compile the STK, just type, in the directory ~/stk/stk/,
make config make
The top-level Makefile, from the overlay, contains the new ``make config'' target:
config: configure --enable-debug --with-alsa RAWWAVE_PATH="../../rawwaves/"
The configure command generates all the various MakefilesA.2 based on automatically detected characteristics of your system [501]. The file INSTALL contains more detailed installation instructions which you should not need under UNIX if you are following this example. On the other hand, it is good to read INSTALL and README for your general edification. Similarly, the doc/ directory should be explored to learn about the STK in general.
Thus, make config uses the following configuration options:
jackstart -R -d alsa -d hw -r 44100 &The jack audio server is also included in the Planet CCRMA distribution.
Finally, to test out the added myproj directory, in the ~/stk/stk directory, type
cd myproj makeThe default make target in the myproj directory is test. Therefore, you should hear test sound emitted after each subdirectory is made. Before the tests are compiled, however, the STK library is made, so first you see the many library files being compiled. (See the various Makefiles regarding how this is carried out.) If you do not hear the test sounds, read myproj/delay/README for some trouble-shooting tips.