1motv(1)                     General Commands Manual                    motv(1)
2
3
4

NAME

6       motv - a Motif program for watching TV
7

SYNOPSIS

9       motv [ options ] [ station name ]
10

DESCRIPTION

12       motv is a Motif application for watching TV with your unix box.
13
14       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

OPTIONS

20       All command line options also have a Resource, so you can put them into
21       your .Xdefaults file too.
22
23       -h, -help
24              Print a short description of all command line options.
25
26       -hwscan
27              Print a list of available devices.
28
29       -f, -fullscreen
30              startup in fullscreen mode.
31              Resource: motv.fullscreen (bool).
32
33       -n, -noconf
34              don't read the config file ($HOME/.xawtv).
35              Resource: motv.readconfig (bool).
36
37       -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
42       -c, -device device
43              set video4linux device (default is  /dev/video0).   This  option
44              also disables Xvideo support.
45              Resource: motv.device (string).
46
47       -D, -driver name
48              set  video4linux driver (default is "libv4l").  This option also
49              disables Xvideo support.
50              Resource: motv.driver (string).
51
52       -C, -dspdev device
53              set audio device (default is /dev/dsp).
54              Resource: motv.dspdev (string).
55
56       -vbidev device
57              set vbi device (default is /dev/vbi0).
58              Resource: motv.vbidev (string).
59
60       -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
65       -joydev device
66              joystick device to use for controlling xawtv.
67              Resource: xawtv.joydev (string).
68
69       -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
74       -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
80       -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
86       -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
92       -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
97       -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
103       -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
108       -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
114       -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
120       -dga/-nodga
121              enable/disable the usage of the DGA extension, default is on.
122              Resource: motv.dga (bool).
123
124       -parallel n
125              use n compression threads (default: one).
126              Resource: xawtv.parallel (int).
127
128       The usual toolkit options like -geometry are supported too.
129

SUPPORTED HARDWARE / INTERFACES

131       v4l    video4linux - the linux video capture API.
132
133       v4l2   video4linux  two - new, improved capture interface which fixes a
134              number of v4l design bugs.
135
136       bktr   FreeBSD / OpenBSD driver for bt848/878 grabber cards.
137
138       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

GETTING STARTED

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
151       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
159       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

KEYBOARD SHORTCUTS

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
169       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
185       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
192       ESC,Q        Quit
193
194       +/-          Volume up/down (keypad)
195       Enter        mute (keypad)
196

BUGS

198       Bug reports with images attached go to /dev/null unseen.
199
200       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

SEE ALSO

205       xawtvrc(5), xawtv(1), fbtv(1), v4l-conf(8), mtt(1)
206       http://bytesex.org/xawtv/ (homepage)
207

AUTHOR

209       Gerd Knorr <kraxel@bytesex.org>
210
212       Copyright (C) 1997-2001 Gerd Knorr <kraxel@bytesex.org>
213
214       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
219       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
224       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

MISC

229       Huh?  Still with me?  Looks like some people do read manuals carefully.
230
231
232
233                           (c) 1997-2001 Gerd Knorr                    motv(1)
Impressum