oggradiotools 0.1:
-----------------------------
to install run:
python setup.py config
python setup.py install

re_codec supports three modes encoder, decoder, streamswitch
its possible to run more than one of the modes on one node at once.

configuration is saved in /etc/reboot.fm/re_codec.xml, 
you can change the location in re_codec.py if needed.

external dependencies:
------------------------------------
	ices2-kh26+[ http://www.xiph.org/~karl/ ]
		all parts that need ices2 are only running with the kh series tue to the
		jack plugin wich only works there. the latest version can be found 
		here http://www.xiph.org/~karl/
	jack [ http://jackit.sf.net ]
		is needed on encoder and decoder.
	jack-tools [ http://www.alphalink.com.au/ ]
		is needed for jack.plumbing,
	alsaplayer [ http://alsaplayer.org ]
		used on the decoder to playback the oggstream
		also uses ap-control from http://svn.reboot.fm/trunk/alsaplayer_control
	re_jackmixer [ http://svn.reboot.fm/trunk/re_jackmixer ]
		this is used for silence detection
		
python dependencies:
----------------------------------
		python-pyjack
		python-pdi
			for iCalender/vCalender support
		python-dateutil
		
		python-pyshout
		python-pyogg
		python-pyvorbis
		python-ogg2
			by recording2archive.py
			# svn co http://svn.xiph.org/trunk/ogg2/
			# svn co http://svn.xiph.org/trunk/ogg-python2/
		python-irclib
			for the IRC bots.

component overview:
--------------------------------
streamswitch.py
	switch between ogg streams or ogg files based on dates given
	in iCalendar/vCalendar format.

recording2archive.py
	called once a day to cut the hourly archive generated by ices2
	into junks that are closer to the shows scheduled in the
	iCalendar/vCalendar file.

statusmonitor.py
	interface for the studio with information about the upcomming and
	currently running show, status of the stream and the internet connection.

decoderbot.py,encoderbot.py
	IRC bots that gather some information about the host they are on,
	encoder or decoder and send changes to an IRC channel

reboot_replay_recut.py
	used to generate cutups of the archive. right now only used to do that 
	at the end of the project. could be used to replay the last day/week.

beta:
re_codec.cgi
	proviedes a webinterface to the configuration of all components
	depents on xmlprc_server.py to be running on the encoder/decoder/streamswitch

(not used by reboot.fm right now)
ical2oggcomment.py 
	converts metadata from iCalendar/vCalendar format into
	an oggcomment. output can be used to update metadata 
	of livestream in ices2 
	[ 
		- after updating the metadata file call killall -USR1 ices2 
		- resulted in artifacts in the stream during evaluation.
		  could be fixed in recent ices2-kh series.
	]

streamrecorder.py
	record the oggstream produced by streamswitch
	[ prooved not to be better than wget, archiving is done within ices2 now]

fallback.py
	basic fallback right now. loops some ogg files that
	are played if the main stream does not connect to the
	icecast server.
	[
		- for reboot.fm we used another instance of ices2 looping through a playlist
	]
