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.
(http://ico.music.vt.edu/). You can also try to
use this direct link:
http://ico.music.vt.edu/Linux/RTMix/rtmix-0.75.tar.gz (software)
http://ico.music.vt.edu/Linux/RTMix/RTMix-sounds.zip (sounds associated with the Simon demo included in the software)
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).
As the RPM and SRPM package for the Mandrake 9.1 avaialble at the Thac's RPM's page (http://rpm.nyvalls.se/sound9.1.html). It is also accessible via nifty Mandrake's urpmi toool. See the aforementioned site for more info how to setup your machine to retrieve rtmix via urpmi.
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) Make sure that there are no leftover binaries, .moc files, and other compiled objects by doing:
make distclean
IMPORTANT: if you encounter any errors at this point, simply disregard them -- they simply mean that the source tree is already clean.
4) Configure the makefiles by doing:
./configure
5) If everything went well you should now have makefiles ready, so type:
make
6) 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 "5", it will fail because you do not have permissions to write to the destination directories.
7) 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. Simply use your Linux 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 on your install cd's or 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 | >>