<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN"
"http://www.w3.org/TR/html4/strict.dtd">
<html>
<head>
<title>tvtime: Using tvtime</title>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
<meta http-equiv="Content-Style-Type" content="text/css">
<link href="tvtime.css" rel="stylesheet" type="text/css">
</head>
<body>
<table width="728px" class="centered" border="0" cellpadding="0" cellspacing="0">
<colgroup>
<col width="24px">
<col width="125px">
<col width="579px">
</colgroup>
<tr><td align="center" colspan="3"><a href="http://tvtime.sourceforge.net/"><img src="tvtime-logo-banner.png" alt="tvtime"/></a></td></tr>
<tr><td class="hangspace"></td>
<td class="navbar">
<table class="doclist" width="95%">
<tr><td class="docentry">
<a href="http://tvtime.sourceforge.net/why.html">why tvtime?</a></td></tr>
<tr><td class="docentry">
<a href="http://tvtime.sourceforge.net/downloads.php">download tvtime!</a></td></tr>
<tr><td class="docentry">
<a href="http://tvtime.sourceforge.net/screenshots.html">screenshots!</a></td></tr>
<tr><td class="docentry">
<a href="http://tvtime.sourceforge.net/links.html">related sites</a></td></tr>
<tr><td class="docentry">
<a href="http://tvtime.sourceforge.net/">home</a></td></tr>
</table>
<p></p>
<table class="doclist" width="95%">
<tr><th class="docbox">support</td></tr>
<tr><td class="docentry">
<a href="http://tvtime.sourceforge.net/cards.html">supported cards</a></td></tr>
<tr><td class="docentry">
<a href="help.html">help and faq</a></td></tr>
<tr><td class="docentry">
<a href="usage.html">using tvtime</a></td></tr>
<tr><td class="docentry">
<a href="problems.html">common problems</a></td></tr>
<tr><td class="docentry">
<a href="http://www.sourceforge.net/tracker/?group_id=64301&atid=506987">report bugs</a></td></tr>
</table>
<p></p>
<table cellpadding="4" width="100%">
<tr><td class="center">
<a href="http://sourceforge.net"><img src="http://sourceforge.net/sflogo.php?group_id=64301"
width="88" height="31" alt="SourceForge Logo"></a></td></tr>
<!--
<tr><td class="center">
<a href="http://validator.w3.org/check/referer"><img src="http://www.w3.org/Icons/valid-html401"
alt="Valid HTML 4.01!" height="31" width="88"></a></td></tr>
<tr><td class="center">
<a href="http://jigsaw.w3.org/css-validator/check/referer"><img
src="http://jigsaw.w3.org/css-validator/images/vcss"
height="31px" width="88px" alt="Valid CSS!" /></a></td></tr>
-->
<tr><td class="center">
<a href="http://tvtime.net/"><img src="http://tvtime.sourceforge.net/tvtime3.png"
width="88px" height="31px" alt="tvtime Logo"></a></td></tr>
<tr><td class="center">
<a href="mailto:vektor@dumbterm.net">email the webmaster</a></td></tr>
</table>
</td>
<td>
<table width="90%" class="centered">
<tr><td>
<h2 class="center">Articles on using tvtime</h2>
<ol>
<li><a href="xmltv.html">Configuring tvtime for displaying XMLTV listings</a>
<li><a href="lirc.html">Configuring lirc for tvtime</a>
</ol>
<h2 class="center">General tvtime usage</h2>
<ol>
<li><a href="#configure">Setting up tvtime</a>
<li><a href="#deinterlacing">Deinterlacing modes explained</a>
<li><a href="#sixteennine">Using widescreen 16:9 mode</a>
<li><a href="#keybindings">Key bindings</a>
<li><a href="#channels">Setting up your channel list in tvtime</a>
<li><a href="#configfile">The tvtime.xml config file</a>
<li><a href="#tvtimecommand">Controlling tvtime via the tvtime-command</a>
</ol>
<h3><a name="configure">1. Setting up tvtime</a></h3>
<p>Almost all features of tvtime can be configured through the
menu system. Click the right mouse button, or hit tab when
you run tvtime to bring up the menu. As well, many features
can be configured using the command-line tool
<b>tvtime-configure</b>. Run '<b>tvtime-configure --help</b>' to
get a list of command line arguments. Make sure tvtime is not
running while you use <b>tvtime-configure</b>. An example of
using this tool to configure tvtime is given below:
<pre>
tvtime-configure --norm=pal --frequencies=europe
</pre>
<p>This will save to your config file the norm PAL and frequency table
Europe as your defaults. See <tt>docs/default.tvtime.xml</tt> for
a default configuration file and the default runtime keybindings.</p>
<h3><a name="deinterlacing">2. Deinterlacing modes explained</a></h3>
<p>tvtime includes different deinterlacing modes for different types of
content as well as different output refresh rates or CPU constraints.
Below we have separated out our modes based on their content, and
provide a description of each.</p>
<h4>Modes for video content</h4>
<p>Most of the deinterlacing methods in tvtime are intended for use on
video content. All of the following are considered video content:</p>
<ul>
<li>News shows and information channels.
<li>Most live-action television dramas.
<li>Sports broadcasts.
<li>Most video gaming consoles.
</ul>
<p>We provide three classes of video deinterlacers: <b>Television</b>,
<b>Blur</b> and <b>Motion adaptive</b>.</p>
<h4>Television mode, full and half resolution</h4>
<p>In television mode, tvtime expands each field to full resolution,
without ever blurring in time or copying in time. this effectively
simulates a television. Use this mode when you want TV-quality with low
CPU, and you have configured your monitor to run at the refresh rate of
the video signal (59.94 Hz or 50 Hz). There are two television
deinterlacers:</p>
<ul>
<li>Full Resolution: High quality for fullscreen use.
<li>Half Resolution: Poor quality for watching
TV in a small window.
</ul>
<h4>Blur mode, temporal and vertical</h4>
<p>In blur mode, tvtime avoids flicker by blurring together consecutive
frames of input. Use this if you want to run your monitor at an
arbitrary refresh rate, and have tvtime not use much CPU. There are two
blur modes available:</p>
<ul>
<li>Vertical: Blur vertically more than temporally,
better for high motion content like sports.
<li>Temporal: Evenly blur in time, low CPU mode for
less flicker, but visible trails on fast motion.
</ul>
<h4>Motion adaptive modes, search, advanced and simple detection</h4>
<p>The motion adaptive modes in tvtime try to detect motion in the input
frames, reconstructing detail where possible. You want to run your
monitor at an arbitrary refresh rate, and don't mind using a lot of
CPU. There are three modes available in tvtime:</p>
<ul>
<li>Simple and Advanced detection: Linear interpolation where motion is
detected, copy where no motion. Simple and advanced versions are
provided to give small or moderate CPU requirements with high quality
output. These are the greedy low motion and high motion deinterlacers
from <a href="http://dscaler.org/">DScaler</a>.
<li>Motion search: Follow motion vectors for more accurate
interpolation. High quality with high CPU requirements. This is
the TomsMoComp deinterlacer from <a href="http://dscaler.org/">DScaler</a>.
</ul>
<h4>Modes built for film content</h4>
<p>We are still working on better support for film detection
modes in tvtime, but we already support some useful
features. Film content is what we would call anything that
either originated from film or has been converted to video from
an originally progressive format.</p>
<ul>
<li>Films broadcast on TV or from a DVD player.
<li>Cartoons and most anime.
<li>Some higher budget television dramas
<li>Older video gaming consoles.
</ul>
<h4>Progressive (top or bottom field first)</h4>
<p>In progressive mode, tvtime constructs frames from pairs of fields.
Use this mode if you are using a video game from a console system which
sends a progressive signal, or are watching a film broadcast or
DVD in a PAL area. There are two modes available:</p>
<ul>
<li>Top Field First and Bottom Field first. You
must experiment with your content and see how
it is being sent, and select the appropriate
mode in tvtime to match it.
</ul>
<h4>Progressive Detection</h4>
<p>While not currently available in tvtime, this option would allow
us to detect progressive content, and whether it is top or bottom field
first, rather than manually setting this option. This would be
able to autodetect content that would be helped by using the
above progressive modes.</p>
<h4>NTSC Film Mode</h4>
<p>tvtime can detect a 2-3 pulldown sequence in the video stream and
use this information to intelligently reconstruct frames.
Enable this when watching an NTSC broadcast of a cartoon, film, or
television program shot on film. The feature can be found in the
in the input filters menu in tvtime.</p>
<p>The following is a table of the available deinterlacing modes and their
names in the config file.</p>
<table border="0" width="70%" class="doclist">
<tr><th class="docbox">Short name
<th class="docbox">Long name
<tr><td class="docentry">TelevisionFull <td class="docentry">Television: Full Resolution
<tr><td class="docentry">TelevisionHalf <td class="docentry">Television: Half Resolution
<tr><td class="docentry">BlurVertical <td class="docentry">Blur: Vertical
<tr><td class="docentry">BlurTemporal <td class="docentry">Blur: Temporal
<tr><td class="docentry">AdaptiveSearch <td class="docentry">Motion Adaptive: Motion Search
<tr><td class="docentry">AdaptiveAdvanced <td class="docentry">Motion Adaptive: Advanced Detection
<tr><td class="docentry">AdaptiveSimple <td class="docentry">Motion Adaptive: Simple Detection
<tr><td class="docentry">ProgressiveTFF <td class="docentry">Progressive: Top Field First
<tr><td class="docentry">ProgressiveBFF <td class="docentry">Progressive: Bottom Field First
</table>
<h3><a name="sixteennine">3. Using widescreen 16:9 mode</a></h3>
<p>In 16:9 mode we treat the incoming signal as if it were 16:9 aspect
ratio. If you're using a hardware DVD player, you should tell it that
you have a 16:9 TV to get higher quality from your DVDs.</p>
<img src="toshiba-16x9-screenshot.jpg" alt="Setting to 16:9 on a Toshiba DVD player">
<p>The above screenshot shows the setup menu on the Toshiba SD-412V
DVD player. Below is a screenshot of a scene from
<a href="http://imdb.com/Title?0085809">Koyaanisqatsi</a>
in 16:9 mode, giving the full vertical quality of the anamorphic
DVD content.</p>
<img src="wsshot-small.jpg" alt="An anamorphic DVD viewed in tvtime">
<h3><a name="keybindings">4. Key bindings</a></h3>
<p>Below is a table of the default key bindings in tvtime. Listed
in the right hand column is the name of the setting in the
<b>tvtime.xml</b> configuration file. See <a
href="default.tvtime.xml">default.tvtime.xml</a> file on the web or
included with the tvtime distribution.</p>
<table border="0" width="70%" class="doclist">
<tr><th class="docbox">Key
<th class="docbox">Description
<tr><th class="docbox">
<th class="docbox">General use
<tr><td class="docbox">Escape or q <td class="docentry">Quit
<tr><td class="docbox">F1 or Tab <td class="docentry">Show menu
<tr><td class="docbox">up/down <td class="docentry">Change channels
<tr><td class="docbox">0-9 and Enter <td class="docentry">Change channels
<tr><td class="docbox">Backspace <td class="docentry">Jump to previous channel
<tr><td class="docbox">i <td class="docentry">Change input
<tr><td class="docbox">m <td class="docentry">Mute
<tr><td class="docbox">+/- <td class="docentry">Volume control
<tr><td class="docbox">f <td class="docentry">Fullscreen
<tr><td class="docbox">s <td class="docentry">Take a screenshot
<tr><td class="docbox">d <td class="docentry">Display debug statistics
<tr><th class="docbox">
<th class="docbox">Advanced
<tr><td class="docbox">left/right <td class="docentry">Channel finetuning
<tr><td class="docbox">< / > <td class="docentry">Overscan setting
<tr><td class="docbox">e <td class="docentry">Toggle audio mode (stereo/mono/SAP)
<tr><td class="docbox">a <td class="docentry">Change output aspect ratio
<tr><td class="docbox">r <td class="docentry">Renumber current channel
<tr><td class="docbox">v <td class="docentry">Toggle always-on-top with supporting window managers
<tr><td class="docbox">p <td class="docentry">Toggle pulldown detection (NTSC only)
<tr><td class="docbox">t <td class="docentry">Change deinterlacer
<tr><td class="docbox">= <td class="docentry">Change attempted output framerate
<tr><td class="docbox">F5/F6/F7 <td class="docentry">Picture settings
<tr><td class="docbox">c <td class="docentry">Toggle closed caption decoding (NTSC only)
<tr><td class="docbox">ins <td class="docentry">Change matte mode
</table>
<h3><a name="channels">5. Setting up your channel list in tvtime</a></h3>
<p>tvtime supports a channel scanner, channel renumbering, channel names,
and a list of active channels for browsing. All of these features are
available within the OSD menu system itself. Here we present some of
the details for users that wish to configure their stations
directly.</p>
<p>European users of cable providers that do not use standard frequencies
can use our channel scanner: tvtime-scanner. This outputs to the
'Custom' frequency table, selectable in the OSD menu.</p>
<h3>stationlist.xml</h3>
<p>The station listing is read in from the ~/.tvtime/stationlist.xml.
Channel settings are saved specific to norm and frequency table.
Entries in a list are in the following form:</p>
<pre>
<station name="CNN" active="1" position="18"
band="US Cable" channel="18"/>
<station name="DSF" active="1" position="12"
band="VHF E2-E12" channel="E12"/>
</pre>
<p>The possible bands and frequencies available in tvtime are:</p>
<table border="0" width="70%" class="doclist">
<tr><th class="docbox">Band name
<th class="docbox">Stations provided
<tr><td class="docentry">US Cable <td class="docentry">1 - 125
<tr><td class="docentry">US Two-Way <td class="docentry">T7, T8, T9, T10, T11, T12 T13, T14
<tr><td class="docentry">US Broadcast <td class="docentry">2 - 83
<tr><td class="docentry">China Broadcast <td class="docentry">1 - 68, A1 - A7, B1 - B31, C1 - C5
<tr><td class="docentry">Japan Broadcast <td class="docentry">1 - 62
<tr><td class="docentry">Japan Cable <td class="docentry">13 - 63
<tr><td class="docentry">VHF E2-E12 <td class="docentry">E1 - E12
<tr><td class="docentry">VHF S1-S41 <td class="docentry">S1 - S41
<tr><td class="docentry">VHF Misc <td class="docentry">X, Y, Z, Z+1, Z+2
<tr><td class="docentry">VHF France <td class="docentry">K01 - K10, KB - KQ, H01 - H19
<tr><td class="docentry">VHF Russia <td class="docentry">R1 - R12, SR1 - SR19
<tr><td class="docentry">VHF Australia <td class="docentry">AS1 - AS12, AS5A, AS9A
<tr><td class="docentry">VHF Italy <td class="docentry">A - H, H1, H2
<tr><td class="docentry">VHF Ireland <td class="docentry">I1 - I9
<tr><td class="docentry">VHF South Africa <td class="docentry">1 - 13
<tr><td class="docentry">UHF <td class="docentry">U21 - U69
<tr><td class="docentry">UHF Australia <td class="docentry">AU28 - AU69
<tr><td class="docentry">Australia Optus <td class="docentry">01 - 058
</table>
<p>Custom frequencies can be included manually as follows:
<pre>
<station name="2" active="1" position="0"
band="Custom" channel="55.69MHz"/>
</pre>
<h3>Non-English characters in channel names</h3>
<p>Since 0.9.8.2 it is possible to use non-English characters in channel
names. To do this, you first need to specify a character set for the XML
document. This is done by changing <tt><?xml version="1.0"?></tt>
to for example <tt><?xml version="1.0" encoding="ISO-8859-1"?></tt>,
depending on what encoding you want. If no encoding is specified, UTF-8
is assumed.</p>
<p><b>Note 1:</b> If you want to display an <tt>&</tt> sign, you have
to type <tt>&amp;</tt> since the file is XML.</p>
<p><b>Note 2:</b> This non-English text support is not completely done yet.
First of all, it probably only work properly on left-to-right languages
which don't use any funky unicode features like combining characters.
Also, the glyphs have to be in <b>FreeSansBold.ttf</b>. This rules out asian
languages.</p>
<h3><a name="configfile">6. The tvtime.xml config file</a></h3>
<p>tvtime's config file is written as an XML document.
A <a href="default.tvtime.xml">default <b>tvtime.xml</b></a> file is installed
to <tt>/etc/tvtime/tvtime.xml</tt> and documents each of the parameters. As well, there is
a man page installed (<tt>man tvtime.xml</tt>) which also gives help for each of
the parameters. An alternate config file may be specified on the command
line using the <tt>--configfile</tt> option. Additional config files are loaded
after reading defaults from <tt>/etc/tvtime/tvtime.xml</tt> and
<tt>$HOME/.tvtime/tvtime.xml</tt>.</p>
<h3><a name="tvtimecommand">7. Controlling tvtime via tvtime-command</a></h3>
<p>Modern PCs now have many custom input devices, such as remotes, multimedia
keys, and voice recognition microphones. tvtime helps support alternate
inputs through an application called <b>tvtime-command</b>. This application
can send commands to control changing channels, adjusting volume, or navigating
the menu without having to switch focus to tvtime. This allows for many
extended features.</p>
<p>To send commands to tvtime, simply execute the <b>tvtime-command</b>
program, along with any number of commands as its arguments. The
following is a list of commands known to tvtime:</p>
<table width="90%" class="doclist">
<tr><th class="docboxleft">AUTO_ADJUST_PICT
<tr><td class="docentry"><p>
Restores the picture settings (brightness, contrast, hue, colour) to
their default values.
</p></table><p></p>
<table width="90%" class="doclist">
<tr><th class="docboxleft">AUTO_ADJUST_WINDOW
<tr><td class="docentry"><p>
Automatically resize the window to match the content inside it. This
is for when you resize tvtime into, say, a long rectangle, and want it
to jump back to being a perfect 4:3 box around the content.
</p><p>The <b>AUTO_ADJUST_WINDOW</b> command was added in tvtime 0.9.8.3.
</p></table><p></p>
<table width="90%" class="doclist">
<tr><th class="docboxleft">BRIGHTNESS_DOWN
<tr><td class="docentry"><p>
Lowers the brightness setting on the input.
</p></table><p></p>
<table width="90%" class="doclist">
<tr><th class="docboxleft">BRIGHTNESS_UP
<tr><td class="docentry"><p>
Increases the brightness setting on the input.
</p></table><p></p>
<table width="90%" class="doclist">
<tr><th class="docboxleft">CHANNEL_[0-9]
<tr><td class="docentry"><p>
Simulates a keypad number press.
</p></table><p></p>
<table width="90%" class="doclist">
<tr><th class="docboxleft">CHANNEL_ACTIVATE_ALL
<tr><td class="docentry"><p>
Re-activates all channels in the list. Use this to re-initialize the
channel list before running the scanner if you believe some channels are
missing, or if new channels have become available.
</p></table><p></p>
<table width="90%" class="doclist">
<tr><th class="docboxleft">CHANNEL_DEC / CHANNEL_DOWN
<tr><td class="docentry"><p>
Move one channel down in the channel list.
</p><p>The <b>CHANNEL_DEC</b> command was added in tvtime 0.9.8.1.
</p></table><p></p>
<table width="90%" class="doclist">
<tr><th class="docboxleft">CHANNEL_INC / CHANNEL_UP
<tr><td class="docentry"><p>
Move one channel up in the channel list.
</p><p>The <b>CHANNEL_INC</b> command was added in tvtime 0.9.8.1.
</p></table><p></p>
<table width="90%" class="doclist">
<tr><th class="docboxleft">CHANNEL_JUMP / CHANNEL_PREV
<tr><td class="docentry"><p>
Changes to the last channel you were at. Useful for jumping back and
forth between two programs on distant channels.
</p><p>The <b>CHANNEL_JUMP</b> command was added in tvtime 0.9.11.
</p></table><p></p>
<table width="90%" class="doclist">
<tr><th class="docboxleft">CHANNEL_RENUMBER
<tr><td class="docentry"><p>
Renumbers the current channel. This will swap the current channel with
the number you type in. Use this to configure your station list to suit
preference or locality.
</p></table><p></p>
<table width="90%" class="doclist">
<tr><th class="docboxleft">CHANNEL_SAVE_TUNING
<tr><td class="docentry"><p>
Saves the current fine tuning settings as a custom channel in the
station list.
</p></table><p></p>
<table width="90%" class="doclist">
<tr><th class="docboxleft">CHANNEL_SCAN
<tr><td class="docentry"><p>
Walks from the current position through the channel list, disabling any
channels for which no signal is detected. This command is only
available if signal checking is enabled.
</p></table><p></p>
<table width="90%" class="doclist">
<tr><th class="docboxleft">CHANNEL_SKIP
<tr><td class="docentry"><p>
Toggles the current channel as being active or disabled in the station
list. You can use this to manually scan your channels and enable those
with signal or disable duplicate stations.
</p></table><p></p>
<table width="90%" class="doclist">
<tr><th class="docboxleft">COLOUR_DOWN / COLOR_DOWN
<tr><td class="docentry"><p>
Decreases the input colour picture setting. This will make the image
less colourful until it is black-and-white.
</p></table><p></p>
<table width="90%" class="doclist">
<tr><th class="docboxleft">COLOUR_UP / COLOR_UP
<tr><td class="docentry"><p>
Increases the input colour picture setting. This will give the image
more colour.
</p></table><p></p>
<table width="90%" class="doclist">
<tr><th class="docboxleft">CONTRAST_DOWN
<tr><td class="docentry"><p>
Decreases the contrast setting of the input.
</p></table><p></p>
<table width="90%" class="doclist">
<tr><th class="docboxleft">CONTRAST_UP
<tr><td class="docentry"><p>
Increases the contrast setting of the input.
</p></table><p></p>
<table width="90%" class="doclist">
<tr><th class="docboxleft">DISPLAY_INFO
<tr><td class="docentry"><p>
This will re-display the OSD for the current channel, showing the
channel information, current deinterlacer and framerate, the time, and
input settings.
</p></table><p></p>
<table width="90%" class="doclist">
<tr><th class="docboxleft">DISPLAY_MESSAGE
<tr><td class="docentry"><p>
This will display a message along the bottom of the OSD. Useful for
cron jobs or other scripts to send notifications to a user running
tvtime.
</p><p>The <b>DISPLAY_MESSAGE</b> command was added in tvtime 0.9.9.
</p></table><p></p>
<table width="90%" class="doclist">
<tr><th class="docboxleft">DOWN
<tr><td class="docentry"><p>
This command provides the dual functionality of channel down or menu arrow
down, depending on whether the menu is currently active. This command is
to be used together with the <b>LEFT</b>, <b>RIGHT</b> and <b>UP</b> commands.
</p><p>The <b>DOWN</b> command was added in tvtime 0.9.11.
</p></table><p></p>
<table width="90%" class="doclist">
<tr><th class="docboxleft">ENTER
<tr><td class="docentry"><p>
Sends a virtual enter command. Use this when changing the channel:</p>
<pre>
tvtime-command channel_1 channel_5 enter
</pre>
<p>will change to channel 15.
</p></table><p></p>
<table width="90%" class="doclist">
<tr><th class="docboxleft">FINETUNE_DOWN
<tr><td class="docentry"><p>
Decreases the fine tuning setting for the current channel.
</p></table><p></p>
<table width="90%" class="doclist">
<tr><th class="docboxleft">FINETUNE_UP
<tr><td class="docentry"><p>
Increases the fine tuning for the current channel.
</p></table><p></p>
<table width="90%" class="doclist">
<tr><th class="docboxleft">HUE_DOWN
<tr><td class="docentry"><p>
Decreases the hue setting of the input.
</p></table><p></p>
<table width="90%" class="doclist">
<tr><th class="docboxleft">HUE_UP
<tr><td class="docentry"><p>
Increases the hue setting of the input.
</p></table><p></p>
<table width="90%" class="doclist">
<tr><th class="docboxleft">KEY_EVENT
<tr><td class="docentry"><p>
Sends a fake keystroke event to tvtime. This is useful for
doing complex operations via a remote control, as you can
indirect events to tvtime's internal key binding system.
</p><p>The <b>KEY_EVENT</b> command was added in tvtime 0.9.9.
</p></table><p></p>
<table width="90%" class="doclist">
<tr><th class="docboxleft">LEFT
<tr><td class="docentry"><p>
This command provides the dual functionality of mixer volume down or
menu back command, depending on whether the menu is currently active.
This command is to be used together with the <B>RIGHT</b>, <b>UP</b>
and <b>DOWN</b> commands.
</p><p>The <b>LEFT</b> command was added in tvtime 0.9.11.
</p></table><p></p>
<table width="90%" class="doclist">
<tr><th class="docboxleft">MENU_DOWN
<tr><td class="docentry"><p>
In menu mode, this command moves the cursor down one entry in the menu.
</p><p>The <b>MENU_DOWN</b> command was added in tvtime 0.9.9.
</p></table><p></p>
<table width="90%" class="doclist">
<tr><th class="docboxleft">MENU_ENTER
<tr><td class="docentry"><p>
In menu mode, this command selects the current entry or moves forward
one level in the menu.
</p><p>The <b>MENU_ENTER</b> command was added in tvtime 0.9.9.
</p></table><p></p>
<table width="90%" class="doclist">
<tr><th class="docboxleft">MENU_EXIT
<tr><td class="docentry"><p>
In menu mode, this command shuts off the menu.
</p><p>The <b>MENU_EXIT</b> command was added in tvtime 0.9.9.
</p></table><p></p>
<table width="90%" class="doclist">
<tr><th class="docboxleft">MENU_LEFT
<tr><td class="docentry"><p>
In menu mode, this command moves back one level in the menu.
</p><p>The <b>MENU_LEFT</b> command was added in tvtime 0.9.9.
</p></table><p></p>
<table width="90%" class="doclist">
<tr><th class="docboxleft">MENU_RIGHT
<tr><td class="docentry"><p>
In menu mode, this command selects the current entry or moves forward
one level in the menu.
</p><p>The <b>MENU_RIGHT</b> command was added in tvtime 0.9.9.
</p></table><p></p>
<table width="90%" class="doclist">
<tr><th class="docboxleft">MENU_UP
<tr><td class="docentry"><p>
In menu mode, this command moves the cursor up one entry in the menu.
</p><p>The <b>MENU_UP</b> command was added in tvtime 0.9.9.
</p></table><p></p>
<table width="90%" class="doclist">
<tr><th class="docboxleft">MIXER_DOWN
<tr><td class="docentry"><p>
Decreases the volume setting for the Line In device from
<tt>/dev/mixer</tt>.
An optional parameter specifies the percentage to decrease by.
</p></table><p></p>
<table width="90%" class="doclist">
<tr><th class="docboxleft">MIXER_TOGGLE_MUTE
<tr><td class="docentry"><p>
Toggles the mute status with the mixer, and not with the capture card
like <b>TOGGLE_MUTE</b> does.
</p><p>The <b>MIXER_TOGGLE_MUTE</b> command was added in tvtime 0.9.8.3.
</p></table><p></p>
<table width="90%" class="doclist">
<tr><th class="docboxleft">MIXER_UP
<tr><td class="docentry"><p>
Increases the volume setting for the Line In device from
<tt>/dev/mixer</tt>.
An optional parameter specifies the percentage to increase by.
</p></table><p></p>
<table width="90%" class="doclist">
<tr><th class="docboxleft">NOOP
<tr><td class="docentry"><p>
The command to do nothing. Useful for when you want to blank out one of
the default key bindings in tvtime.
</p><p>The <b>NOOP</b> command was added in tvtime 0.9.11.
</p></table><p></p>
<table width="90%" class="doclist">
<tr><th class="docboxleft">OVERSCAN_DOWN
<tr><td class="docentry"><p>
Decreases the overscan compensation amount. This will show more of the
captured input.
</p></table><p></p>
<table width="90%" class="doclist">
<tr><th class="docboxleft">OVERSCAN_UP
<tr><td class="docentry"><p>
Increases the overscan compensation amount. This will show less of the
captured input.
</p></table><p></p>
<table width="90%" class="doclist">
<tr><th class="docboxleft">PICTURE
<tr><td class="docentry"><p>
Selects which picture setting (brightness/contrast/colour/hue) to change
using the
<b>PICTURE_UP</b>
and
<b>PICTURE_DOWN</b>
commands.
</p><p>The <b>PICTURE</b> command was added in tvtime 0.9.9.
</p></table><p></p>
<table width="90%" class="doclist">
<tr><th class="docboxleft">PICTURE_UP
<tr><td class="docentry"><p>
Increases the current picture setting value (brightness/contrast/colour/hue).
</p><p>The <b>PICTURE_UP</b> command was added in tvtime 0.9.9.
</p></table><p></p>
<table width="90%" class="doclist">
<tr><th class="docboxleft">PICTURE_DOWN
<tr><td class="docentry"><p>
Decreases the current picture setting value (brightness/contrast/colour/hue).
</p><p>The <b>PICTURE_DOWN</b> command was added in tvtime 0.9.9.
</p></table><p></p>
<table width="90%" class="doclist">
<tr><th class="docboxleft">RESTART
<tr><td class="docentry"><p>
Asks tvtime to restart itself. This is used in the menu when we have changed
a value that we can't yet change at runtime.
</p><p>The <b>RESTART</b> command was added in tvtime 0.9.9.
</p></table><p></p>
<table width="90%" class="doclist">
<tr><th class="docboxleft">RIGHT
<tr><td class="docentry"><p>
This command provides the dual functionality of mixer volume up or
menu enter command, depending on whether the menu is currently active.
This command is to be used together with the <b>LEFT</b>, <b>UP</b>
and <b>DOWN</b> commands.
</p><p>The <b>RIGHT</b> command was added in tvtime 0.9.11.
</p></table><p></p>
<table width="90%" class="doclist">
<tr><th class="docboxleft">RUN_COMMAND
<tr><td class="docentry"><p>
Instructs tvtime to spawn a command. This can be used to start a program using
a key in tvtime or lirc, such as to spawn mythepg or alevt. Using
tvtime-command run_command "xterm" will have tvtime call system( "xterm &" ).
</p><p>The <b>RUN_COMMAND</b> command was added in tvtime 0.9.10.
</p></table><p></p>
<table width="90%" class="doclist">
<tr><th class="docboxleft">SAVE_PICTURE_GLOBAL
<tr><td class="docentry"><p>
Saves the current picture settings as the global defaults.
</p><p>The <b>SAVE_PICTURE_GLOBAL</b> command was added in tvtime 0.9.9.
</p></table><p></p>
<table width="90%" class="doclist">
<tr><th class="docboxleft">SAVE_PICTURE_CHANNEL
<tr><td class="docentry"><p>
Saves the current picture settings as the defaults for the current channel
on the tuner.
</p><p>The <b>SAVE_PICTURE_CHANNEL</b> command was added in tvtime 0.9.9.
</p></table><p></p>
<table width="90%" class="doclist">
<tr><th class="docboxleft">SCREENSHOT
<tr><td class="docentry"><p>
Asks
<b>tvtime</b>
to take a screenshot. Screenshots are saved to the directory listed as
the screenshot directory in the
<tt>tvtime.xml</tt>
configuration file. The default is the
running user's home directory.
</p></table><p></p>
<table width="90%" class="doclist">
<tr><th class="docboxleft">SET_AUDIO_MODE
<tr><td class="docentry"><p>
This command takes a parameter and sets the current audio mode. Valid
options are "mono", "stereo", "sap", "lang1" or "lang2".
</p><p>The <b>SET_AUDIO_MODE</b> command was added in tvtime 0.9.9.
</p></table><p></p>
<table width="90%" class="doclist">
<tr><th class="docboxleft">SET_DEINTERLACER
<tr><td class="docentry"><p>
This command takes a parameter and sets the current deinterlacer. Valid
options are the short name of any of the deinterlacers available in tvtime.
</p><p>The <b>SET_DEINTERLACER</b> command was added in tvtime 0.9.9.
</p></table><p></p>
<table width="90%" class="doclist">
<tr><th class="docboxleft">SET_FRAMERATE
<tr><td class="docentry"><p>
This command takes a parameter and sets the current framerate. Valid
options are "full", "top" and "bottom".
</p><p>The <b>SET_FRAMERATE</b> command was added in tvtime 0.9.9.
</p></table><p></p>
<table width="90%" class="doclist">
<tr><th class="docboxleft">SET_FREQUENCY_TABLE
<tr><td class="docentry"><p>
This command takes a parameter and sets the current frequency table.
</p><p>The <b>SET_FREQUENCY_TABLE</b> command was added in tvtime 0.9.9.
</p></table><p></p>
<table width="90%" class="doclist">
<tr><th class="docboxleft">SET_FULLSCREEN_POSITION
<tr><td class="docentry"><p>
This command sets where widescreen output will be aligned when in fullscreen
mode, either top for the top of the screen, center, or bottom.
</p><p>The <b>SET_FULLSCREEN_POSITION</b> command was added in tvtime 0.9.11.
</p></table><p></p>
<table width="90%" class="doclist">
<tr><th class="docboxleft">SET_INPUT
<tr><td class="docentry"><p>
This command takes a parameter and sets the the capture card input (0-n).
Among the Inputs are: the tuner, composite, or S-Video connectors on the
capture card.
</p><p>The <b>SET_INPUT</b> command was added in tvtime 0.9.14.
</p></table><p></p>
<table width="90%" class="doclist">
<tr><th class="docboxleft">SET_INPUT_WIDTH
<tr><td class="docentry"><p>
This command takes a parameter and sets the current input width in pixels.
It will be used in tvtime after a restart.
</p><p>The <b>SET_INPUT_WIDTH</b> command was added in tvtime 0.9.11.
</p></table><p></p>
<table width="90%" class="doclist">
<tr><th class="docboxleft">SET_MATTE
<tr><td class="docentry"><p>
This command sets the matte to apply to the output. This changes the
size of the output window, and is useful for watching a 2.35:1 movie in
a long, thin window, or for watching it at the top of the screen using
the fullscreen position option. Valid options here are 16:9, 1.85:1,
2.35:1 or 4:3.
</p><p>The <b>SET_MATTE</b> command was added in tvtime 0.9.10.
</p></table><p></p>
<table width="90%" class="doclist">
<tr><th class="docboxleft">SET_NORM
<tr><td class="docentry"><p>
This command takes a parameter and sets the current television standard.
It will be used in tvtime after a restart.
</p><p>The <b>SET_NORM</b> command was added in tvtime 0.9.9.
</p></table><p></p>
<table width="90%" class="doclist">
<tr><th class="docboxleft">SET_STATION
<tr><td class="docentry"><p>
This command takes a station name or number as a parameter and changes
the channel to the station given.
</p><p>The <b>SET_STATION</b> command was added in tvtime 0.9.13.
</p></table><p></p>
<table width="90%" class="doclist">
<tr><th class="docboxleft">SET_XMLTV_LANGUAGE
<tr><td class="docentry"><p>
Set the preferred language code for XMLTV data. The argument can be
either the two-letter language code according to ISO 639 or a number
to select one of the known languages.
</p><p>The <b>SET_XMLTV_LANGUAGE</b> command was added in tvtime 0.9.13.
</p></table><p></p>
<table width="90%" class="doclist">
<tr><th class="docboxleft">SET_SHARPNESS
<tr><td class="docentry"><p>
This command takes a parameter and sets the current sharpness in pixels.
It will be used in tvtime after a restart.
</p><p>The <b>SET_SHARPNESS</b> command was added in tvtime 0.9.9 and
replaced by <b>SET_INPUT_WIDTH</b> in tvtime 0.9.11.
</p></table><p></p>
<table width="90%" class="doclist">
<tr><th class="docboxleft">SHOW_DEINTERLACER_INFO
<tr><td class="docentry"><p>
Shows a help screen on the OSD describing the current deinterlacer setting.
</p><p>The <b>SHOW_DEINTERLACER_INFO</b> command was added in tvtime 0.9.9.
</p></table><p></p>
<table width="90%" class="doclist">
<tr><th class="docboxleft">SHOW_MENU
<tr><td class="docentry"><p>
This command is used to bring up the tvtime setup menu.
</p><p>The <b>SHOW_MENU</b> command was added in tvtime 0.9.9.
</p></table><p></p>
<table width="90%" class="doclist">
<tr><th class="docboxleft">SHOW_STATS
<tr><td class="docentry"><p>
Shows a debug screen showing statistics about the running instance of tvtime.
</p></table><p></p>
<table width="90%" class="doclist">
<tr><th class="docboxleft">SLEEP
<tr><td class="docentry"><p>
This command sets the sleep timer to tell tvtime to shut itself off after
a certain amount of time. Sending this command will first activate the feature,
and sending it again will increase the timer up until a maximum value at which
point it is shut off.
</p><p>The <b>SLEEP</b> command was added in tvtime 0.9.10.
</p></table><p></p>
<table width="90%" class="doclist">
<tr><th class="docboxleft">TOGGLE_ALWAYSONTOP
<tr><td class="docentry"><p>
If supported by your window manager, this command will ask to have the
window be put into an "always on top" state, where no other window can
be stacked above it.
</p><p>The <b>TOGGLE_ALWAYSONTOP</b> command was added in tvtime 0.9.9.
</p></table><p></p>
<table width="90%" class="doclist">
<tr><th class="docboxleft">TOGGLE_ASPECT
<tr><td class="docentry"><p>
Toggles the display between 4:3 and 16:9 mode. Use 16:9 mode if you
have configured an external DVD player or satellite receiver to output
anamorphic 16:9 content.
</p></table><p></p>
<table width="90%" class="doclist">
<tr><th class="docboxleft">TOGGLE_AUDIO_MODE
<tr><td class="docentry"><p>
Toggles between the available audio modes on this channel. It can take
some time before the driver discovers that modes are available.
</p></table><p></p>
<table width="90%" class="doclist">
<tr><th class="docboxleft">TOGGLE_BARS
<tr><td class="docentry"><p>
Asks
<b>tvtime</b>
to display colourbars. The colourbars are generated by
<b>tvtime</b>
and are not related to the capture card, but simply to help
configure your video card and display device. Once your settings are
correct with these colourbars, try colourbars from an input source like
an external DVD player and make sure they match up.
</p></table><p></p>
<table width="90%" class="doclist">
<tr><th class="docboxleft">TOGGLE_CC
<tr><td class="docentry"><p>
Enables closed caption information to be displayed in the
<b>tvtime</b>
window.
Closed captioning is only available if you have enabled VBI reading in
your
<tt>tvtime.xml</tt>
configuration file.
</p></table><p></p>
<table width="90%" class="doclist">
<tr><th class="docboxleft">TOGGLE_CHANNEL_PAL_DK
<tr><td class="docentry"><p>
For PAL users, toggles the audio mode of the current channel between
the PAL-BG and PAL-DK audio norms.
</p><p>The <b>TOGGLE_CHANNEL_PAL_DK</b> command was added in tvtime 0.9.13.
</p></table><p></p>
<table width="90%" class="doclist">
<tr><th class="docboxleft">TOGGLE_CHROMA_KILL
<tr><td class="docentry"><p>
Enables or disables the chroma killer filter, which makes the input
black and white. Useful when watching a black-and-white movie to avoid
chrominance artifacts.
</p><p>The <b>TOGGLE_CHROMA_KILL</b> command was added in tvtime 0.9.10.
</p></table><p></p>
<table width="90%" class="doclist">
<tr><th class="docboxleft">TOGGLE_COLOR_INVERT / TOGGLE_COLOUR_INVERT
<tr><td class="docentry"><p>
Turns on or off the colour invert filter. This is (apparently) useful
for users of the Australian cable company Optus who want to avoid using
the decryption boxes and tune using their capture card directly.
</p><p>The <b>TOGGLE_COLOUR_INVERT</b> and <b>TOGGLE_COLOR_INVERT</b> commands were added in tvtime 0.9.9.
</p></table><p></p>
<table width="90%" class="doclist">
<tr><th class="docboxleft">TOGGLE_DEINTERLACER
<tr><td class="docentry"><p>
This toggles between the available deinterlacing methods.
</p></table><p></p>
<table width="90%" class="doclist">
<tr><th class="docboxleft">TOGGLE_FULLSCREEN
<tr><td class="docentry"><p>
This toggles between fullscreen and windowed mode.
</p></table><p></p>
<table width="90%" class="doclist">
<tr><th class="docboxleft">TOGGLE_FRAMERATE
<tr><td class="docentry"><p>
Toggles the framerate at which
<b>tvtime</b>
will output. Options are full frame
rate (every field deinterlaced to a frame), half frame rate TFF (every
top field deinterlaced to a frame) and half frame rate BFF (every bottom
field deinterlaced to a frame).
</p></table><p></p>
<table width="90%" class="doclist">
<tr><th class="docboxleft">TOGGLE_INPUT
<tr><td class="docentry"><p>
Switches the capture card input used. Among the Inputs are: the
tuner, composite, or S-Video connectors on the capture card.
</p></table><p></p>
<table width="90%" class="doclist">
<tr><th class="docboxleft">TOGGLE_MATTE
<tr><td class="docentry"><p>
Switches between the available mattes. This cuts off the top and
bottom of the input picture to help fit the window to the image
content.
</p><p>The <b>TOGGLE_MATTE</b> command was added in tvtime 0.9.9.
</p></table><p></p>
<table width="90%" class="doclist">
<tr><th class="docboxleft">TOGGLE_MIRROR
<tr><td class="docentry"><p>
Turns on or off the mirror filter, which flips the input. This is
useful for using tvtime with mirroring projectors, although I don't
think it will actually work as intended yet since we don't mirror
the OSD output. :) Comments appreciated.
</p><p>The <b>TOGGLE_MIRROR</b> command was added in tvtime 0.9.9.
</p></table><p></p>
<table width="90%" class="doclist">
<tr><th class="docboxleft">TOGGLE_MUTE
<tr><td class="docentry"><p>
Toggles the mute state in the capture card (and not in
your soundcard).
</p></table><p></p>
<table width="90%" class="doclist">
<tr><th class="docboxleft">TOGGLE_NTSC_CABLE_MODE
<tr><td class="docentry"><p>
Toggles the NTSC cable mode settings:
<i>Standard</i>,
<i>IRC</i>, and
<i>HRC</i>
are available.
</p></table><p></p>
<table width="90%" class="doclist">
<tr><th class="docboxleft">TOGGLE_PAL_DK_AUDIO
<tr><td class="docentry"><p>
For PAL users, toggles the default audio mode of all channels between
the PAL-BG and PAL-DK audio norms.
</p><p>The <b>TOGGLE_PAL_DK_AUDIO</b> command was added in tvtime 0.9.13.
</p></table><p></p>
<table width="90%" class="doclist">
<tr><th class="docboxleft">TOGGLE_PAL_SECAM
<tr><td class="docentry"><p>
Toggles between PAL and SECAM on the current channel. This feature is
useful for regions which receive both PAL and SECAM channels, such that
tvtime can be configured on a per-channel basis for the correct norm.
</p><p>The <b>TOGGLE_PAL_SECAM</b> command was added in tvtime 0.9.9.
</p></table><p></p>
<table width="90%" class="doclist">
<tr><th class="docboxleft">TOGGLE_PAUSE
<tr><td class="docentry"><p>
Enters pause mode. Pause mode is a debugging feature used to
test deinterlacer filters by allowing to see the output of a single set
of frames with various deinterlacers.
</p></table><p></p>
<table width="90%" class="doclist">
<tr><th class="docboxleft">TOGGLE_PULLDOWN_DETECTION
<tr><td class="docentry"><p>
Enables or disables the 2-3 pulldown detection feature for NTSC input.
</p></table><p></p>
<table width="90%" class="doclist">
<tr><th class="docboxleft">TOGGLE_SIGNAL_DETECTION
<tr><td class="docentry"><p>
Toggles on and off tvtime's signal detection code. Signal detection enables
features like channel scanning and increases responsiveness on channels with
poor reception, but may make it impossible to watch stations where the
reception is too bad for the card to detect it reliably.
</p><p>The <b>TOGGLE_SIGNAL_DETECTION</b> command was added in tvtime 0.9.10.
</p></table><p></p>
<table width="90%" class="doclist">
<tr><th class="docboxleft">TOGGLE_XDS
<tr><td class="docentry"><p>
Toggles on and off tvtime's XDS decoding code. XDS is used to send information
about the channel including the network name and call letters, and
sometimes information about the current show. This information is then shown
on the OSD and saved to the stationlist.xml file.
</p><p>The <b>TOGGLE_XDS</b> command was added in tvtime 0.9.10.
</p></table><p></p>
<table width="90%" class="doclist">
<tr><th class="docboxleft">TOGGLE_XMLTV_LANGUAGE
<tr><td class="docentry"><p>
Toggles which language to show by default from the XMLTV file from
the ones available in the file.
</p><p>The <b>TOGGLE_XMLTV_LANGUAGE</b> command was added in tvtime 0.9.13.
</p></table><p></p>
<table width="90%" class="doclist">
<tr><th class="docboxleft">UP
<tr><td class="docentry"><p>
This command provides the dual functionality of channel up or menu arrow up,
depending on whether the menu is currently active. This command is to be
used together with the <b>LEFT</b>, <b>RIGHT</b> and <b>DOWN</b> commands.
</p><p>The <b>UP</b> command was added in tvtime 0.9.11.
</p></table><p></p>
<table width="90%" class="doclist">
<tr><th class="docboxleft">QUIT
<tr><td class="docentry"><p>
Asks the running
<b>tvtime</b>
process to exit.
</p></table><p></p>
</td></tr>
</table>
</td></tr>
</table>
</body>
</html>
