brigit - README
===================

  Script(s) for the presentation and playing of media files over the web.

  Version 0.95 - 03 August 2002
  -----------------------------
  http://www.the42.net/brigit

    Copyright (C) 2002      PJ Goodwin <pj_at_the42.net>

    Copyrights on portions of the code held by others.  
                           [Check CREDITS file for additional information.

    This program is free software; you can redistribute it and/or modify
    it under the terms of the GNU General Public License as published by
    the Free Software Foundation; either version 2 of the License, or
    (at your option) any later version.

    This program is distributed in the hope that it will be useful,
    but WITHOUT ANY WARRANTY; without even the implied warranty of
    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
    GNU General Public License for more details.

    You should have received a copy of the GNU General Public License
    along with this program; if not, write to the Free Software
    Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA

  Requirements: 
    Web server able to run perl scripts.
    A web-browser and media files
    Media files organized in a directory structure similar to:
      /artist1/album1/song1
      /artist1/album1/song2
         ...
      /artist1/album4/song1
         ...
      /artist42/album2/song10
                
  Summary:
    brigit is intended to present media files for streaming over the web.
    Presentation of Artists and Album information is similar to phpmyadmin's
    listing of databases and tables.

    It is intended to be used for those who most regularly like to play a 
    complete album, or all albums for a particular artist.  In this mode, 
    Brigit does not require opening any new windows.

    I am attempting to make brigit so that it has as few dependencies as possible
    on the theory that it will be easier to get running that way.  Future version
    will no doubt have additional dependencies, but my current view is to always
    have a version like the existing one with almost no additional required modules.
  
  Brigit:
    The name brigit was taken from Celtic mythology.  Brigit (a.k.a Brighid, 
    Brid, Brigid, Bride) was a member of the Tuatha Dé Danann.  She was the 
    goddess of Healing, Fertility, Smith craft and Poetry.  Her symbol is the 
    White Swan.

    Besides the loose association between poetry and music, and the rumored 
    healing properties of music, there's not much other which would provide
    links between the goddess Brigit and this software.  There is a link, but
    perhaps it's just in my mind.

  Download:
    You can get the newest version at http://www.the42.net/brigit/.

  Credits:
    Please see the CREDITS file.
   
  Installation:
    Please see the INSTALL file.
  
  ChangeLog:
    Please see the ChangeLog file.
  
  Documentation:
    Fairly non-existent at the moment.
    Installation information is included in the distribution
    as INSTALL and additional documentation may (eventually) be available at

       http://www.the42.net/brigit/

  Support:
    You can try sending questions, issues, comments, suggestions, features
    requests, etc. regarding brigit to brigit(at)the42.net and I'll attempt
    to address them as time permits. 


Enjoy!
   pj