Provided by: tvtime_1.0.2-10ubuntu10_amd64 bug

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 768×576 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 /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:

              •   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.

       -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, --display=DISPLAY
              Uses the given X display to connect to.

       -x, --mixer=DEVICE[:CH]
              The  mixer  device  and   channel   for   the   volume   controls.   (defaults   to
              /dev/mixer:line).  Valid channels 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 Högberg, 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).