1xawtv-remote(1)             General Commands Manual            xawtv-remote(1)
2
3
4

NAME

6       xawtv-remote, v4lctl -- control video4linux devices
7

SYNOPSIS

9       xawtv-remote [ options ] command
10       v4lctl [ options ] command
11

DESCRIPTION

13       xawtv-remote  and v4lctl can be used to control a video4linux driven TV
14       card.  xawtv-remote passes the command to a already  running  xawtv  or
15       motv  instance  using  X11  properties.   v4lctl  sets  the  parameters
16       directly.
17

OPTIONS

19       xawtv-remote knows the following options:
20
21       -h     print a short help text
22
23       -d dpy Set the X11 display
24
25       -i id  Set the Window ID.
26
27       v4lctl understands these options:
28
29       -h     print a short help text
30
31       -c device
32              Set video4linux device.
33
34       -D driver
35              Set video4linux driver.
36
37       -v n   Set debug level to n, where n = [0..2]
38

COMMANDS

40       Both tools basically use the same set of commands.  Some  of  them  are
41       useful for xawtv-remote only (fullscreen for example).
42
43       setstation [ <name> | <nr> | next | prev | back ]
44              Set  the  TV  station.  This selects on of the TV stations which
45              are configured in the .xawtv config file.  The argument  can  be
46              the station name or a number (the first one listed in the config
47              file is 0, ...).  next/prev jumps to the  next/previous  station
48              in the list, back to the previously selected one.
49
50       setchannel [ <name> | next | prev ]
51              Tune in some channel.
52
53       setfreqtab <table>
54              Set  the  frequency  table.  See the menu in xawtv for a list of
55              valid choices.
56
57       setnorm <norm>
58              Set the TV norm (NTSC/PAL/SECAM).
59
60       setinput [ <input> | next ]
61              Set the video input (Television/Composite1/...)
62
63       capture [ on | off | overlay | grabdisplay ]
64              Set capture mode.
65
66       volume mute on | off
67              mute / unmute audio.
68
69       volume <arg>
70
71       color <arg>
72
73       hue <arg>
74
75       bright <arg>
76
77       contrast <arg>
78              Set the parameter to the specified value.  <arg> can be  one  of
79              the  following: A percent value ("70%" for example).  Some abso‐
80              lute value ("32768"), the  valid  range  is  hardware  specific.
81              Relative  values  can be specified too by prefixing with "+=" or
82              "-=" ("+=10%" or "-=2000").  The keywords "inc"  and  "dec"  are
83              accepted  to  and  will increase and decrease the given value in
84              small steps.
85
86       setattr <name> <value>
87              Set set the value of some attribute (color, contrast, ... can be
88              set this way too).
89
90       show [ <name> ]
91              Show the value current of some attribute.
92
93       list   List  all  available  attributes  with  all  properties (default
94              value, range, ...)
95
96       snap [ jpeg | ppm ] [ full | win | widthxheight ] <filename>
97              Capture one image.
98
99       webcam <filename>
100              Capture one image.  Does basically the same as  "snap  jpeg  win
101              <filename>".   Works  also  while  avi  recording is active.  It
102              writes to a temporary file and renames it when done, so there is
103              never a invalid file.
104
105       movie driver [ files | raw | avi | qt ]
106
107       movie  video  [  ppm  |  pgm | jpeg | rgb | gray | 422 | 422p | rgb15 |
108       rgb24 | mjpeg | jpeg | raw | mjpa | png ]
109
110       movie fps <frames per second>
111
112       movie audio [ mono8 | mono16 | stereo ]
113
114       movie rate <sample rate>
115
116       movie fvideo <filename>
117
118       movie faudio <filename>
119
120       movie start
121
122       movie stop
123              control xawtv's movie recorder.
124
125       fullscreen
126              Toggle fullscreen mode.
127
128       showtime
129              Display time (same what the 'D' key does in xawtv).
130
131       msg text
132              Display text on the on-screen display (window title / upper left
133              corner in fullscreen mode).
134
135       vtx line1 line2 [ ... ]
136              Display  subtitles.   It pops up a small window at the bottom of
137              the screen.  It is intended to be used as an interface for  dis‐
138              playing subtitles (often on videotext page 150 in Europe, that's
139              why the name) by external programs.
140              Every command line argument is one line, zero lines removes  the
141              window.   You  can  colorize  the text with the control sequence
142              "ESC  foreground  background".   foreground/background  has  the
143              range 0-7 (ansi term colors).  Example: "\03347 hello world " is
144              blue on white.  "\033" must be  a  real  escape  character,  the
145              string  doesn't  work.  With the bash you'll get it with ^V ESC.
146              vtx does also understand  the  ANSI  tty  escape  sequences  for
147              color.
148
149       quit   quit xawtv
150
151       keypad n
152              enter digit 'n'.  That's the two-digit channel selection, enter‐
153              ing two digits within 5 seconds switches to  the  selected  sta‐
154              tion.  Useful for lirc.
155
156       vdr command
157              send "command" to vdr (via connect on localhost:2001).
158

SEE ALSO

160       xawtv(1), motv(1), xawtvrc(5)
161

AUTHOR

163       Gerd Knorr <kraxel@bytesex.org>
164
166       Copyright (C) 1997-2001 Gerd Knorr <kraxel@bytesex.org>
167
168       This program is free software; you can redistribute it and/or modify it
169       under the terms of the GNU General Public License as published  by  the
170       Free  Software Foundation; either version 2 of the License, or (at your
171       option) any later version.
172
173       This program is distributed in the hope that it  will  be  useful,  but
174       WITHOUT  ANY  WARRANTY;  without  even  the  implied  warranty  of MER‐
175       CHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU  General
176       Public License for more details.
177
178       You should have received a copy of the GNU General Public License along
179       with this program; if not, write to the Free Software Foundation, Inc.,
180       675 Mass Ave, Cambridge, MA 02139, USA.
181
182
183
184                            (c) 1997-99 Gerd Knorr             xawtv-remote(1)
Impressum