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.

       -D driver
              Set video4linux driver.

       -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)