xreadvcd version 0.4
~~~~~~~~~~~~~~~~~~~~

What is xreadvcd (xreadcdi) ?
-----------------------------
It's a program that reads the MPEG streams from VideoCD and CD-i (video)
discs. It uses the special ioctl call CDROMREADRAW that has to be compiled
into Linux kernel. Now it works with 2.x.x kernels with IDE CD-ROM drives.
SCSI should work too, but I couldn't try it...

This is a graphical version of readvcd for X. It uses Xforms libraries.
It should work similar as ncurses version, but it may eat more CPU.

Several people had successfully tested the previous versions and played
the MPEGs. It works well with Tristan Savatier's MpegTV.


Instalation:
------------
In two steps.

1. kernel patch 

->  IDE (in 2.1.18+ it's already done)

   You must add the CDROMREADRAW ioctl into kernel. And recompile it.
   Look at the file IDE-patch for changes in the file ide-cd.c and
   try to make them in your kernel.

-> SCSI (in 2.1.34+ it's done)

   Similar changes have to be done in sr_ioctl.c, newer kernels divide
   ioctl calls into two sections: sr_dev_ioctl and sr_audio_ioctl.
   You should make changes in the same section, where you find
   CDROMREADMODE1 and CDROMREADMODE2 (in 2.0.X kernels it's sr_ioctl) 

2. xreadvcd
 
   Run make. You need Xforms libraries version 0.81+


Usage:
------
The program sends the MPEGs to stdout so it's more than likely that you
will pipe it to some MPEG player or to the file.

It should find and play the MPEG stream. If you turn on the verbose mode
it will also display TOC informations.

In this version you can skip to the next/previous track, move forward
and backward. This operations are available over the area, specified
via command-line options.

You can chose which track(s) should be played. Usually the 1st track holds
some kind of info and copyright informations. The 2nd (and following)
are the MPEG streams to be played. You can also start with any sector
of the disk with -a option. It's useful when you want to continue after
the interruption. You only have to know the latest MSF address.
 
Options:
--------
	-v	 	verbose mode
        -a M:S.F	address of the starting sector in MSF format

        track		plays from this track to the end
        track-track	plays the area of the tracks

Examples:
---------
   xreadvcd | mtv -

The usual syntax. It'll start to play from the beginning.

   xreadvcd -v -a 00:50.00 | mtvp -

It will turn on verbose mode and it will read from sector 00:50.00 and pipe
data into mtvp (without gui). 

   xreadvcd 2-2 > track2.mpg

It should write data from track 2 into file.

   xreadvcd -v 3 | mtv -e -

It will display TOC info and play from the 3rd track to the end.
 
License:
--------
This program is free. You are using it at you own risk. You can use it for
your personal use only. It can be redistributed only in the original form.


Author:
-------
	Ales Makarov
	xmakarov@sun.felk.cvut.cz

Official site:
--------------
	ftp://mca.sh.cvut.cz/pub/readvcd/