.\" $Id: tunerctl.1.in,v 1.5 1999/10/04 22:57:18 mb Exp mb $
.TH tunerctl 1 "Version @VERSION@" VideoteXt

.SH NAME
tunerctl \- control TV-tuner on videotext-interface

.SH SYNOPSIS
.B tunerctl
.RI [ options ]
.RI [ frequency | channel | program ]

.SH DESCRIPTION
\fItunerctl\fP allows you to show or modify the current frequency/channel or
program of a TV-tuner built onto a videotext-interface. If invoked without
arguments, it shows the current frequency and program of the tuner.
.PP
Not all interfaces support both tuning methods. To find out the supported
methods for your tuner, run \fItunerctl\fP without arguments. Only the
printed values may be set on the commandline.
.PP
You may give the new frequency to set the tuner to as a single argument. Its
format is a floating point number optionally followed by a suffix
determining the unit to use. Possible suffixes are \fBkHz\fP, \fBMHz\fP,
\fBk\fP or \fBM\fP (case insensitive). The allowed frequency range depends
on the tuner used. If setting the frequency was successful, the new
frequency will shown (depending on the tuner's capabilities, this might not
be exaclty the one you requested).
.PP
Another method to set a new frequency is to use the \fB-c\fP option and the
the new channel as a single argument. This channel name/number is looked up
in the file \fB@LIBDIR@/tv-channels\fP and translated to a frequency, taking
the selected TV system into account.
.PP
You may also set the current program of the tuner by using the \fB-p\fP
option. The allowed range for the channels depends on the tuner used. If
setting the new channel was successful, the new channel will be shown.

.SH OPTIONS
.IP "\fB-f\fP"
Interpret argument as frequency (default)
.IP "\fB-c\fP"
Interpret argument as channel number/name
.IP "\fB-p\fP"
Interpret argument as program number
.IP "\fB-s\fP \fIsystem\fP"
Override default TV system for channel selection
.IP "\fB-v\fP \fIsource\fP"
Select video source (numeric)
.IP "\fB-D\fP \fIdevice\fP"
Override default filename for tuner device-file
.IP "\fB-\e?\fP"
Show available \fItunerctl\fP-options

.SH FILES
.IP "\fB/dev/vttuner\fP"
Default device-file to access locally attached tuner on videotext-interface
.IP "\fB@LIBDIR@/tv-channels\fP"
Configuration file storing the relations between channel names/numbers and
frequencies for different TV systems

.SH ENVIRONMENT
.IP "\fBTUNER_DEVICE\fP"
Overrides default filename for videotext device-file

.SH AUTHOR
Martin Buck <martin.buck@bigfoot.com>
.PP
The lastest releases, beta-versions and news about \fIVideoteXt\fP can
always be found on
\fBhttp://home.pages.de/~videotext/\fP.

.SH "SEE ALSO"
.BR videotext (1),
.BR vtxget (1)