| xawtv(1) | General Commands Manual | xawtv(1) |
xawtv - a X11 program for watching TV
xawtv [ options ] [ station name ]
xawtv is a X11 application for watching TV with your unix box. It uses the Athena widgets.
All command line options also have a Resource, so you can put them into your .Xdefaults file too.
The usual toolkit options like -geometry are supported too.
Just start xawtv. Then verify the settings in the options menu (right mouse button) and adjust the settings (TV norm, Video source, frequency table). With the cursor keys you can control the tuner and look for TV Stations. Other useful hotkeys are listed below.
The hotkey 'E' will show the channel editor where you can create/edit entries your TV stations. Don't forget to click on "save" to write a config file. You can also create/edit a config file with any text editor, see xawtvrc(5) for a description of the config file syntax. There are a number of config options which can only be set by editing the config file.
You can also check out scantv. That's a command line tool which will perform a channel scan and write out a xawtv config file with all channels it has found.
The left mouse button will popup a menu with all TV stations found in the config file. The middle button switches to the next station. The right button brings up a window with a lot of options and control functions.
V Video (Capture) on/off A Audio on/off F Fullscreen on/off G Grab picture (full size, ppm) J Grab picture (full size, jpeg) Ctrl+G Grab picture (window size, ppm) Ctrl+J Grab picture (window size, jpeg) O Popup Options Window C Popup Channels Window E Popup Channel Editor R Popup AVI Recording Window Z Channel Hopper (zapping, tune in every station a few seconds) Ctrl+Z Fast Channel Hopping (grab the images for the Channel Buttons) up/down tune up/down one channel left/right fine tuning pgup/pgdown station up/down (the ones you have in the config file) space next station (same as pgup) backspace previously tuned station Ctrl+up scan for next station F5-F12 adjust bright/hue/contrast/color ESC,Q Quit +/- Volume up/down (keypad) Enter mute (keypad)
Bug reports with images attached go to /dev/null unseen.
xawtv depends on a correct driver configuration. If you can't tune TV stations even if the settings in the options window are correct it is very likely a driver issue.
The mono/stereo display is not reliable due to v4l API restrictions. The API can not report back the current audio mode, but a list of the currently available modes. xawtv just does a guess based on that, assuming the driver uses the best available mode. Depending on your hardware this might not be true. If in doubt whenever stereo really works, please tune in MTV and listen, don't trust what xawtv says.
xawtvrc(5), fbtv(1), v4l-conf(8), scantv(1)
http://bytesex.org/xawtv/ (homepage)
Gerd Knorr <kraxel@bytesex.org>
Copyright (C) 1997-2001 Gerd Knorr <kraxel@bytesex.org>
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., 675 Mass Ave, Cambridge, MA 02139, USA.
You are the 4711th visitor of this page.
| (c) 1997-2001 Gerd Knorr |