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  com­
       mand to a already running xawtv instance using X11 proper­
       ties.  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 sta­
              tions  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 sta­
              tion  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).

              Set the video input (Television/Composite1/...)

       capture [ on | off | overlay | grabdisplay ]
              Set capture mode.

       volume <n>

       color <n>

       hue <n>

       bright <n>

       contrast <n>
              Set  the  parameter  to the specified value.  Range
              for all values is 0 <= n  <=  65535.   <n>  can  be
              either  absolute (like "32768") or relative (marked
              by a sign, like  "+1000"  or  "-512").   "inc"  and
              "dec"  are  accepted  too and increase/decrease the
              parameter by one  percent.   "volume"  additionally
              accepts "mute".

       snap [ jpeg | ppm ] [ full | win | widthxheight ] <file­
              name>
              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 file <filename> | start | stop
              control xawtv's avi recorder.

       fullscreen
              Toggle fullscreen mode.

       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  supported  to  be
              used  as  interface for displaying subtitles (often
              on videotext page 150  in  europe,  thats  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

              white.  "\033" must be a real escape character, the
              string  does'nt  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.


SEE ALSO

       xawtv(1), fbtv(1)


AUTHOR

       Gerd Knorr <kraxel@goldbach.in-berlin.de>


COPYRIGHT

       Copyright  (C)  1997-99  Gerd  Knorr  <kraxel@goldbach.in-
       berlin.de>

       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.


Man(1) output converted with man2html