README for Adaptive Radio REQUIRED PACKAGES ================= The following Debian packages should be installed before Adaptive Radio can be used. If you are using some distribution besides Debian, then install the equivalent packages. - libperl-dev - libxml2-dev - apache - libhtml-embperl-perl - id3ren - libmp3-info-perl Optional: - mp3info ICECAST ======= Download, compile and install the source for icecast and ices. I have tested Adaptive Radio with icecast-1.3.12 and ices-0.2.3. It may work with newer versions, but I won't make any guarantees. After running './configure; make install' for both ices and icecast, all the required files should be installed to /usr/local/icecast. INSTALL ADAPTIVE RADIO ====================== Now you are ready to install Adaptive Radio. Simply run ./install from this directory. The default locations should work for Debian. Once this install script is complete, use 'adr-useradd username' to add users. Run adr-start to start Adaptive Radio and adr-stop to stop it. The adaptive radio web page should be accessible from http://localhost/ or any other addresses that point to the machine. The default web interface is designed to occupy little space on your desktop. There is an alternative web interface suitable for kiosks and demos available at http://localhost/cgi-bin/party.cgi. This full- screen interface has larger fonts and shows the names of all users, whether they are logged in or not. It also allows the user to create new Adaptive Radio users. MEDIA ===== Be sure to add mp3s to your media directory (default is /home/media). Adaptive Radio also requires that the mp3s have ID3 tag info. You can use mp3info to add ID3 tags if your mp3s don't have them. After adding new mp3s, you must run adr-update, or you can use 'adr-submit filenames' to copy mp3s from another location and add them to the playlist. mp3s should have valid artist and album tags because these are used by Adaptive Radio to determine which songs (not) to play. UNINSTALLING ADAPTIVE RADIO =========================== To uninstall Adaptive Radio, run ./uninstall. CONTACT ======= Send questions to Justin Balthrop (judd@cs.unm.edu) or Dennis Chao (dlchao@cs.unm.edu). If warranted, a FAQ will be maintained on http://www.cs.unm.edu/~immsec, so please check there before sending mail.