File	Date	Author	Commit
data	2011-02-01	Sam Thursfield	[ff0335] Merge ../calliope-stable
lib	2009-03-19	Sam Thursfield	[bcfed5] lib/gconf-property-editor: Add file chooser but...
po	2008-10-21	Sam Thursfield	[9d1b60] waf, despite its many faults, is preferable to ...
src	2011-03-14	Sam Thursfield	[e935d0] Update for new Iris
test-data	2008-12-29	Sam Thursfield	[77c12a] Add some real-world unit tests. Fix lots of pro...
tests	2011-01-20	Sam Thursfield	[efa84c] filesource: don't start import immediately, and...
win32	2010-06-14	Sam Thursfield	[f6d756] Merge some win32 changes
www	2010-06-14	Sam Thursfield	[f6d756] Merge some win32 changes
.gitignore	2011-02-23	Sam Thursfield	[58cac3] Merge branch 'master' of ssh://calliope.git.sou...
.gitmodules	2011-02-23	Sam Thursfield	[58cac3] Merge branch 'master' of ssh://calliope.git.sou...
AUTHORS	2008-01-22	Sam Thursfield	[795114] This is is first commit to sourceforge SVN. My ...
COPYING	2008-01-22	Sam Thursfield	[795114] This is is first commit to sourceforge SVN. My ...
COPYING.rtf	2009-01-24	Sam Thursfield	[83bb54] calliope.nsi: Add GPL to installer.
HACKING	2009-03-31	Sam Thursfield	[756d1f] General tidying up and tightening.
NEWS	2008-01-22	Sam Thursfield	[795114] This is is first commit to sourceforge SVN. My ...
README	2010-05-19	Sam Thursfield	[3682d9] Merge
README.win32	2010-06-14	Sam Thursfield	[f6d756] Merge some win32 changes
TODO	2011-02-23	Sam Thursfield	[58cac3] Merge branch 'master' of ssh://calliope.git.sou...
calliope.nsi	2010-06-14	Sam Thursfield	[f6d756] Merge some win32 changes
conftool	2009-04-12	Sam Thursfield	[4c8175] Calliope is now 100% warning free! (On Linux).
debug.h	2010-07-06	Sam Thursfield	[0b78fe] Many problems fixed in this commit
settings.conftool	2009-03-19	Sam Thursfield	[bcfed5] lib/gconf-property-editor: Add file chooser but...
waf	2011-01-29	Sam Thursfield	[dcf781] wscript: update to waf 1.6; fix Iris includes
wscript	2011-03-14	Sam Thursfield	[1339ba] wscript: don't build iris on 'clean'

Read Me

CALLIOPE MUSIC PLAYER

Dependencies:
	
	- Iris: http://git.dronelabs.com/iris/
          * This is a very young project so is currently distributed with
            Calliope. It will be removed once stable tarballs start being
            released.
Requires:  FIXME: versions?
GNOME I guess
sqlite3
gstreamer
etc.

Building:
	./waf configure
	./waf build

Testing:
	./waf check


Calliope used to use automake but now it uses waf, which is of course less mature
but much, much more concise!

A few files are autogenerated by the 'conftool' program which is written in
LISP. I have only tested it in CLISP but I'm pretty sure it is all ANSI.

conftool needs to be run sometime before waf, so the way I set up a
build is:

	./conftool  (or on win32, /c/tools/clisp/clisp conftool
	./waf configure --enable-debugging (or not)
	./waf build
	./waf install

If you are building from a tarball only the last 3 steps are necessary.


CD PLAYBACK: cdio/cdparanoia, libcdio, gst, etc. ..

SCROBBLER: file locking on scrobblerqueue - nfs may not work right !!

Windows: Windows 2000/NT4+

Libraries
-------------------------------


* For testing
DUMA: http://duma.sourceforge.net/


Source code directory structure
-------------------------------

* lib/
	This is for code that is probably stolen from other places and should really be some shared library.

* src/base
	Largely abstract base classes

* src/lib
	Code that is fairly generic and reuseable, but not actually of much use outside Calliope (where lib/ is for
	code that is useful for all sorts of apps.

* src/core
	Backend.

* src/ui
	Frontend.