README - Version 1.3.9

---------------------------------------------------------------

!! WARNING NOTE !!

This program is intended for educational and research use only.
It might not be legal to decode and view an encrypted channel.
All use of this program is at your own risk!!

---------------------------------------------------------------


Homepage:
http://sector17.tvand.net/cabletv

Email:
twisti@fusion.at or cabletv@gmx.net



This is a cablecrypt decoder for linux supporting these chips:
Brooktree BT878
Brooktree BT879
Brooktree BT848A

The decoder has been tested on a Hauppauge WinTV-PCI (BT878).



CableTV has now MMX support, so you maybe need a MMX capable processor.
But I think with pre MMX processors, watching isn't much fun ;-)

You MUST have compiled kernel support for bttv cards or get the newest
bttv drivers from here: http://www.strusel007.de/linux/bttv/.  There is
only support for PAL, because we do not have NTSC here. So it's very hard
to implement this. Maybe we get some support.


To run the program you must be root, otherwise it bails out with an error.
This version has reported to work perfect with many cable operators all
across europe and around the world.



Files:

cabletv           ...  main program
v4l-conf          ...  configures the kernel driver
CableTV.ad        ...  X11 app-default

README            ...  obviously this one
Modeline.sample   ...  sample Modline for XServer (384x288 fullscreen mode)
                       You have to paste this to your /etc/X11/XF86Config or
                       /etc/X11/XF86Config-4.
cabletv.sample    ...  sample channel configuration (modify and copy it
                       to ~/.cabletv)
lircrc.sample     ...  sample config for lirc (copy it to ~/.lircrc)



Keys:

Up                scroll image up
Down              scroll image down
Right             scroll image to the right
Left              scroll image to the left
A                 toggle luma (best with off)
P                 invert polarity
C                 invert chroma
L                 lock image
F                 fullscreen
I                 show Frames/Second
V                 show CableTV version information
M                 hide / show mouse pointer
PageUp            next channel
PageDown          prev channel
Ctrl Up           tune channel up
Ctrl Down         tune channel down
Ctrl Right        fine tune channel up
Ctrl Left         fine tune channel down
Keypad +          volume up
Keypad -          volume down
Keypad Enter      mute volume
Escape            quit
F1                brightness -
F2                brightness +
F3                contrast   -
F4                contrast   +
F5                saturation -
F6                saturation +

T                 toggle undocumented test register. Please use with care!!!
                  It's maybe required to press twice for BT848A chips!
                  (again: you out there with a BT848A send me your experiences)

Mouse:

Button 1          channel list
Button 2          next channel (wheel on a wheelmouse)
Button 3          fullscreen
Button 4          next channel
Button 5          prev channel



Config file:
freq-tab = ntsc-bcast, ntsc-cable, ntsc-bcast-jp, ntsc-cable-jp, pal-europe,
           pal-europe-east, pal-italy, pal-newzealand, pal-australia,
           pal-ireland (but only pal tables make sense)
norm     = pal, ntsc, secam             (only pal supported yet)
source   = television                   (where else should you get your signal)



Description:

First scroll the image down and stop at a position where you can see exactly
one line of the vertical sync at the top of the image (maybe 2-4 lines, but
look at the counter).

Then move the image to left or right as slow as possible.  You have to look at
the titlebar to see how far you are away from the perfect locking position,
this is 0 (should count slowly from e.g. -60 upwards).

If the number in the console is between -2 and 2 (ideally 0) press L (locking).
Now the image should be locked.



Thanks to:
Ewald Snel and Ronny C, authors of ccd and ccrypt for Windows, for helping us.



Further notes:
There will never be a windows version of this software available, cause we are
not interested and there are enough good programs (look at the FreeTV sites).


by TWISTI & FUX (2002)
