bionic (5) tvtime.xml.5.gz

Provided by: tvtime_1.0.11-1_amd64 bug

NAME

       tvtime.xml - tvtime configuration file

SYNOPSIS

       ~/.tvtime/tvtime.xml
       /etc/tvtime/tvtime.xml

DESCRIPTION

       The  tvtime.xml  file is the main configuration file for tvtime.  It contains all of the default settings
       and key bindings.  The tvtime.xml file is  updated  by  tvtime  at  runtime,  to  store  settings  across
       sessions.   For  this  reason,  you  should not edit the tvtime.xml file while tvtime is running, as your
       changes may be overwritten.

       The global syntax is as follows:

           <?xml version="1.0"?>
           <!DOCTYPE tvtime PUBLIC "-//tvtime//DTD tvtime 1.0//EN"
             "http://tvtime.sourceforge.net/DTD/tvtime1.dtd">
           <tvtime xmlns="http://tvtime.sourceforge.net/DTD/">
           </tvtime>

       You   can   find   the   DTD   and   other   information   about   the   XML   configuration   files   at
       http://tvtime.sourceforge.net/DTD/http://tvtime.sourceforge.net/DTD/

OPTIONS

       tvtime supports a multitude of options.  The <option> tag should be contained within a <tvtime> tag.

       The  following is a list of options and their default values, along with a description of what the option
       does.

       <option name="Verbose" value="0"/>
              The verbose setting indicates that we should print full  informational  and  warning  messages  to
              stderr while running tvtime.  Otherwise, only fatal errors will be printed to the output.

       <option name="V4LDevice" value="/dev/video0"/>
              This sets the default capture device to use.

       <option name="V4LInput" value="0"/>
              This  sets  the default capture card input to be opened by tvtime.  For example, for my WinTV card
              has the tuner as source 0, and its composite input as source 1.  Sources can be changed at runtime
              using the toggle_input command, which is key command “i” by default.

       <option name="Norm" value="NTSC"/>
              This sets the default TV norm.  Valid options are:

              •   NTSC
              •   NTSC-JP
              •   SECAM
              •   PAL
              •   PAL-Nc
              •   PAL-M
              •   PAL-N
              •   PAL-60

       <option name="SaveAndRestorePictureSettings" value="1"/>
              This  option  indicates  whether  tvtime  should  enable  its  own saving and restoring of picture
              settings, both on startup and per channel change.

       <option name="AudioMode" value="stereo"/>
              This option saves the last used audio mode.  This will be used to remember  which  audio  mode  to
              select  when  the  application is next started.  Valid options here are "mono", "stereo", "lang1",
              "lang2" or "sap".

       <option name="AudioBoost" value="-1"/>
              This option sets the audio boost.  This is a percentage for how much to set the volume coming  out
              of  the  capture  card.   By  default, tvtime does not set the audio at all.  However, because the
              volume sometimes does not have a sane default, or is reset by other applications, you can use this
              value to have it always set to your favorite volume.  Use -1 to have tvtime not touch the volume.

       <option name="ShowCC" value="0"/>
              This option saves the state of closed caption decoding.  Closed captions are an NTSC-specific text
              version of the audio for the hearing impaired.

       <option name="ColourInvert" value="0"/>
              This value saves the on-off state of the colour invert filter across sessions.

       <option name="MirrorInput" value="0"/>
              This value saves the on-off state of the mirror filter across sessions.

       <option name="Frequencies" value="US-Cable"/>
              This sets the default frequency table to use for any tuners found.  Possibilities are:

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

       <option name="NTSCCableMode" value="Standard"/>
              There are two special NTSC cable standards in the US: IRC and HRC.  In IRC, channels 5 and  6  are
              on  different frequencies, and HRC mode shifts all frequencies up by 1.25MHz (and is also weird on
              channels 5 and 6).  Use this option to set the cable mode to Standard, IRC, or HRC.   It  is  very
              rare that you will see cable systems that use IRC or HRC cable.

       <option name="CheckForSignal" value="1"/>
              Toggle  whether  tvtime  should check if there is a signal present when changing channels etc.  If
              your card doesn't suck, you shouldn't need to shut this off.  Disabling  this  feature  will  also
              disable the channel scanner.

       <option name="InputWidth" value="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.  Most capture  cards  cannot  sample
              higher than 768 pixels per scanline.

       <option name="XMLTVFile" value="none"/>
              Set  this to a filename to get show listings from an xmltv file.  Set to "none" if you do not wish
              to use xmltv.

       <option name="XMLTVLanguage" value="none"/>
              Set this to a two-letter language code to set the language to use for entries in  the  XMLTV  file
              (for  example, use "de" for German).  Set to "none" if you wish to use the default language of the
              file.

       <option name="UseXDS" value="0"/>
              Set this to 1 to enable XDS channel  information  decoding.   This  option  is  specific  to  NTSC
              regions.   XDS  is  used to send information about the channel including the network name and call
              letters, and sometimes information about the current show.

       <option name="VBIDevice" value="/dev/vbi0"/>
              This sets which device to use for VBI decoding.

       <option name="MixerDevice" value="/dev/mixer:line"/>
              This sets the mixer device and channel to use.  The format is device  name:channel  name  for  OSS
              mixer (e.g., "/dev/mixer:Line") or device/channel for ALSA (e.g., "hw:0/CD").

              Valid OSS 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

       <option name="SquarePixels" value="1"/>
              Disabling this option tells tvtime to use the X server DPI to determine pixel shape.  By  default,
              tvtime assumes pixels are square.  Set this to 0 if you have a 4:3 monitor but run it at 1280x1024
              and want tvtime to do the right thing.

       <option name="Widescreen" value="0"/>
              This option enables 16:9 aspect ratio mode by default on startup.

       <option name="WindowGeometry" value="0x576"/>
              Sets the geometry of the window.  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.

       <option name="Overscan" value="0.0"/>
              This sets the percent of the sides to leave to the overscan, that is,  don't  show  them  at  all.
              Safe  action  area  on  a television is 10% in the overscan, but that's a bit restrictive.  If you
              want tvtime to look like a TV, a good value would be about 6–8%.  The value is in percent, so  for
              8%, use 8.0.

       <option name="Fullscreen" value="0"/>
              Set  this  to  1  to have tvtime start in fullscreen mode.  This setting is set at runtime so that
              when you quit tvtime in fullscreen, starting it again will start back in fullscreen mode.

       <option name="AlwaysOnTop" value="0"/>
              Set this to 1 to have tvtime start in always-on-top mode under supporting window  managers.   This
              setting  is  set  at runtime so that when you quit tvtime in always-on-top mode, starting it again
              will start back in always-on-top mode.

       <option name="FullscreenPosition" value="Centre"/>
              Sets the position of the output when in fullscreen mode: top, bottom or centre.  When set to  top,
              tvtime  in fullscreen will place its output at the top of the screen.  Use if you have a projector
              to help tvtime fit properly onto your screen.

       <option name="FramerateMode" value="0"/>
              This sets the framerate of the output from tvtime.

              0   Full framerate mode, every field is deinterlaced.  59.94fps for NTSC, 50fps for PAL.

              1   Half framerate mode, deinterlace every top field to a frame (TFF).  29.97fps for  NTSC,  25fps
                  for PAL.

              2   Half  framerate  mode,  deinterlace  every  bottom field to a frame (BFF).  29.97fps for NTSC,
                  25fps for PAL.

              The two half framerate modes are useful for progressive content from  video  game  consoles.   Use
              weave and select either TFF or BFF, whichever does not exhibit interlace effects.

       <option name="QuietScreenshots" value="0"/>
              When  this  option  is  turned  on,  screenshots will not announce themselves on the OSD.  This is
              useful if you intend to take a lot of screenshots, and don't want the text to  interrupt  your  TV
              watching or appear in other screenshots.

       <option name="ProcessPriority" value="-10"/>
              Sets  the  default  process priority.  By default, tvtime tries to set itself at a priority of –10
              which higher than normal applications.  Acceptable values are from –20 to 20,  with  lower  values
              meaning higher priority.

       <option name="TimeFormat" value="%X"/>
              Sets  the  time  format to be used in the tvtime on-screen display.  The format is a string in the
              same format as strftime(3).  The default is to use the time format of your locale.

       <option name="ScreenShotDir" value="~"/>
              This is the default directory in which screenshots are placed.  The default is to save  them  into
              the user's home directory.

       <option name="ChannelTextFG" value="0xFFFFFF00"/>
       <option name="OtherTextFG" value="0xFFF5DEB3"/>
              These  options  set  the ARGB colours used for the text in the on-screen display.  The default for
              the channel name is “yellow” (0xffffff00), and the default for the  surrounding  text  is  “wheat”
              (0xfff5deb3).   The  colour  format  can  be  hexadecimal or decimal.  If the alpha channel is not
              specified the default is “opaque” (255).

              Examples: 0xffaadd, 0xff0000ff, 0xff, 0xffff, 255 255 0, 0, 16777215.

       <option name="UnmuteVolume" value="-1"/>
              This setting saves the volume before muting across tvtime sessions.  You should not ever  need  to
              set this yourself.

       <option name="Muted" value="0"/>
              This  setting  saves whether or not tvtime was muted when it was last exited.  You should not ever
              need to set this yourself.

       <option name="MuteOnExit" value="0"/>
              This setting controls whether tvtime should mute its mixer device  on  exit.   Use  this  to  work
              around noisy capture cards.

       <option name="ShowTaglines" value="1"/>
              This  setting controls whether tvtime should show the silly taglines in the window title bar.  Set
              to 0 to shut them off.

       <option name="PrevChannel" value="2"/>
              This setting is saved at runtime to remember the previous channel.

       <option name="Channel" value="2"/>
              This setting is saved at runtime to remember the current channel.

       <option name="DeinterlaceMethod" value="AdaptiveAdvanced"/>
              This setting is saved at runtime to remember the deinterlacer used.

              Supported deinterlacers are:

              TelevisionFull Television: Full Resolution
              TelevisionHalf Television: Half Resolution
              BlurVertical   Blur: Vertical
              BlurTemporal   Blur: Temporal
              AdaptiveSearch Motion Adaptive: Motion Search
              AdaptiveAdvanced
                             Motion Adaptive: Advanced Detection
              AdaptiveSimple Motion Adaptive: Simple Detection
              ProgressiveTFF Progressive: Top Field First
              ProgressiveBFF Progressive: Bottom Field First

BINDINGS

       Key presses and mouse button clicks can be mapped to tvtime commands.  For a description of each command,
       see tvtime-command(1).

       Multiple  keys  and  mouse  buttons  may  be bound to the same command.  For convenience, tvtime supplies
       aliases for special keys.  The special keys known to tvtime are:

       Up, Down, Left, Right, Insert, Home, End,R PageUp, PageDown, F1, F2, F3, F4, F5, F6,  F7,  F8,  F9,  F10,
       F11, F12, F13, F14, F15, Backspace, Escape, Enter, Print, Menu

       An  example  key binding would be for the command CHANNEL_INC.  In this case, we have two keys (Up and k)
       bound to the command as well as a mouse button (4).

           <bind command="channel_inc">
             <keyboard key="up"/>
             <keyboard key="k"/>
             <mouse button="4"/>
           </bind>

       Some commands can take arguments, for example, the SCREENSHOT  command  can  take  an  argument  for  the
       filename.  Arguments can be given to a key binding as follows:

           <bind command="screenshot" argument="/tmp/last-screenshot.png">
             <keyboard key="s"/>
           </bind>

AUTHOR

       Billy Biggs.

SEE ALSO

       tvtime(1), tvtime-configure(1), tvtime-command(1), tvtime-scanner(1), stationlist.xml(5).