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 -D, -driver name
44 set video4linux driver (default is "libv4l"). This option also
45 disables Xvideo support.
46 Resource: xawtv.driver (string).
47 -C, -dspdev device
49 set audio device (default is /dev/dsp).
50 Resource: xawtv.dspdev (string).
51 -vbidev device
53 set vbi device (default is /dev/vbi0).
54 Resource: xawtv.vbidev (string).
55 -c, -xvport number
57 set Xvideo port (defaults to the first usable if Xvideo is
58 available). This option also enables Xvideo support.
59 Resource: xawtv.xvport (int).
60 -joydev device
62 joystick device to use for controlling xawtv.
63 Resource: xawtv.joydev (string).
64 -v, -debug level
66 Be verbose, level may be 0 (default), 1 or 2. It exists just
67 for debugging and trouble-shooting.
68 Resource: xawtv.debug (int).
69 -remote
71 X11 display is remote. This basically disables overlay mode,
72 you might need this if xawtv fails to autodetect a remote X11
73 display.
74 Resource: xawtv.remote (bool).
75 -b, -bpp n
77 force xawtv into n bpp color depth. Works for switching between
78 15/16 and 24/32 bpp. This gets just passed through to v4l-
79 conf(8).
80 Resource: xawtv.bpp (int).
81 -shift n
83 Shift the video display by n bytes. Try this if your video dis‐
84 play isn't within the xawtv window, some older matrox cards show
85 this problem. This gets passed through to v4l-conf(8) too.
86 Resource: xawtv.shift (int).
87 -fb Use the framebuffer device to determine the video framebuffer
89 address (instead of the DGA extension). Yet another pass
90 through argument.
91 Resource: xawtv.fbdev (bool).
92 -xv/-noxv
94 enable/disable the usage of the Xvideo extension altogether,
95 i.e. -noxv has the same effect as both -noxv-video and -noxv-
96 image switches (see below).
97 Resource: xawtv.xv (bool).
98 -xv-video/-noxv-video
100 enable/disable the usage of the Xvideo extension for video over‐
101 lay (i.e. XvPutVideo). overlay mode uses this. default is on.
102 Resource: xawtv.xvVideo (bool).
103 -xv-image/-noxv-image
105 enable/disable the usage of the Xvideo extension for image scal‐
106 ing (i.e. XvPutImage). grabdisplay mode uses this. default is
107 on.
108 Resource: xawtv.xvImage (bool).
109 -vm/-novm
111 enable/disable the usage of the VidMode extension, default is
112 off. If there is a fullscreen video mode configured in the con‐
113 fig file, the vidmode extension will be enabled automatically.
114 Resource: xawtv.vidmode (bool).
115 -dga/-nodga
117 enable/disable the usage of the DGA extension, default is on.
118 Resource: xawtv.dga (bool).
119 -parallel n
121 use n compression threads (default: one).
122 Resource: xawtv.parallel (int).
123 The usual toolkit options like -geometry are supported too.
125
127 v4l2 video4linux two - modern standard linux video capture API
128 libv4l work through the libv4l library, which provides an additional
130 thin layer on top of video4linux2 devices for support of more
131 wide range of devices' pixel formats (often required for webcams
132 etc.) It is default for Xawtv on Linux systems.
133 bktr FreeBSD / OpenBSD driver for bt848/878 grabber cards.
135 Xvideo X11 Extension for video devices. Note that the Xvideo extension
137 does support overlay only, you can't capture images/movies if
138 the Xvideo extension is used. On the other hand this is the
139 only way to scaled video overlay (i.e. fullscreen without black
140 borders @ 1024x748) if both hardware and xfree86 driver support
141 it. See README.xfree4 for more details and hints on how to set‐
142 up Xvideo.
143
145 Just start xawtv. Then verify the settings in the options menu (right
146 mouse button) and adjust the settings (TV norm, Video source, frequency
147 table). With the cursor keys you can control the tuner and look for TV
148 Stations. Other useful hotkeys are listed below.
149 The hotkey 'E' will show the channel editor where you can create/edit
151 entries your TV stations. Don't forget to click on "save" to write a
152 config file. You can also create/edit a config file with any text edi‐
153 tor, see xawtvrc(5) for a description of the config file syntax. There
154 are a number of config options which can only be set by editing the
155 config file.
156 You can also check out scantv. That's a command line tool which will
158 perform a channel scan and write out a xawtv config file with all chan‐
159 nels it has found.
160 Mouse functions
162 The left mouse button will popup a menu with all TV stations found in
163 the config file. The middle button switches to the next station. The
164 right button brings up a window with a lot of options and control func‐
165 tions.
166 Keyboard Shortcuts
168 V Video (Capture) on/off
169 A Audio on/off
170 F Fullscreen on/off
171 G Grab picture (full size, ppm)
172 J Grab picture (full size, jpeg)
173 Ctrl+G Grab picture (window size, ppm)
174 Ctrl+J Grab picture (window size, jpeg)
175 O Popup Options Window
176 C Popup Channels Window
177 E Popup Channel Editor
178 R Popup AVI Recording Window
179 Z Channel Hopper (zapping, tune in every
180 station a few seconds)
181 Ctrl+Z Fast Channel Hopping (grab the images for the
182 Channel Buttons)
183 up/down tune up/down one channel
185 left/right fine tuning
186 pgup/pgdown station up/down (the ones you have in the config file)
187 space next station (same as pgup)
188 backspace previously tuned station
189 Ctrl+up scan for next station
190 F5-F12 adjust bright/hue/contrast/color
191 ESC,Q Quit
193 +/- Volume up/down (keypad)
195 Enter mute (keypad)
196
198 Bug reports with images attached go to /dev/null unseen.
199 xawtv depends on a correct driver configuration. If you can't tune TV
201 stations even if the settings in the options window are correct it is
202 very likely a driver issue.
203 The mono/stereo display is not reliable due to v4l API restrictions.
205 The API can not report back the current audio mode, but a list of the
206 currently available modes. xawtv just does a guess based on that,
207 assuming the driver uses the best available mode. Depending on your
208 hardware this might not be true. If in doubt whenever stereo really
209 works, please tune in MTV and listen, don't trust what xawtv says.
210
212 xawtvrc(5), fbtv(1), v4l-conf(8), scantv(1)
213 http://bytesex.org/xawtv/ (homepage)
214
216 Gerd Knorr <kraxel@bytesex.org>
217
219 Copyright (C) 1997-2001 Gerd Knorr <kraxel@bytesex.org>
220 This program is free software; you can redistribute it and/or modify it
222 under the terms of the GNU General Public License as published by the
223 Free Software Foundation; either version 2 of the License, or (at your
224 option) any later version.
225 This program is distributed in the hope that it will be useful, but
227 WITHOUT ANY WARRANTY; without even the implied warranty of MER‐
228 CHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General
229 Public License for more details.
230 You should have received a copy of the GNU General Public License along
232 with this program; if not, write to the Free Software Foundation, Inc.,
233 675 Mass Ave, Cambridge, MA 02139, USA.
234
236 You are the 4711th visitor of this page.
237 (c) 1997-2001 Gerd Knorr xawtv(1)