DJTool 1.0 20 Nov 1999 Donald King ================================= This software is Copyright (C) 1999 by Donald L. King. However, it may be distributed and modified freely, provided that my name remains attached to any programs or products derived from it. The following files are included with the program: README This file Makefile Simple Makefile to preprocess/install DJTool djtool.in The DJTool program itself (before preprocessing) shout.c.diff Patches to the IceCast/1.3.0 'shout' program dj-header.htt Output file header dj-footer.htt Output file footer dj-offline.htt Output file offline body cdnow.png CDNow logo (used in online body) server.png Sample logo for an IceCast server server.pls Sample .PLS for an IceCast server DJTool is designed to operate as a 'DJ' program on an IceCast server. It uses various bits of information left by the 'shout' program to construct an on-the-fly HTML playlist which is updated each time a new song begins to play. If you've ever seen Atul Varma's MusicTicker plugin for WinAmp, or an online playlist generated by it, you'll see some similarities in intent. Installation ------------ The first part of installation is simple enough: unpack the tarball, tinker with the Makefile, then do "make install". However, there's another step due to the required patch for shout; you must separately unpack the source for IceCast, apply the patch, compile it, then install it under whatever directory you set $(ICECAST_ROOT) to be in DJTool's Makefile. In addition, you need to customize the files $(ICECAST_HTML)/server.{png,pls} to your machine. Once that's done, you're ready to go. Usage ----- Add "djprogram $(ICECAST_ROOT)/bin/djtool" and "usedj 1" to $(ICECAST_ROOT)/etc/shout.conf, then run IceCast as usual. It's meant to be a no-brainer. To make things even nicer, you might want to write a pair of shell scripts to start and stop IceCast; the stop script can then overwrite the HTML file with a "Sorry, we're closed" message. Unfortunately, the DJ program itself is never told when IceCast is being shut down, so it can't handle that itself.