===================
TeleCaster now only works on GNU/Linux systems. The installer and the following instructions
-are based on Debian like software management so that it should work on Debian (>= Squeeze)
+are based on Debian like software management so that it should work on Debian (>= Lenny)
or Ubuntu / Kubuntu (>= 10.4). So please install one of these OS before.
Needed::
-$ sudo aptitude update
+ sudo aptitude update
-$ sudo aptitude install python python-dev python-xml python-libxml2 python-setuptools python-twitter python-liblo python-mutagen \
+ sudo aptitude install python python-dev python-xml python-libxml2 python-setuptools python-twitter python-liblo python-mutagen \
icecast2 apache2 apache2-suexec jackd libjack-dev vorbis-tools procps meterbridge fluxbox \
vnc4server vncviewer swh-plugins jack-rack libshout3 libshout3-dev libmad0-dev libogg-dev g++
-On Debian Squeeze or recent Ubuntu, change libjack-dev to libjack-jackd2-dev
+Warning: on Debian Squeeze or recent Ubuntu, change libjack-dev to libjack-jackd2-dev
Optional::
-$ sudo aptitude install libfaac-dev libmp3lame-dev libflac-dev
+ sudo aptitude install libfaac-dev libmp3lame-dev libflac-dev
3. Install TeleCaster
=====================
-$ cd telecaster-0.4.0/
-
-$ sudo python install.py
+Run the install script::
+
+ cd telecaster-0.4.4/
+ sudo python install.py
4. Configuration
Edit the following files to setup TeleCaster. Please be careful with the XML syntax::
-/etc/telecaster/telecaster.xml
+ /etc/telecaster/telecaster.xml
-and, if neeeded,
+and, ONLY if needed::
-/etc/default/jackd
-/etc/default/vncserver
+ /etc/default/jackd
+ /etc/default/vncserver
5. Start audio deamons
======================
-$ sudo /etc/init.d/jackd start
-$ sudo /etc/init.d/vncserver start
+Just reboot your machine or start them manually::
+
+ sudo /etc/init.d/jackd start
+ sudo /etc/init.d/vncserver start
6. Configure Apache2
====================
-Configure your apache VirtualHost editing /etc/apache2/sites-available/telecaster.conf
+Configure your apache VirtualHost editing /etc/apache2/sites-available/telecaster.conf
+
+Enable the VirtualHost::
+
+ sudo a2ensite telecaster.conf
+
+Maybe remove the default VirtualHost::
+
+ sudo rm /etc/apache2/sites-enabled/000-default
Reload Apache::
-$ sudo /etc/init.d/apache2 reload
+ sudo /etc/init.d/apache2 reload
7. Usage
========
-Browse the TeleCaster web control page::
+Browse the TeleCaster web control page:
-http://localhost/telecaster/telecaster.py
+ http://localhost/telecaster/telecaster.py
Fill in the form and start any free recording and broadcasting stream !
8. Contact
==========
-Any questions, suggestions ? Please contact the main developer :
-
-Guillaume Pellerin <yomguy@parisson.com>
+Any questions, suggestions ? Please post a ticket on the dev platform:
+
+ http://svn.parisson.org/telecaster
+or contact the main developer:
+ Guillaume Pellerin <yomguy@parisson.com>