Manpage of CC2Y4M
Section: User Manuals (1)
Updated: JUNE 2004
Return to Main Contents
cc2y4m - translates broken PAL signals to YUV4MPEG2
Some channels broadcast a tv signal which is not standards compliant. It
usually lacks sync pulses, gets inverted at random times and even may include
disinformation. Those signals can't be comfortably viewed on a normal
television set. The Brooktree 87(A) chip has a special mode in which it
doesn't get confused because of missing sync signals. This program enables this
mode, very much alike
and takes special measures to keep the image
stable and adjust for the inversion. The output of this program appears on
standard output in YUV4MPEG2 format, and can, for example, be fed to
Note that in some countries might have draconian laws which may require you to
get some kind of permission from the broadcaster before you may use this
program legally. Consult a lawyer if you are in doubt.
This program needs access to private registers of the Bt87(A) chip,
privileges are required.
The program will only print error messages (and debug information if requested
to do so with -D).
Want to see what the program does? This is the option you want to specify on
the commandline. An SDL window will be opened with the raw output of the
Bt87(A), position of the window can be changed in the source.
- -d DEVICE
Use DEVICE as the device special file of the bttv-card. Default is /dev/video0.
Enable interlaced output.
Enable catching <UP> and <DOWN> from the MPlayer window, to
be able to change channels on the fly.
- -c NUMBER
Tune to channel NUMBER. 0 is the first channel, 1 is the second channel, etc.
Don't read the configuration file at ~/.cc2y4m.
- -m 1|2
This option selects the locking mechanism. Mechanism 1 is the default and
the original one. If it doesn't work for you; try mechanism 2.
- -B NUMBER
Change the 'brightness' used by the PAL->YUV converter to NUMBER, default is 37.
- -C NUMBER
Change the 'contrast' used by the PAL->YUV converter to NUMBER, default is 37.
- -S NUMBER
Change the 'saturation' used by the PAL->YUV converter to NUMBER, default is 37.
# cabletv | mplayer -
for viewing the first channel defined in ~/.cc2y4m .
If you want to record the video
# cabletv | mencoder -o test.avi - -ovc lavc \
The configuration file of this program should be named ~/.cc2y4m .
For an explanation of the file format, look through cc2y4m.conf
in the source distribution of this program. If you adapted cc2y4m.conf
to suit your needs, you can copy it to ~/.cc2y4m, where it will
be found by
The latest version of
should be available at
For more bugs see the
file. (I am too lazy to maintain two seperate compies of LARGE databases that
should be identical) The subject of submitting patches for bugs is detailed in the
The version of
documented here is 0.0.11.
Rik Snel <email@example.com>, PAL color decoding routines written
and (C) by Ewald Snel. A complete list of contributors can be
found in the file
Thanks go out to TWISTI and FUX for making
and releasing the source, thereby providing me with valuable insights
into the working of their program. Further thanks to Ewald Snel for
his PAL color decoding routines (also from
- SEE ALSO
This document was created by
using the manual pages.
Time: 22:26:29 GMT, July 30, 2004