1xawtv-remote(1) General Commands Manual xawtv-remote(1)
2
6 xawtv-remote, v4lctl -- control video4linux devices
7
9 xawtv-remote [ options ] command
10 v4lctl [ options ] command
11
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
19 xawtv-remote knows the following options:
20 -h print a short help text
22 -d dpy Set the X11 display
24 -i id Set the Window ID.
26 v4lctl understands these options:
28 -h print a short help text
30 -c device
32 Set video4linux device.
33 -v n Set debug level to n, where n = [0..2]
35
37 Both tools basically use the same set of commands. Some of them are
38 useful for xawtv-remote only (fullscreen for example).
39 setstation [ <name> | <nr> | next | prev | back ]
41 Set the TV station. This selects on of the TV stations which
42 are configured in the .xawtv config file. The argument can be
43 the station name or a number (the first one listed in the config
44 file is 0, ...). next/prev jumps to the next/previous station
45 in the list, back to the previously selected one.
46 setchannel [ <name> | next | prev ]
48 Tune in some channel.
49 setfreqtab <table>
51 Set the frequency table. See the menu in xawtv for a list of
52 valid choices.
53 setnorm <norm>
55 Set the TV norm (NTSC/PAL/SECAM).
56 setinput [ <input> | next ]
58 Set the video input (Television/Composite1/...)
59 capture [ on | off | overlay | grabdisplay ]
61 Set capture mode.
62 volume mute on | off
64 mute / unmute audio.
65 volume <arg>
67 color <arg>
69 hue <arg>
71 bright <arg>
73 contrast <arg>
75 Set the parameter to the specified value. <arg> can be one of
76 the following: A percent value ("70%" for example). Some abso‐
77 lute value ("32768"), the valid range is hardware specific.
78 Relative values can be specified too by prefixing with "+=" or
79 "-=" ("+=10%" or "-=2000"). The keywords "inc" and "dec" are
80 accepted to and will increase and decrease the given value in
81 small steps.
82 setattr <name> <value>
84 Set set the value of some attribute (color, contrast, ... can be
85 set this way too).
86 show [ <name> ]
88 Show the value current of some attribute.
89 list List all available attributes with all properties (default
91 value, range, ...)
92 snap [ jpeg | ppm ] [ full | win | widthxheight ] <filename>
94 Capture one image.
95 webcam <filename>
97 Capture one image. Does basically the same as "snap jpeg win
98 <filename>". Works also while avi recording is active. It
99 writes to a temporary file and renames it when done, so there is
100 never a invalid file.
101 movie driver [ files | raw | avi | qt ]
103 movie video [ ppm | pgm | jpeg | rgb | gray | 422 | 422p | rgb15 |
105 rgb24 | mjpeg | jpeg | raw | mjpa | png ]
106 movie fps <frames per second>
108 movie audio [ mono8 | mono16 | stereo ]
110 movie rate <sample rate>
112 movie fvideo <filename>
114 movie faudio <filename>
116 movie start
118 movie stop
120 control xawtv's movie recorder.
121 fullscreen
123 Toggle fullscreen mode.
124 showtime
126 Display time (same what the 'D' key does in xawtv).
127 msg text
129 Display text on the on-screen display (window title / upper left
130 corner in fullscreen mode).
131 vtx line1 line2 [ ... ]
133 Display subtitles. It pops up a small window at the bottom of
134 the screen. It is supported to be used as interface for dis‐
135 playing subtitles (often on videotext page 150 in europe, thats
136 why the name) by external programs.
137 Every command line argument is one line, zero lines removes the
138 window. You can colorize the text with the control sequence
139 "ESC foreground background". foreground/background has the
140 range 0-7 (ansi term colors). Example: "\03347 hello world " is
141 blue on white. "\033" must be a real escape character, the
142 string does'nt work. With the bash you'll get it with ^V ESC.
143 vtx does also understand the ANSI tty escape sequences for
144 color.
145 quit quit xawtv
147 keypad n
149 enter digit 'n'. That's the two-digit channel selection, enter‐
150 ing two digits within 5 seconds switches to the selected sta‐
151 tion. Useful for lirc.
152 vdr command
154 send "command" to vdr (via connect on localhost:2001).
155
157 xawtv(1), motv(1), xawtvrc(5)
158
160 Gerd Knorr <kraxel@bytesex.org>
161
163 Copyright (C) 1997-2001 Gerd Knorr <kraxel@bytesex.org>
164 This program is free software; you can redistribute it and/or modify it
166 under the terms of the GNU General Public License as published by the
167 Free Software Foundation; either version 2 of the License, or (at your
168 option) any later version.
169 This program is distributed in the hope that it will be useful, but
171 WITHOUT ANY WARRANTY; without even the implied warranty of MER‐
172 CHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General
173 Public License for more details.
174 You should have received a copy of the GNU General Public License along
176 with this program; if not, write to the Free Software Foundation, Inc.,
177 675 Mass Ave, Cambridge, MA 02139, USA.
178 (c) 1997-99 Gerd Knorr xawtv-remote(1)