tvtime-configure(1)					      General Commands Manual					       tvtime-configure(1)

NAME

       tvtime-configure - change settings in the tvtime configuration file

SYNOPSIS

       tvtime-configure [ OPTION ] ...

DESCRIPTION

       tvtime-configure  allows a user to set configuration settings for tvtime without starting the application.  This is useful for installation
       programs such as debconf to let them configure tvtime without having to write a parser  for  the  configuration	file.	The  command  line
       options are a subset of those for tvtime itself.

OPTIONS

       -a, --widescreen
	      This option starts tvtime in 16:9 aspect ratio mode.

       -A, --nowidescreen
	      This option starts tvtime in 4:3 aspect ratio mode.

       -h, --help
	      Show usage information.

       -m, --fullscreen
	      Start tvtime in fullscreen mode.

       -M, --window
	      Start tvtime in windowed mode.

       -p, --fspos=POS
	      Set the fullscreen window position.  Use this if you have a projector to help tvtime fit properly onto your screen.

	      o   top
	      o   bottom
	      o   centre (default)

       -F, --configfile=FILE
	      Additional config file to load settings from.

       -H, --height=HEIGHT
	      Sets the height of the output window to start up at in scanlines.  The default output window size is 576 scanlines.

       -I, --inputwidth=SAMPLING
	      V4L  input  scanline  sampling (defaults to 720.	This sets how many pixels per scanline to request from the capture card.  A higher
	      setting gives better quality, while a lower setting means we do less work, and so tvtime will run faster.  If you have a slower  CPU
	      (like,  less  than  500Mhz  or  so),  maybe  values  of  480 or 400 might suit you best.	For best quality, choose a high value like
	      720 or 768.  Many capture cards cannot sample higher than 768 pixels per scanline.

       -d, --device=NAME
	      video4linux device to use (defaults to /dev/video0).

       -b, --vbidevice=DEVICE
	      VBI device to use (defaults to /dev/vbi0).

       -i, --input=INPUTNUM
	      video4linux input number (defaults to 0).  Cards commonly have a bunch of sources, for example, on my WinTV card,  source  0  is	my
	      tuner and source 1 is the composite input.

       -c, --channel=CHANNEL
	      On startup, tvtime will tune to the given channel.  Otherwise, the channels from the config file will be used.

       -n, --norm=NORM
	      The mode to set the tuner to (defaults to NTSC).	Valid modes are:

	      o   NTSC
	      o   PAL
	      o   SECAM
	      o   PAL-NC
	      o   PAL-M
	      o   PAL-N
	      o   NTSC-JP

       -f, --frequencies=NAME
	      The channels you are receiving with the tuner (defaults to us-cable).  Valid values are:

	      o   us-cable
	      o   us-broadcast
	      o   japan-cable
	      o   japan-broadcast
	      o   europe
	      o   australia
	      o   australia-optus
	      o   newzealand
	      o   france
	      o   russia

       -R, --priority=PRI
	      Sets the process priority (see nice(1)) that tvtime should be run at.

       -t, --xmltv=FILE
	      Reads XMLTV listings from the given file to display on the OSD.  Channels are looked up based on their name, and tvtime will display
	      the show title, sub-title and show description on the OSD.

       -l, --xmltvlanguage=LANG
	      Use XMLTV data in given language, if available.  Languages are represented by their two-letter language code (for example, "de"  for
	      German).	The default language used in the file will be used if this is unset or set to "none"

       -x, --mixer=DEVICE[:CH]
	      The mixer device and channel for the volume controls. (defaults to /dev/mixer:line).  Valid channels are:

	      o   vol
	      o   bass
	      o   treble
	      o   synth
	      o   pcm
	      o   speaker
	      o   line
	      o   mic
	      o   cd
	      o   mix
	      o   pcm2
	      o   rec
	      o   igain
	      o   ogain
	      o   line1
	      o   line2
	      o   line3
	      o   dig1
	      o   dig2
	      o   dig3
	      o   phin
	      o   phout
	      o   video
	      o   radio
	      o   monitor

AUTHORS

       Billy Biggs.

SEE ALSO

       tvtime(1), tvtime.xml(5),

tvtime 1.0RC1							    April 2005						       tvtime-configure(1)