tvtime(1)
NAME
tvtime - a high quality television application
SYNOPSIS
tvtime [ OPTION ] ...
DESCRIPTION
tvtime is a high quality television application for use with video
capture cards. tvtime processes the input from a capture card and
displays it on a computer monitor or projector.
tvtime supports:
* Deinterlaced output at full interlaced rate of 59.94 frames per
second for NTSC source, or 50 frames per second for PAL sources.
This gives smoothness of motion and high visual quality.
* Multiple deinterlacing algorithms for finding the optimal mode for
the video content and available processor speed.
* 16:9 aspect ratio mode for the highest available resolution when
processing input from an external DVD player or digital satellite
receiver.
* A super-slick on-screen-display for the complete television
experience, with a featureful menu system.
USAGE
Here are the core set of key bindings you want to learn for using
tvtime:
Escape or q Quit
F1 or tab Show menu
u Show channel list
up/down Change channels
0-9 and Enter Change channels
Backspace Jump to previous channel
i Change input
m Mute
+/- or left/right Volume control
f Fullscreen
s Take a screenshot
Enter Display info
d Display debug statistics
g Shows TV Guide using the TV listings from
XMLTV
Here are some advanced keys. These features are all configurable via
the menu, but some of these may be useful if you use the features
often:
e Toggle audio mode (stereo/mono/SAP)
v Toggle always-on-top with supporting window managers
F5/F6/F7
Picture settings
Space Restore default picture settings
/ Resize the window to match the content inside it (after
applying a matte or switching to 16:9 mode)
c Toggle closed caption decoding (NTSC only)
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.
-k, --slave
Disables keyboard input in tvtime for slave mode. Slave mode
was added for integration with PVR applications like freevo or
mythtv, so that freevo can handle keyboard input while tvtime is
running. In slave mode, keystrokes are ignored but they are
printed to standard output, and commands are read from standard
input in the same syntax as tvtime-command.
-m, --fullscreen
Start tvtime in fullscreen mode.
-M, --window
Start tvtime in windowed mode.
-s, --showdrops
Print frame skip information (for debugging).
-S, --saveoptions
Save command line options to the config file. This will save
the V4L device, VBI device, input number, norm, frequency,
startup fullscreen setting, aspect ratio, verbose mode, and
output window height.
-v, --verbose
The verbose setting indicates that we should print full
informational and warning messages to standard error while
running tvtime. Otherwise, only critical errors will be printed
to the output.
-F, --configfile=FILE
Additional config file to load settings from.
-g, --geometry=GEOMETRY
Sets the geometry of the window, for example, 400x300 for a
window 400 pixels wide and 300 pixels tall. A width value of 0
signifies that the appropriate width for the given height will
be used. For 4:3 content on a square pixel display, this
defaults to a 768576 window.
-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 auto).
-l, --audioloopback
This sets the audio loopback mode. The audio loopback mode is
required when capture card is not connected to the sound card
via a cable. In this case, tvtime needs to map the audio from
the internal digital capture out to sound card.
-L, --noaudioloopback
Disable audio loopback mode.
-b, --vbidevice=DEVICE
VBI device to use (defaults to auto).
-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:
* NTSC
* PAL
* SECAM
* PAL-NC
* PAL-M
* PAL-N
* NTSC-JP
-f, --frequencies=NAME
The channels you are receiving with the tuner (defaults to
us-cable). Valid values are:
* us-cable
* us-broadcast
* japan-cable
* japan-broadcast
* europe
* australia
* australia-optus
* newzealand
* france
* russia
* custom (first run 'tvtime-scanner')
-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.
-T, --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, --display=DISPLAY
Uses the given X display to connect to.
-x, --mixer=DEVICE[:CH]|DEVICE/CH
The mixer device and channel for the volume controls. The first
variant sets the OSS mixer the second one ALSA. (defaults to
default/Master). Valid channels for OSS are:
* vol
* bass
* treble
* synth
* pcm
* speaker
* line
* mic
* cd
* mix
* pcm2
* rec
* igain
* ogain
* line1
* line2
* line3
* dig1
* dig2
* dig3
* phin
* phout
* video
* radio
* monitor
FILES
/tvtime/tvtime.xml $HOME/.tvtime/tvtime.xml $HOME/.tvtime/stationlist.xml /var/run/tvtime/TV-*/tvtimefifo
AUTHORS
Billy Biggs, Doug Bell, Alexander S. Belov, Achim Schneider, David I. Lehn, Paul Jara, Robert Hgberg, Craig Dooley, Bart Dorsey, Nicolas Boos, Simon Law, Mark Trolley, Joachim Koenig, Stewart Allen, Justin A, Brian Goines, Krister Lagerstrom.
SEE ALSO
tvtime-command(1), tvtime-configure(1), tvtime-scanner(1), tvtime.xml(5), stationlist.xml(5).
Opportunity
Personal Opportunity - Free software gives you access to billions of dollars of software at no cost. Use this software for your business, personal use or to develop a profitable skill. Access to source code provides access to a level of capabilities/information that companies protect though copyrights. Open source is a core component of the Internet and it is available to you. Leverage the billions of dollars in resources and capabilities to build a career, establish a business or change the world. The potential is endless for those who understand the opportunity.
Business Opportunity - Goldman Sachs, IBM and countless large corporations are leveraging open source to reduce costs, develop products and increase their bottom lines. Learn what these companies know about open source and how open source can give you the advantage.
Free Software
Free Software provides computer programs and capabilities at no cost but more importantly, it provides the freedom to run, edit, contribute to, and share the software. The importance of free software is a matter of access, not price. Software at no cost is a benefit but ownership rights to the software and source code is far more significant.
Free Office Software - The Libre Office suite provides top desktop productivity tools for free. This includes, a word processor, spreadsheet, presentation engine, drawing and flowcharting, database and math applications. Libre Office is available for Linux or Windows.
Free Books
The Free Books Library is a collection of thousands of the most popular public domain books in an online readable format. The collection includes great classical literature and more recent works where the U.S. copyright has expired. These books are yours to read and use without restrictions.
Source Code - Want to change a program or know how it works? Open Source provides the source code for its programs so that anyone can use, modify or learn how to write those programs themselves. Visit the GNU source code repositories to download the source.
Education
Study at Harvard, Stanford or MIT - Open edX provides free online courses from Harvard, MIT, Columbia, UC Berkeley and other top Universities. Hundreds of courses for almost all major subjects and course levels. Open edx also offers some paid courses and selected certifications.
Linux Manual Pages - A man or manual page is a form of software documentation found on Linux/Unix operating systems. Topics covered include computer programs (including library and system calls), formal standards and conventions, and even abstract concepts.
