README

aatv is a simple program to watch TV in a text-based console.

Requirements

aalib, a great library that should come with every distribution. Get if from http://horac.ta.jcu.cz/aa.
A TV card in your computer and videodev1.

Installation

./configure
make
make install (as root)

configure options you might want to use:

 --help                                Show all available options.
 --prefix=<PREFIX>                     Install in <PREFIX>, e.g. /usr/local.
 --with-configfile=<FILE>              Choose the location of the configfile.
 --enable-debug=yes                    Enable debugging options.

See INSTALL for details.

Using aatv:

If you just want to see what it does, and don't want to mess with frequencies just tune your TV card, with xawtv for example, and then launch aatv. When aatv starts, it keeps the frequency the card is tuned on. You may have to change the video mode to PAL or NTSC in the config file because aatv sets it to SECAM by default (it's the best standard).

In a Linux console, you should switch the font into a 8x8 one or smaller. Under X11, use -width and -height to specify the size of the window.

The main configuration file is stored in /etc or in /usr/local/etc by default. Each user can override the main configuration file by writing his own ~/.aatv configfile.

Keys

'q' : Quit the program.
'c' : Switch from TV to composite, or from composite to TV. 's' : Change video mode (PAL, SECAM, NTSC). 'v' : Flip image.
'b' : Show the frequency, you may then press enter or type a new value.

AA image controls:

'f' : Turn ON/OFF fast rendering.
'a' : No dithering.
'e' : Dithering mode 1.
'r' : Dithering mode 2.
'p' : Show the contrast value, you may then press enter or type a new value. 'm' : Decreases the contrast.
'!' : Increases the contrast.
'o', 'l', ':' : Do the same with brightness.

Tuner image controls:

'i', 'k', ';' : Contrast.
'u', 'j', ',' : Brightness.
'y', 'h', 'n' : Whiteness.

Presets

'0' to '9' : See config file.

License

This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program; if not, write to the Free Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA

See COPYING for details.

Greetings

The idea was from Frederic Jouault <frederic@jouault.com>. You can browse his project page at 'http://dba.ticalc.org' since it doesn't only talk about TI92 calculators.

A big thank to Uwe Hermann <uh1763@hermann-uwe.de> who wrote the manpage, autoconfiscated the package, cleaned up everything, sent patches, built a Debian package...

I wrote this program mainly for fun. I hope at least you'll have some using it. You can contact me at florent@lamotte.as.