RTcmix Download and Installation

Getting RTcmix is so easy! There are currently three so easy! ways to download and install RTcmix:

---

1. Do It All At Once

    click here to download the entire RTcmix distribution, all packages included (v 3.6 -- 3/21/2004, 1.1 Mbytes/99 Mbytes installed).
• If the download procedure doesn't automatically unpack the RTcmix.tar.gz file into an "RTcmix/" directory, say:

  gunzip RTcmix.tar.gz
  tar -xvf RTcmix.tar
  

  in the directory where the RTcmix.tar.gz file is located.
  
  
  
• Move this "RTcmix/" directory to the location where you would like it installed (we recommend "/usr/local/src/RTcmix").
  
  
  
• In this "RTcmix/" directory, edit the file "makefile.conf". Where it says:

  # The directory containing the RTcmix directory
  TOPDIR = /usr/local/src
  

  change it to the directory you chose for RTcmix (again, we recommend you leave it at "/usr/local/src").

  Where it says:

  # Which platform?
  #ARCH = LINUX
  ARCH = MACOSX
  #ARCH = SGI
  #ARCH = FREEBSD
  

  comment (add a "#") and uncomment (remove the "#") to reflect your OS (the above is set up to compile on MacOS X).
  
  
  
• Save your changes to this "makefile.conf", and then type (in that same "RTcmix/" directory):

  make; make install
  

  RTcmix should compile, install, and off you go!

---

2. Do It With Individual Packages

    click here to download just the base RTcmix distribution (v 3.6 -- 3/21/2004, 0.6 Mbytes/19.3 Mbytes installed).
• If the download procedure doesn't automatically unpack the RTcmix-core.tar.gz file into an "RTcmix/" directory, say:

  gunzip RTcmix-core.tar.gz
  tar -xvf RTcmix-core.tar
  

  in the directory where the RTcmix-core.tar.gz file is located.
  
  
  
• Move this "RTcmix/" directory to the location where you would like it installed (we recommend "/usr/local/src/RTcmix").
  
  
  
• In this "RTcmix/" directory, edit the file "makefile.conf". Where it says:

  # The directory containing the RTcmix directory
  TOPDIR = /usr/local/src
  

  change it to the directory you chose for RTcmix (again, we recommend you leave it at "/usr/local/src").

  Where it says:

  # Which platform?
  #ARCH = LINUX
  ARCH = MACOSX
  #ARCH = SGI
  #ARCH = FREEBSD
  

  comment (add a "#") and uncomment (remove the "#") to reflect your OS (the above is set up to compile on MacOS X).
  
  
  
• At this point, you have a basic RTcmix with all functions and objects for development ready-to-go, but only two instruments MIX and WAVETABLE are included. You can choose to add additional packages by downloading them and unpacking them in the "RTcmix/" directory; i.e. the "insts.std/" unpacked directory should be in "RTcmix/insts.std/".

  Here are the additional packages you may want to include:

  • insts.std -- (3/21/2004, 0.25 Mbytes/13.7 Mbytes installed) -- listing
  • insts.jg -- (3/21/2004, 0.2 Mbytes/12.9 Mbytes installed) -- listing
  • insts.stk -- (3/21/2004, 0.06 Mbytes/14.3 Mbytes installed) -- listing
  • imbed -- (8/2003, 0.01 Mbytes/8.6 Mbytes installed) -- listing
  
  
  
  
• You will need to change the "makefile.conf" file to reflect tha packages or instrument-packages you have added. In the "makefile.conf" file, the lines:

  # add new instruments to this list (e.g., insts.std, insts.jg)
  INST_DIRS = insts.base insts.std insts.jg
  
  # add new packages to this list (e.g., interfaces.std)
  PACKAGE_DIRS = imbed
  

  should be altered to include or exclude the packages you downloaded above. [note: You will need to do this "makefile.conf" alteration and recompile (the next step) whenever you add a new package to your RTcmix distribution.]
  
  
  
• Save your changes to this "makefile.conf", and then type (in that same "RTcmix/" directory):

  make; make install
  

---

3. Get the Most Up-To-Date Version via CVS

    Contact Dave Topper to get CVS access to the RTcmix repository. You should probably know what you're doing for this option.



---

Note on the command path

All RTcmix executable commands, including the CMIX command, are placed in the "RTcmix/bin" directory. To access these commands, you can copy/move them to a directory like "/usr/local/bin" or "/usr/bin". These directories are probably already on your command search path. To see your command search path, type the command:

echo $path

or

echo $PATH

and you should see a listing of all directories that are searched for executable commands.

You can also simply add the "RTcmix/bin" directory to your command search path. You will probably need to edit or create a ".tcshrc: or ".cshrc" or equivalent shell initialization file to do this. An example of a line in a ".tcshrc" that accomplishes this is:

set path = ( ~/bin $path /usr/local/bin /usr/local/src/RTcmix/bin "." )

Once you do this, you will need to start a new Terminal or Shell window (or use the unix source command) to reflect the change you have made. See the documentation for "tcsh" or "csh" or "bash" for more information.

If all else fails, you can type the whole pathname as a prefix to the RTcmix executable command you want:

/usr/local/src/RTcmix/bin/CMIX
/usr/local/src/RTcmix/bin/sfprint somefile.aiff
/usr/local/src/RTcmix/bin/cpspch 8.07