.\" Man page for tvtime.xml.\" Copyright (c) 2003, 2004  Billy Biggs.\".\" This program is free software; you can redistribute it and/or modify.\" it under the terms of the GNU General Public License as published by.\" the Free Software Foundation; either version 2 of the License, or (at.\" your option) any later version..\".\" This program is distributed in the hope that it will be useful, but.\" WITHOUT ANY WARRANTY; without even the implied warranty of.\" MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU.\" General Public License for more details..\".\" You should have received a copy of the GNU General Public License.\" along with this program; if not, write to the Free Software.\" Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA..\".TH tvtime.xml 5 "October 2004" "tvtime 1.0RC1".SH NAMEtvtime.xml \- tvtime configuration file.SH SYNOPSIS.I ~/.tvtime/tvtime.xml.br.I /etc/tvtime/tvtime.xml.br.SH DESCRIPTIONThe.I tvtime.xmlfile is the main configuration file for.BR tvtime .It contains all of the default settings and key bindings.  The.I tvtime.xmlfile is updated by.B tvtimeat runtime, to store settings across sessions.  For this reason, youshould not edit the.I tvtime.xmlfile while.B tvtimeis 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 configurationfiles at.nh.UR http://tvtime.sourceforge.net/DTD/http://tvtime.sourceforge.net/DTD/.UE.hy.SH OPTIONS.B tvtimesupports a multitude of options.  The <option> tag should be containedwithin a <tvtime> tag.The following is a list of options and their default values, along witha description of what the option does..TP<option name="Verbose" value="0"/>The verbose setting indicates that we should print full informationaland warning messages to stderr while running.BR tvtime .Otherwise, only fatal errors will be printed to the output..TP<option name="V4LDevice" value="/dev/video0"/>This sets the default capture device to use..TP<option name="V4LInput" value="0"/>This sets the default capture card input to be opened by.BR tvtime .For example, for my WinTV card has the tuner as source.IR 0 ,and its composite input as source.IR 1 .Sources can be changed at runtime using the.B toggle_inputcommand, which is key command \(lqi\(rq by default..TP<option name="Norm" value="NTSC"/>This sets the default TV norm.  Valid options are:.TSnokeep tab (@);l l.\(bu@NTSC\(bu@NTSC\-JP\(bu@SECAM\(bu@PAL\(bu@PAL\-Nc\(bu@PAL\-M\(bu@PAL\-N\(bu@PAL\-60.TE.TP<option name="SaveAndRestorePictureSettings" value="1"/>This option indicates whether.Btvtimeshould enable its own saving and restoring of picture settings,both on startup and per channel change..TP<option name="AudioMode" value="stereo"/>.BThis option saves the last used audio mode.  This will be used toremember which audio mode to select when the application is nextstarted.  Valid options here are "mono", "stereo", "lang1", "lang2"or "sap"..TP<option name="AudioBoost" value="-1"/>.BThis option sets the audio boost.  This is a percentage for howmuch to set the volume coming out of the capture card.  By default,tvtime does not set the audio at all.  However, because the volumesometimes does not have a sane default, or is reset by otherapplications, you can use this value to have it always set to yourfavorite volume.  Use -1 to have tvtime not touch the volume..TP<option name="ShowCC" value="0"/>.BThis option saves the state of closed caption decoding.  Closedcaptions are an NTSC-specific text version of the audio for thehearing impaired..TP<option name="ColourInvert" value="0"/>.BThis value saves the on-off state of the colour invert filter acrosssessions..TP<option name="MirrorInput" value="0"/>.BThis value saves the on-off state of the mirror filter across sessions..TP<option name="Frequencies" value="US-Cable"/>This sets the default frequency table to use for any tuners found.Possibilities are:.TSnokeep tab (@);l l.\(bu@us-cable\(bu@us-broadcast\(bu@japan-cable\(bu@japan-broadcast\(bu@europe\(bu@australia\(bu@australia-optus\(bu@newzealand\(bu@france\(bu@russia.TE.TP<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 modeshifts all frequencies up by 1.25MHz (and is also weird on channels 5and 6).  Use this option to set the cable mode to .IR Standard ,.IR IRC ", or ".IR HRC .It is very rare that you will see cable systems that use IRC orHRC cable..TP<option name="CheckForSignal" value="1"/>Toggle whether.B tvtimeshould 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..TP<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 doless work, and so.B tvtimewill run faster.  If you have a slower CPU (like, less than 500Mhz orso), maybe values of.IR 480 " or " 400might suit you best.  For best quality, choose a high value like.IR 720 " or " 768 .Most capture cards cannot sample higher than.I 768pixels per scanline..TP<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..TP<option name="XMLTVLanguage" value="none"/>Set this to a two-letter language code to set the language to usefor 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..TP<option name="UseXDS" value="0"/>Set this to.I 1to enable XDS channel information decoding.  Thisoption is specific to NTSC regions.  XDS is used to send informationabout the channel including the network name and call letters, andsometimes information about the current show..TP<option name="VBIDevice" value="/dev/vbi0"/>This sets which device to use for VBI decoding..TP<option name="MixerDevice" value="/dev/mixer:line"/>This sets the mixer device and channel to use.  The format is devicename:channel name.  Valid channels are:.nh.IR vol ", " bass ", " treble ", " synth ", " pcm ", " speaker ", ".IR line ", "  mic ", "  cd ", "  mix ", "  pcm2 ", " rec ", " .IR igain ", "  ogain ", "  line1 ", "  line2 ", "  line3 ", ".IR dig1 ", "  dig2 ", "  dig3 ", "  phin ", " phout ", " video ", ".IR radio ", "  monitor.hy.TP<option name="SquarePixels" value="1"/>Disabling this option tells tvtime to use the X server DPI to determinepixel shape.  By default, tvtime assumes pixels are square.  Set thisto 0 if you have a 4:3 monitor but run it at 1280x1024 and want tvtimeto do the right thing..TP<option name="Widescreen" value="0"/>This option enables 16:9 aspect ratio mode by default on startup..TP<option name="WindowGeometry" value="0x576"/>Sets the geometry of the window.  A width value of 0 signifies that theappropriate width for the given height will be used.  For 4:3 contenton a square pixel display, this defaults to a .RI 768\[mu] 576window..TP<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% inthe overscan, but that's a bit restrictive.  If you want.B tvtimeto look like a TV, a good value would be about 6\[en]8%.  The value isin percent, so for 8%, use.IR 8.0 ..TP<option name="Fullscreen" value="0"/>Set this to.I 1to have.B tvtimestart in fullscreen mode.  This setting is set at runtime so that when you quit.B tvtimein fullscreen, starting it again will start back in fullscreen mode..TP<option name="AlwaysOnTop" value="0"/>Set this to.I 1to have.B tvtimestart in always-on-top mode under supporting window managers.  Thissetting is set at runtime so that when you quit.B tvtimein always-on-top mode, starting it again will start back inalways-on-top mode..TP<option name="FullscreenPosition" value="Centre"/>Sets the position of the output when in fullscreen mode:.I top,.I bottomor.I centre.When set to.I top,.B tvtimein fullscreen will place its output at the top of the screen.  Useif you have a projector to help.B tvtimefit properly onto your screen..TP<option name="FramerateMode" value="0"/>This sets the framerate of the output from.BR tvtime ..RS.TP 4.I 0Full framerate mode, every field is deinterlaced.59.94fps for NTSC, 50fps for PAL..TP.I 1Half framerate mode, deinterlace every top field to a frame (TFF).29.97fps for NTSC, 25fps for PAL..TP.I 2Half framerate mode, deinterlace every bottom field to a frame (BFF).29.97fps for NTSC, 25fps for PAL..RE.IPThe two half framerate modes are useful for progressive content fromvideo game consoles.  Use weave and select either TFF or BFF, whicheverdoes not exhibit interlace effects..TP<option name="QuietScreenshots" value="0"/>When this option is turned on, screenshots will not announce themselveson 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 otherscreenshots..TP<option name="ProcessPriority" value="-10"/>Sets the default process priority.  By default,.B tvtimetries to set itself at a priority of.I \[en]10which higher than normal applications.  Acceptable values are from.IR \[en]20 " to " 20 ,with lower values meaning higher priority..TP<option name="TimeFormat" value="%X"/>Sets the time format to be used in the.B tvtimeon\-screen display.  The format is a string in the same format as.BR strftime (3).The default is to use the time format of your locale..TP<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..TP.PD 0<option name="ChannelTextFG" value="0xFFFFFF00"/>.TP.PD<option name="OtherTextFG" value="0xFFF5DEB3"/>These options set the ARGB colours used for the text in the on-screendisplay.  The default for the channel name is \(lqyellow\(rq.RI ( 0xffffff00 ),and the default for the surrounding text is \(lqwheat\(rq.RI ( 0xfff5deb3 ).The colour format can be hexadecimal or decimal.  If the alpha channelis not specified the default is \(lqopaque\(rq.RI ( 255 )..RS.TP 10Examples:.IR 0xffaadd ,.IR 0xff0000ff ,.IR 0xff ,.IR 0xffff ,.IR "255 255 0" ,.IR 0 ,.IR 16777215 ..RE.TP<option name="UnmuteVolume" value="-1"/>This setting saves the volume before muting across tvtime sessions.You should not ever need to set this yourself..TP<option name="Muted" value="0"/>This setting saves whether or not tvtime was muted when it was lastexited.  You should not ever need to set this yourself..TP<option name="MuteOnExit" value="0"/>This setting controls whether tvtime should mute its mixer device onexit.  Use this to work around noisy capture cards..TP<option name="ShowTaglines" value="1"/>This setting controls whether tvtime should show the silly taglinesin the window title bar.  Set to 0 to shut them off..TP<option name="PrevChannel" value="2"/>This setting is saved at runtime to remember the previous channel..TP<option name="Channel" value="2"/>This setting is saved at runtime to remember the current channel..TP<option name="DeinterlaceMethod" value="AdaptiveAdvanced"/>This setting is saved at runtime to remember the deinterlacer used.Supported deinterlacers are:.RS.TP 15.PD 0.I TelevisionFullTelevision: Full Resolution.TP.I TelevisionHalfTelevision: Half Resolution.TP.I BlurVerticalBlur: Vertical.TP.I BlurTemporalBlur: Temporal.TP.I AdaptiveSearchMotion Adaptive: Motion Search.TP.I AdaptiveAdvancedMotion Adaptive: Advanced Detection.TP.I AdaptiveSimpleMotion Adaptive: Simple Detection.TP.I ProgressiveTFFProgressive: Top Field First.TP.I ProgressiveBFFProgressive: Bottom Field First.PD.RE.SH BINDINGSKey presses and mouse button clicks can be mapped to.B tvtimecommands.  For a description of each command, see.BR tvtime-command (1).Multiple keys and mouse buttons may be bound to the same command.  Forconvenience,.B tvtimesupplies aliases for special keys.  The special keys known to.B tvtimeare:.nh.IR Up ", " Down ", " Left ", " Right ", " Insert ", " Home ", " End ",R ".IR PageUp ", " PageDown ", " F1 ", " F2 ", " F3 ", " F4 ", " F5 ", ".IR F6 ", " F7 ", " F8 ", " F9 ", " F10 ", " F11 ", " F12 ", " F13 ", ".IR F14 ", " F15 ", " Backspace ", " Escape ", " Enter ", " Print ", " Menu.hyAn example key binding would be for the command.IR CHANNEL_INC .In this case, we have two keys .RI ( Up " and " k )bound to the command as well as a mouse button.RI ( 4 ).    <bind command="channel_inc">      <keyboard key="up"/>      <keyboard key="k"/>      <mouse button="4"/>    </bind>Some commands can take arguments, for example, the.IT SCREENSHOTcommand can take an argument for the filename.  Arguments can be givento a key binding as follows:    <bind command="screenshot" argument="/tmp/last-screenshot.png">      <keyboard key="s"/>    </bind>.SH AUTHORBilly Biggs..SH "SEE ALSO".BR tvtime (1),.BR tvtime-configure (1),.BR tvtime-command (1),.BR tvtime-scanner (1),.IR stationlist.xml (5).