To get started type
-------------------

> ./autogen.sh 

in the main directory or if you don't want the programs that 
require x11 and gtk (tuxzap, tuxplayer and tuxview) type

> ./autogen.sh --without-x

After that type 

> make

and as root

> make install

If you get an error during autogen.sh you probably have forgotten to install
a library or most often the gtk-dev rpm.


TUXZAP
------
tuxzap is used to switch channels on a dvb card which is using the new
API developed by Nokia and Convergence. It uses gVideos .dvbrc file
for its DVB tree and has an improved system for managing favorite
lists. Right now we set the number of favorite list to 5, but you can
change this in interface.hh (NLIST). So in theory you can have a very
large number of favorite lists. 
The currently activated list is marked by the radio buttons in the
pull lists menu. The up/down buttons correspond to the channels in the
activated list. The "add to favorite" button in the tree widget also
corresponds to the activated list. The channel and favorite lists are
take form $HOME/.dvbrc and $HOME/.dvbfavX (X = 1,2,..). If you have
more than one card you can use the -d <dnb> option to set the device number
and if dnb != 0 the configuration is taken from .dvbrc.<dnb> (e.g
.dvbrc.1) and .dvbfavX.<dnm>.


NTUXZAP 
-------
Is the console version of tuxzap. It uses ncurses and the
"Curses Developement Kit" (CDK) libraries. You can get them at
http://www.gnu.org/software/ncurses/ncurses.html and
http://www.vexus.ca/CDK.html, respectively.
The option -e for ntuxzap and the use of the tuxbutton in tuxzap
switch on (or toggle) the usage of /dev/ost/dvr for output of the
program currently displayed. 


TUXVIEW
-------
tuxview can be used to watch any video4linux device, e.g. the v4l part
of the dvb driver. You can't switch channels with it. 


NTUXPLAYER
----------
uses the DVB API to playback video (not v4l via /dev/video), so that
it is possible to use a viewer ( like tuxview, xawtv, fbtv, etc ) and
playback an MPEG file at the same time.
Now, ntuxplayer can also playback TS with and without (-n) using the 
/dev/ost/dvr. See ntuxplayer -h for more information.


TUXPLAYER
---------
is the gtk version of ntuxplayer. It doesn't have the full functionality yet, 
so be patient. Unlike ntuxplayer, tuxplayer can also record from /dev/ost/dvr
with included conversion from TS to PES. Command line recording can be done by 
using cat /dev/ost/dvr > <file> when dvr is enabled in (n)tuxzap (see above).


RTUXZAP
-------
is a zapper that uses the lirc driver and libraries to implement a
simple remote control. It uses the same config files as ntuxzap and
tuxzap, but offers no editing funktion for the lists. It only switches
in the favorite lists. You should use a .lircrc with the additions
shown in the sample file in apps/lircrc.sample. Your lircd should
already be configured and running.


This separation of the task also allows you to use e.g. xawtv or any
other v4l programs as a viewer and tuxzap to switch channels. 



Any question should be send to Marcus Metzler <mocm@convergence.de>
