1xawtv-remote(1) General Commands Manual xawtv-remote(1)
2
3
4
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
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
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
160 xawtv(1), motv(1), xawtvrc(5)
161
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)