RTMix
<< | table
of contents | >>
2. Installation
The second chapter will provide you with a quick overview of how to obtain and install RTMix on your machine.
2.1 Obtaining RTMix
RTMix is currently available in following formats/locations:
Source code tarballs (tar.gz) on the author's homepage (University of Cincinnati, College-Conservatory of Music) (http://meowing.ccm.uc.edu/~ico/ -- click on the "enter" button by selecting either low-bandwidth "html" version or high-bandwidth "flash" version; then click on "cpu's" button in the bottom menu; then click on the RTMix download red link)
RPM and SRC RPM packages on the PLANET CCRMA (Stanford University) website (http://ccrma-www.stanford.edu/planetccrma/software/soundapps.html -- then look for the RTMix section)
As a part of the Turn-Key Linux audio package (Eastman College) (http://lulu.esm.rochester.edu/kevine/turnkey/docs.html), format unknown (most likely binary).
Since I am not sure how often the other two sources update their packages (although, from what I heard both of them are rather prompt about it), the safest assumption is that the most up-to-date version will be usually available on my own website (first option).
2.2 Requirements
In order to have RTMix up-and-running, you will need the following:
Linux OS (I think anything with kernels >=2.2.x should work -- I am using 2.4.x series for the development but RTMix does not directly depend on anything in kernels, so this most likely doesn't matter).
Qt >=3.x libraries (anything less than the version 3 will most likely not compile, and even if it does, may not function properly).
Standard development tools available (i.e. compilers, includes from the devel packages etc.).
2.3 Installation
Installation should be rather straightforward. Please use shell to do the following:
1) First you need to decompress the downloaded tarball by typing:
tar -zxvf rtmix-<version>.tar.gz
This will create a folder in the current location with the name "RTMix-<version>"
2) Go to the newly created folder by typing
cd RTMix-<version>
3) Configure the makefiles by doing:
./configure
4) If everything went well you should now have makefiles ready, so type:
make
5) After everything has been compiled, as a SUPERUSER (root) simply type:
make install
This will install all files into appropriate folders. If you are not a superuser and try to do the step "6", it will fail because you do not have permissions to write to the destination directories.
8) Now you are ready to start RTMix by typing:
rtmix
This should work from any location. You might even want to create a shortcut in the start-up menu of your favorite desktop environment (shortcut should be linked directly to the binary, i.e. "/usr/local/bin/rtmix").
2.4 Troubleshooting
Most problems will arise from the step "3". If such is the case, check the error. It will usually state that you are missing a particular library or a development tool. If such is the case, simply use your install cd's and install appropriate packages (i.e. if your configure script reports an error that you are missing -libjpeg, simply go look for a jpeg library online, one of possible sources would be http://rpmfind.net RPM repository). After installing the packages you can simply re-run the step "3".
Other issues might arise if you don't have the rtmix binary available. First check any build errors (this should not happen, but due to vastly varying Linux distributions, just about anything is possible), then go to the install directory, and make sure that your binary does not have a different name (i.e. go to /usr/local/bin/ directory and find rtmix there by typing:
ls *rtmix*
Sometimes the binary gets a funny name like i386-linux-rtmix (usually due to use of some flags at configure-time), in which case you need to rename it to "rtmix" by simply typing (as a SUPERUSER):
mv i386-linux-rtmix rtmix
That ought to do it.
If you encounter any other problems, the best thing is to simply contact me, or (even better) post the question on the RTMix forum (http://meowing.ccm.uc.edu/cgi-bin/ico/yabb/YaBB.cgi?board=Rtmix_id) -- this way your problem (and potentially its resolution) will be available for others to see and will help minimize redundant questions. Furthermore it will help generate a kind of an online RTMix FAQ.
<< | table of contents | >>