# README

  March 02007

  Calliope 1.0

  Calliope is a music management system, jukebox and (with Icecast)
  a streaming music server.  It is open source under the GPL (see
  LICENSE). 

  Based on code from Otto 2.0 (Copyright (C) 02000, 02002 Jon Ferguson). 
  All changes Copyright (C) the authors, as listed in AUTHORS, as well
  as in individual modules. 

  My goal for this release is to provide a sound and extensible 
  relational database model for music, allowing for more complex 
  categorization of songs, artists, albums, genres, artist types,
  etc.  I've also included web-based administration, web-based
  editing, fine-grained multi-user permissions, multiple interfaces,
  "smart" randomization, "smart" categorization of artists, and more.

  My hope is that Calliope will provide a complete music management 
  system, allowing people to edit and maintain complex data relationships 
  via the web.

  Calliope is not intended as a file sharing system, you assume all 
  responsibility for how you choose to use this program. Calliope is a 
  system for sharing the management of music meta-data, and a web-based 
  jukebox allowing multiple users to play and listen to music.


  Calliope is free for personal use.  Please contact me at
  http://neil.verplank.org/contact.htm  if you're interested in 
  licensing calliope for commercial use.
  




######################################################################
# License
######################################################################


  This program is open source 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 1, or (at your option)
  version 2.

  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.

  See ~/LICENSE for more details.

  You should also have received a copy of the GNU General Public License
  along with this program in the file named "LICENSE". If not, write to the 
  Free Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 
  02111-1307, USA or visit their web page on the internet at
  http://www.gnu.org/copyleft/gpl.html.




######################################################################
# Installation
######################################################################

  Ideally, unpack the tarball in /usr/local.  Then create a symlink to 
  calliope (this has the advantadge of allowing an easy switch from
  one version to another).  Then run ./install inside the ~/installer
  directory:

	> cd /usr/local
      	> tar -zxvf calliope1.0alpha.tar.gz
	> ln -s calliope1.0alpha calliope
	> cd calliope/installer
	> ./install

  See the file named INSTALL for detailed installation instructions 
  and requirements.





######################################################################
# Admin
######################################################################

  There are a lot of notes on administering Calliope, and utilizing
  it's functionality effectively.  In addition to the "help" menu 
  in the web interface, see the following files:
  
    ~/INSTALL  		 - on both installation and administration
    ~/etc/conf 		 - internal notes on configuration options
    ~/lib/Artists/README - on using the corrections files to load and clean
    ~/tmpl/README        - on using templates and creating interfaces




######################################################################
# Development
######################################################################

  Notes on current development can be found in the dev folder of this
  installation, in the TODO, CHANGELOG and BUGS files.  There are some
  scripts in dev that may be useful to the developer for testing 
  purposes.




######################################################################
# Feedback
######################################################################

  I've put an insane amount of time into developing Calliope;  I hope
  you will find it useful.  If you have any ideas, suggestions, or
  wish to contribute to development, please contact me (below).

  Download a current copy from the dev home below, or from sourceforge:

    http://project.sourceforge.net/calliope/

  Also, take a look at ~/dev/TODO to get a sense of what's being planned
  before assailing me with new ideas ;-)


  Cheers,
  Neil Verplank


    http://neil.verplank.org/opensource/calliope/calliope-git/ - current development tree
    http://neil.verplank.org/opensource/calliope/              - calliope dev home
    http://neil.verplank.org/contact.htm                       - contact me
    http://neil.verplank.org/opensource/                       - all my open source SW
    http://neil.verplank.org/travel/                           - my peregrinations
    http://neil.verplank.org/finnegan/                         - pictures of my dog
    http://neil.verplank.org/furniture/                        - custom furniture and guitars
    http://neil.verplank.org/                                  - about me