1xawtv(1) General Commands Manual xawtv(1)
2
6 xawtv - a X11 program for watching TV
7
9 xawtv [ options ] [ station name ]
10
12 xawtv is a X11 application for watching TV with your unix box. It uses
13 the Athena widgets.
14
16 All command line options also have a Resource, so you can put them into
17 your .Xdefaults file too.
18 -h, -help
20 Print a short description of all command line options.
21 -hwscan
23 Print a list of available devices.
24 -f, -fullscreen
26 startup in fullscreen mode.
27 Resource: xawtv.fullscreen (bool).
28 -n, -noconf
30 don't read the config file ($HOME/.xawtv).
31 Resource: xawtv.readconfig (bool).
32 -o, -outfile base
34 set basestring for the snapshot output files. The filename will
35 be "base-timestamp-nr.ext".
36 Resource: xawtv.basename (string).
37 -c, -device device
39 set video4linux device (default is /dev/video0). This option
40 also disables Xvideo support.
41 Resource: xawtv.device (string).
42 -C, -dspdev device
44 set audio device (default is /dev/dsp).
45 Resource: xawtv.dspdev (string).
46 -vbidev device
48 set vbi device (default is /dev/vbi).
49 Resource: xawtv.vbidev (string).
50 -c, -xvport number
52 set Xvideo port (defaults to the first usable if Xvideo is
53 available). This option also enables Xvideo support.
54 Resource: xawtv.xvport (int).
55 -joydev device
57 joystick device to use for controlling xawtv.
58 Resource: xawtv.joydev (string).
59 -v, -debug level
61 Be verbose, level may be 0 (default), 1 or 2. It exists just
62 for debugging and trouble-shooting.
63 Resource: xawtv.debug (int).
64 -remote
66 X11 display is remote. This basically disables overlay mode,
67 you might need this if xawtv failes to autodetect a remote X11
68 display.
69 Resource: xawtv.remote (bool).
70 -b, -bpp n
72 force xawtv into n bpp color depth. Works for switching between
73 15/16 and 24/32 bpp. This gets just passed through to v4l-
74 conf(8).
75 Resource: xawtv.bpp (int).
76 -shift n
78 Shift the video display by n bytes. Try this if your video dis‐
79 play isn't within the xawtv window, some older matrox cards show
80 this problem. This gets passed through to v4l-conf(8) too.
81 Resource: xawtv.shift (int).
82 -fb Use the framebuffer device to determine the video framebuffer
84 address (instead of the DGA extension). Yet another pass
85 through argument.
86 Resource: xawtv.fbdev (bool).
87 -xv/-noxv
89 enable/disable the usage of the Xvideo extension altogether,
90 i.e. -noxv has the same effect as both -noxv-video and -noxv-
91 image switches (see below).
92 Resource: xawtv.xv (bool).
93 -xv-video/-noxv-video
95 enable/disable the usage of the Xvideo extension for video over‐
96 lay (i.e. XvPutVideo). overlay mode uses this. default is on.
97 Resource: xawtv.xvVideo (bool).
98 -xv-image/-noxv-image
100 enable/disable the usage of the Xvideo extension for image scal‐
101 ing (i.e. XvPutImage). grabdisplay mode uses this. default is
102 on.
103 Resource: xawtv.xvImage (bool).
104 -vm/-novm
106 enable/disable the usage of the VidMode extension, default is
107 off. If there is a fullscreen video mode configured in the con‐
108 fig file, the vidmode extension will be enabled automatically.
109 Resource: xawtv.vidmode (bool).
110 -dga/-nodga
112 enable/disable the usage of the DGA extension, default is on.
113 Resource: xawtv.dga (bool).
114 -parallel n
116 use n compression threads (default: one).
117 Resource: xawtv.parallel (int).
118 The usual toolkit options like -geometry are supported too.
120
122 v4l video4linux - the linux video capture API.
123 v4l2 video4linux two - new, improved capture interface which fixes a
125 number of v4l design bugs.
126 bktr FreeBSD / OpenBSD driver for bt848/878 grabber cards.
128 Xvideo X11 Extension for video devices. Note that the Xvideo extension
130 does support overlay only, you can't capture images/movies if
131 the Xvideo extension is used. On the other hand this is the
132 only way to scaled video overlay (i.e. fullscreen without black
133 borders @ 1024x748) if both hardware and xfree86 driver support
134 it. See README.xfree4 for more details and hints on how to set‐
135 up Xvideo.
136
138 Just start xawtv. Then verify the settings in the options menu (right
139 mouse button) and adjust the settings (TV norm, Video source, freqency
140 table). With the cursor keys you can control the tuner and look for TV
141 Stations. Other useful hotkeys are listed below.
142 The hotkey 'E' will show the channel editor where you can create/edit
144 entries your TV stations. Don't forget to click on "save" to write a
145 config file. You can also create/edit a config file with any text edi‐
146 tor, see xawtvrc(5) for a description of the config file syntax. There
147 are a number of config options which can only be set by editing the
148 config file.
149 You can also check out scantv. That's a command line tool which will
151 perform a channel scan and write out a xawtv config file with all chan‐
152 nels it has found.
153 Mouse functions
155 The left mouse button will popup a menu with all TV stations found in
156 the config file. The middle button switches to the next station. The
157 right button brings up a window with a lot of options and control func‐
158 tions.
159 Keyboard Shortcuts
161 V Video (Capture) on/off
162 A Audio on/off
163 F Fullscreen on/off
164 G Grab picture (full size, ppm)
165 J Grab picture (full size, jpeg)
166 Ctrl+G Grab picture (window size, ppm)
167 Ctrl+J Grab picture (window size, jpeg)
168 O Popup Options Window
169 C Popup Channels Window
170 E Popup Channel Editor
171 R Popup AVI Recording Window
172 Z Channel Hopper (zapping, tune in every
173 station a few seconds)
174 Ctrl+Z Fast Channel Hopping (grab the images for the
175 Channel Bottons)
176 up/down tune up/down one channel
178 left/right fine tuning
179 pgup/pgdown station up/down (the ones you have in the config file)
180 space next station (same as pgup)
181 backspace previously tuned station
182 Ctrl+up scan for next station
183 F5-F12 adjust bright/hue/contrast/color
184 ESC,Q Quit
186 +/- Volume up/down (keypad)
188 Enter mute (keypad)
189
191 Bug reports with images attached go to /dev/null unseen.
192 xawtv depends on a correct driver configuration. If you can't tune TV
194 stations even if the settings in the options window are correct it is
195 very likely a driver issue.
196 The mono/stereo display is not reliable due to v4l API restrictions.
198 The API can not report back the current audio mode, but a list of the
199 currently available modes. xawtv just does a guess based on that,
200 assuming the driver uses the best available mode. Depending on your
201 hardware this might not be true. If in doubt whenever stereo really
202 works, please tune in MTV and listen, don't trust what xawtv says.
203
205 xawtvrc(5), fbtv(1), v4l-conf(8), scantv(1)
206 http://bytesex.org/xawtv/ (homepage)
207
209 Gerd Knorr <kraxel@bytesex.org>
210
212 Copyright (C) 1997-2001 Gerd Knorr <kraxel@bytesex.org>
213 This program is free software; you can redistribute it and/or modify it
215 under the terms of the GNU General Public License as published by the
216 Free Software Foundation; either version 2 of the License, or (at your
217 option) any later version.
218 This program is distributed in the hope that it will be useful, but
220 WITHOUT ANY WARRANTY; without even the implied warranty of MER‐
221 CHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General
222 Public License for more details.
223 You should have received a copy of the GNU General Public License along
225 with this program; if not, write to the Free Software Foundation, Inc.,
226 675 Mass Ave, Cambridge, MA 02139, USA.
227
229 You are the 4711th visitor of this page.
230 (c) 1997-2001 Gerd Knorr xawtv(1)