Next  |  Prev  |  Top  |  JOS Index  |  JOS Pubs  |  JOS Home  |  Search

Installing and Testing the STK

As of this writing (April 14, 2017), the preferred way to obtain the STK software is by cloning the GitHub project:

git clone git://github.com/thestk/stk
Doing it this way gets around a ``broken pipe'' problem in one of the percussion demos. It also gives you the latest and greatest at all times, including any new bugs introduced by the developers. Any bugs encountered should be reported on Piazza, and if appropriate we file a bug report on the ``Issues'' page at the STK GitHub site. (Feel free to do this yourself if you are an experienced software developer.)

Alternatively, the STK software distribution may be obtained by going to the STK home page, navigating to the download page, and downloading the latest ``source distribution'' (stk-4.5.1.tar.gz as of 4/15/2017).

See the file INSTALL.md for instructions on installing it. The basic drill for users (see below for developers) is to cd to the top-level stk directory in a shell (such as an Emacs shell, or Terminal.app on the Mac) and type

autoconf
./configure
make
where the autoconf utility is part of the GNU Autotools (already installed at CCRMA). On a Mac, you can use either MacPorts or Homebrew to install autoconf, e.g.,
> sudo port install autoconf
where the port command is installed when MacPorts is installed.

Note: As of this writing (April 15, 2017), on the Mac, there is a missing configure dependency for the Jackmp framework, so that the play command fails at run-time. This does not happen on the CCRMA Linux systems.

It is recommended anyway to use the play command installed by the sox distribution:
port install sox
where the port command is installed by MacPorts.


Next  |  Prev  |  Top  |  JOS Index  |  JOS Pubs  |  JOS Home  |  Search

Download stkintro.pdf
[Comment on this page via email]

``Getting Started with the Synthesis Tool Kit (STK)'', by Julius O. Smith III, Music 420 Reader supplementing the text).
Copyright © 2017-04-15 by Julius O. Smith III
Center for Computer Research in Music and Acoustics (CCRMA),   Stanford University
CCRMA