NAME
xawtv-remote, v4lctl -- control video4linux devices
SYNOPSIS
xawtv-remote [ options ] command
v4lctl [ options ] command
DESCRIPTION
xawtv-remote and v4lctl can be used to control a video4linux driven TV
card. xawtv-remote passes the command to a already running xawtv or
motv instance using X11 properties. v4lctl sets the parameters
directly.
OPTIONS
xawtv-remote knows the following options:
-h print a short help text
-d dpy Set the X11 display
-i id Set the Window ID.
v4lctl understands these options:
-h print a short help text
-c device
Set video4linux device.
-v n Set debug level to n, where n = [0..2]
COMMANDS
Both tools basically use the same set of commands. Some of them are
useful for xawtv-remote only (fullscreen for example).
setstation [ <name> | <nr> | next | prev | back ]
Set the TV station. This selects on of the TV stations which
are configured in the .xawtv config file. The argument can be
the station name or a number (the first one listed in the config
file is 0, ...). next/prev jumps to the next/previous station
in the list, back to the previously selected one.
setchannel [ <name> | next | prev ]
Tune in some channel.
setfreqtab <table>
Set the frequency table. See the menu in xawtv for a list of
valid choices.
setnorm <norm>
Set the TV norm (NTSC/PAL/SECAM).
setinput [ <input> | next ]
Set the video input (Television/Composite1/...)
capture [ on | off | overlay | grabdisplay ]
Set capture mode.
volume mute on | off
mute / unmute audio.
volume <arg>
color <arg>
hue <arg>
bright <arg>
contrast <arg>
Set the parameter to the specified value. <arg> can be one of
the following: A percent value ("70%" for example). Some
absolute value ("32768"), the valid range is hardware specific.
Relative values can be specified too by prefixing with "+=" or
"-=" ("+=10%" or "-=2000"). The keywords "inc" and "dec" are
accepted to and will increase and decrease the given value in
small steps.
setattr <name> <value>
Set set the value of some attribute (color, contrast, ... can be
set this way too).
show [ <name> ]
Show the value current of some attribute.
list List all available attributes with all properties (default
value, range, ...)
snap [ jpeg | ppm ] [ full | win | widthxheight ] <filename>
Capture one image.
webcam <filename>
Capture one image. Does basically the same as "snap jpeg win
<filename>". Works also while avi recording is active. It
writes to a temporary file and renames it when done, so there is
never a invalid file.
movie driver [ files | raw | avi | qt ]
movie video [ ppm | pgm | jpeg | rgb | gray | 422 | 422p | rgb15 |
rgb24 | mjpeg | jpeg | raw | mjpa | png ]
movie fps <frames per second>
movie audio [ mono8 | mono16 | stereo ]
movie rate <sample rate>
movie fvideo <filename>
movie faudio <filename>
movie start
movie stop
control xawtv’s movie recorder.
fullscreen
Toggle fullscreen mode.
showtime
Display time (same what the ’D’ key does in xawtv).
msg text
Display text on the on-screen display (window title / upper left
corner in fullscreen mode).
vtx line1 line2 [ ... ]
Display subtitles. It pops up a small window at the bottom of
the screen. It is intended to be used as an interface for
displaying subtitles (often on videotext page 150 in Europe,
that’s why the name) by external programs.
Every command line argument is one line, zero lines removes the
window. You can colorize the text with the control sequence
"ESC foreground background". foreground/background has the
range 0-7 (ansi term colors). Example: "\03347 hello world " is
blue on white. "\033" must be a real escape character, the
string doesn’t work. With the bash you’ll get it with ^V ESC.
vtx does also understand the ANSI tty escape sequences for
color.
quit quit xawtv
keypad n
enter digit ’n’. That’s the two-digit channel selection,
entering two digits within 5 seconds switches to the selected
station. Useful for lirc.
vdr command
send "command" to vdr (via connect on localhost:2001).
SEE ALSO
xawtv(1), motv(1), xawtvrc(5)
AUTHOR
Gerd Knorr <kraxel@bytesex.org>
COPYRIGHT
Copyright (C) 1997-2001 Gerd Knorr <kraxel@bytesex.org>
This program is free software; you can redistribute it and/or modify it
under the terms of the GNU General Public License as published by the
Free Software Foundation; either version 2 of the License, or (at your
option) any later version.
This program is distributed in the hope that it will be useful, but
WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
General Public License for more details.
You should have received a copy of the GNU General Public License along
with this program; if not, write to the Free Software Foundation, Inc.,
675 Mass Ave, Cambridge, MA 02139, USA.
(c) 1997-99 Gerd Knorr xawtv-remote(1)