Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
xawtv-remote(1)		    General Commands Manual	       xawtv-remote(1)

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 di-
       rectly.

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  ab-
	      solute  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 dis-
	      playing 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,	enter-
	      ing two digits within 5 seconds switches to  the	selected  sta-
	      tion.  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  MER-
       CHANTABILITY  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)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=v4lctl&sektion=1&manpath=FreeBSD+Ports+15.0>

home | help