MP3 FreeRADIO Readme, v1.2
~~~~~~~~~~~~~~~~~~~~~~~~~~

A perl front end to mantain and play mp3 files for people who like to
pretend they are a radio station.

Files           Usage
-----           -------

Makefile   	- No idea
link-n-list     - Generates numeric symbolic links for your mp3s so you can
                  access them by a number
mp3radio        - Main script. Randomly plays mp3s and generates html and
                  .plan info for the world to see. Also will take song
		  requests.
mp3radio -nope  - Generates the $nope file for proper shutdown.
mp3radio.server - Allows people to telnet to a port and request songs by
                  number.
rc.mp3radio     - Config file for the above scripts.
id.mp3	        - Sample station ID


Using
-----

- I highly doubt this will work on anyone elses computer execpt mine.

- You'll need a command line mp3 player (amp or mpg123), the MP3Info perl
  module and rsynth for the 'say' command.

- Store your mp3s without stupid characters and with a _ instead of
  spaces and seperate the artist and song title with a -
  End the mp3 with the extension .mp3

  Examples:

  	minor_threat-salad_days.mp3
	16_volt-two_wires_thin.mp3
	beastie_boys-root_down_live_tfc_97.mp3
	bs2000-nobody_beats_bs2000.mp3
	dead_kennedys-terminal_preppie.mp3
	elektroblitz_mitte-alles_was_ich_brauche.mp3

- Edit the rc.mp3radio and the top of link-n-list. Run link-n-list
  it will symlink numerically your mp3s

  Example:

lrwxrwxrwx   1 root    33 Mar  6 14:10 1 -> .mp3/16_volt-cloth_like_gauze.mp3
lrwxrwxrwx   1 root    28 Mar  6 14:10 2 -> .mp3/16_volt-dead_weight.mp3
lrwxrwxrwx   1 root    46 Mar  6 14:10 3 -> .mp3/16_volt-dreams_that_rot_in_your_heart.mp3
lrwxrwxrwx   1 root    36 Mar  6 14:10 4 -> .mp3/16_volt-everyday_everything.mp3
lrwxrwxrwx   1 root    46 Mar  6 14:10 5 -> .mp3/16_volt-filthy_love_of_fire_filth_mix.mp3

	....

lrwxrwxrwx   1 root    35 Mar  6 14:10 1802 -> .mp3/xxx_atomic_toejam-im_a_cop.mp3
lrwxrwxrwx   1 root    41 Mar  6 14:10 1803 -> .mp3/yoda-get_get_static_extended_mix.mp3
lrwxrwxrwx   1 root    29 Mar  6 14:10 1804 -> .mp3/young_mc-bust_a_move.mp3
lrwxrwxrwx   1 root    62 Mar  6 14:10 1805 -> .mp3/zodiac_youth-fast_forward_the_future_hallucinogen_mix.mp3


  It will also create a html songlist and a .plan for the user list. 
  finger list and see your mp3 song list:


  Login: list                             Name: list
  Directory: /home/list                   Shell: /nonexistent
  Never logged in.
  No Mail.
  Plan:

  As of Sat Mar  6 14:11:38 CST 1999


  Song #   Artist                         Song title
  ------------------------------------------------------------------------------

  1      16 volt                          cloth like gauze
  2      16 volt                          dead weight
  3      16 volt                          dreams that rot in your heart
  4      16 volt                          everyday everything
  5      16 volt                          filthy love of fire filth mix
  6      16 volt                          happy pill

  ....

  1800   xorcist                          iron helix
  1801   xorcist                          stains
  1802   xxx atomic toejam                im a cop
  1803   yoda                             get get static extended mix
  1804   young mc                         bust a move
  1805   zodiac youth                     fast forward the future hallucinogen mix



  isn't it pretty?


- mp3radio will attempt to play a station ID (id.mp3) around the top of every 
  hour

- Next, edit the top of mp3radio.server. Set the paths and port to whatever
  you want. Run mp3radio.server is the background. telnet localhost <port>
  and see if it works. 

- Run mp3radio. It should play random mp3s, and when it sees a $usersel
  file, it will play that song next.

  It will also generate a log of all songs played, and will generate html
  and .plan outputs for the current playing song.

- Use mp3radio -nope to shut mp3radio down.

- I think thats it. I wish i knew perl gooder.