1motv(1) General Commands Manual motv(1)
2
6 motv - a Motif program for watching TV
7
9 motv [ options ] [ station name ]
10
12 motv is a Motif application for watching TV with your unix box.
13 It is basically xawtv with a more userfriendly GUI. It has the same
15 features, uses the same config file, has the same command line
16 switches, you can control it using xawtv-remote. Most keyboards short‐
17 cuts are identical too.
18
20 All command line options also have a Resource, so you can put them into
21 your .Xdefaults file too.
22 -h, -help
24 Print a short description of all command line options.
25 -hwscan
27 Print a list of available devices.
28 -f, -fullscreen
30 startup in fullscreen mode.
31 Resource: motv.fullscreen (bool).
32 -n, -noconf
34 don't read the config file ($HOME/.xawtv).
35 Resource: motv.readconfig (bool).
36 -o, -outfile base
38 set basestring for the snapshot output files. The filename will
39 be "base-timestamp-nr.ext".
40 Resource: motv.basename (string).
41 -c, -device device
43 set video4linux device (default is /dev/video0). This option
44 also disables Xvideo support.
45 Resource: motv.device (string).
46 -D, -driver name
48 set video4linux driver (default is "libv4l"). This option also
49 disables Xvideo support.
50 Resource: motv.driver (string).
51 -C, -dspdev device
53 set audio device (default is /dev/dsp).
54 Resource: motv.dspdev (string).
55 -vbidev device
57 set vbi device (default is /dev/vbi0).
58 Resource: motv.vbidev (string).
59 -c, -xvport number
61 set Xvideo port (defaults to the first usable if Xvideo is
62 available). This option also enables Xvideo support.
63 Resource: motv.xvport (int).
64 -joydev device
66 joystick device to use for controlling xawtv.
67 Resource: xawtv.joydev (string).
68 -v, -debug level
70 Be verbose, level may be 0 (default), 1 or 2. It exists just
71 for debugging and trouble-shooting.
72 Resource: motv.debug (int).
73 -remote
75 X11 display is remote. This basically disables overlay mode,
76 you might need this if xawtv fails to autodetect a remote X11
77 display.
78 Resource: motv.remote (bool).
79 -b, -bpp n
81 force xawtv into n bpp color depth. Works for switching between
82 15/16 and 24/32 bpp. This gets just passed through to v4l-
83 conf(8).
84 Resource: motv.bpp (int).
85 -shift n
87 Shift the video display by n bytes. Try this if your video dis‐
88 play is'nt within the xawtv window, some older matrox cards show
89 this problem. This gets passed through to v4l-conf(8) too.
90 Resource: motv.shift (int).
91 -fb Use the framebuffer device to determine the video framebuffer
93 address (instead of the DGA extension). Yet another pass
94 through argument.
95 Resource: motv.fbdev (bool).
96 -xv/-noxv
98 enable/disable the usage of the Xvideo extension altogether,
99 i.e. -noxv has the same effect as both -noxv-video and -noxv-
100 image switches (see below).
101 Resource: xawtv.xv (bool).
102 -xv-video/-noxv-video
104 enable/disable the usage of the Xvideo extension for video over‐
105 lay (i.e. XvPutVideo). overlay mode uses this. default is on.
106 Resource: xawtv.xvVideo (bool).
107 -xv-image/-noxv-image
109 enable/disable the usage of the Xvideo extension for image scal‐
110 ing (i.e. XvPutImage). grabdisplay mode uses this. default is
111 on.
112 Resource: xawtv.xvImage (bool).
113 -vm/-novm
115 enable/disable the usage of the VidMode extension, default is
116 off. If there is a fullscreen video mode configured in the con‐
117 fig file, the vidmode extension will be enabled automatically.
118 Resource: motv.vidmode (bool).
119 -dga/-nodga
121 enable/disable the usage of the DGA extension, default is on.
122 Resource: motv.dga (bool).
123 -parallel n
125 use n compression threads (default: one).
126 Resource: xawtv.parallel (int).
127 The usual toolkit options like -geometry are supported too.
129
131 v4l video4linux - the linux video capture API.
132 v4l2 video4linux two - new, improved capture interface which fixes a
134 number of v4l design bugs.
135 bktr FreeBSD / OpenBSD driver for bt848/878 grabber cards.
137 Xvideo X11 Extension for video devices. Note that the Xvideo extension
139 does support overlay only, you can't capture images/movies if
140 the Xvideo extension is used. On the other hand this is the
141 only way to scaled video overlay (i.e. fullscreen without black
142 borders @ 1024x748) if both hardware and xfree86 driver support
143 it. See README.xfree4 for more details and hints on how to set‐
144 up Xvideo.
145
147 motv starts up with the TV window. The left mouse button shows a menu
148 with all TV Stations (empty until you have defined some). The right
149 mouse button brings up the control window.
150 The first time you have configure motv, i.e. set TV norm and frequency
152 table to the correct values. Check if the hardware works correctly (if
153 tuning does not work it is very likely a driver configuration issue).
154 If the hardware operates fine, you can let motv look for TV stations
155 (Options => Channel scan). The channel buttons have a context menu for
156 deleting and editing. Don't forget to save your configuration when you
157 are done.
158 You can also create/edit a config file with any text editor, see
160 xawtvrc(5) for a description of the config file syntax. There are a
161 number of config options which can only be set by editing the config
162 file.
163
165 Some of them work in the TV window only. The cursor keys for example
166 are used by the motif toolkit to allow full keyboard control of the GUI
167 and therefore have other functions in the control window.
168 V Video (Capture) on/off
170 A Audio on/off
171 F Fullscreen on/off
172 G Grab picture (full size, ppm)
173 J Grab picture (full size, jpeg)
174 Ctrl+G Grab picture (window size, ppm)
175 Ctrl+J Grab picture (window size, jpeg)
176 Ctrl+C Copy to clipboard.
177 C Popup Control Window
178 R Popup AVI Recording Window
179 S Popup Scale controls
180 Z Channel Hopper (zapping, tune in every
181 station a few seconds)
182 Ctrl+Z Fast Channel Hopping (grab the images for the
183 Channel Bottons)
184 up/down tune up/down one channel
186 left/right fine tuning
187 pgup/pgdown station up/down (the ones you have in the config file)
188 space next station (same as pgup)
189 backspace previously tuned station
190 Ctrl+up scan for next station
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 motv 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
205 xawtvrc(5), xawtv(1), fbtv(1), v4l-conf(8), mtt(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 Huh? Still with me? Looks like some people do read manuals carefully.
230 (c) 1997-2001 Gerd Knorr motv(1)