Provided by: xawtv_3.102-3_i386 bug

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)