Here is how to install RTcmix and its instrument packages. If you have trouble, please join the rtcmix-discuss mailing list (http://music.columbia.edu/mailman/listinfo/rtcmix-discuss), and ask for help. 1. Download RTcmix-[version].tar.gz and unpack it anywhere you like (in your home directory, or in /usr/local/src, for example) by typing tar xfz RTcmix-[version].tar.gz (or: gunzip -c RTcmix-[version].tar.gz | tar xf - ) 2. If you downloaded the "cadillac version," which contains the optional instrument packages, skip this step. Download at least the std and jg packages, and unpack them into the "insts" directory of your RTcmix. 3. cd into the top level of the RTcmix directory, and run the configure script: ./configure There are some options you might want to give this script. Here's a description of them. If you already ran configure without the options, it's okay to run it again with the options you want. --with-alsa Use the ALSA driver on Linux --with-perl Build the Perl-enabled RTcmix (PCMIX) --with-python Build the Python-enabled RTcmix (PYCMIX) --with-netplay Enable code that lets you play RTcmix over a network --with-fftw Use the FFTW3 library, instead of the builtin FFT code If you have more than one version of Perl or Python on your system, you can tell RTcmix which one to use by giving its path with the option, e.g.: --with-python=/usr/local/bin/python Give these options in any order, following the configure script name: ./configure --with-alsa --with-perl --with-python NOTE: If you're running a Mac OS X earlier than 10.3 and want to enable Python, see the instructions below. For additional configure options, run "./configure --help". Some of the standard GNU options are not yet enabled for RTcmix. 4. There are some special settings that you can make in the "site.conf" file, though most people will never need to do this. 5. Make the package. Be sure you're still in the top RTcmix directory and type: make 6. If the package builds without errors, install it: make install 7. Add the bin directory inside of the RTcmix directory to your $PATH. For example, if you're using the bash shell, put something like this in .profile: PATH="/path/to/rtcmix/bin:$PATH" export PATH 8. Try running some of the scores in docs/sample_scores. To run any score, type "CMIX < scorefile.sco". If these seem to work, your installation is probably ok. See the README files in the docs dir for information on recent features. For some help getting started, check out the documentation and tutorials at rtcmix.org. -------------------------------------------------------------------------------- Platform Notes Linux ----- Mac OS X -------- - You must use OS X 10.1 or later, and you must have installed the appropriate version of the Developer Tools. - If you want to use gnuplot with the fplot and plottable script functions, you have to install both the command-line gnuplot from source and the Aquaterm program. First download the Aquaterm v1.0.b2 (or later) binary package (.dmg) from http://aquaterm.sourceforge.net, and install the package. (This must be done before compiling gnuplot, or else gnuplot will not be set up to use Aquaterm.) Then download the gnuplot source code for version 4.0 or later from ftp.gnuplot.info (gnuplot-4.0.0.tar.gz), and unpack this in /usr/local/src. Build the package like this: ./configure --without-x make sudo make install You'll probably have to add /usr/local/bin to your shell path. For bash, do something like this in .profile: PATH=/usr/local/bin:${PATH} export PATH - If you want to enable the Python front end, and you are running a version of Mac OS X earlier than 10.3, you will have to build Python from source, because the Python supplied with the Developer Tools CD is incomplete. See the instructions in RTcmix/src/parser/python/NOTES. SGI Irix -------- - It's been a long time since any of us have compiled RTcmix on Irix, so who knows whether it will work or even build. Let us know what you find. -JGG, 8/1/04; rev. for v4, 6/17/05