1tvtime.xml(5) File Formats Manual tvtime.xml(5)
2
6 tvtime.xml - tvtime configuration file
7
10 ~/.tvtime/tvtime.xml
11 /etc/tvtime/tvtime.xml
12
15 The tvtime.xml file is the main configuration file for tvtime. It con‐
16 tains all of the default settings and key bindings. The tvtime.xml
17 file is updated by tvtime at runtime, to store settings across ses‐
18 sions. For this reason, you should not edit the tvtime.xml file while
19 tvtime is running, as your changes may be overwritten.
20 The global syntax is as follows:
22 <?xml version="1.0"?>
24 <!DOCTYPE tvtime PUBLIC "-//tvtime//DTD tvtime 1.0//EN"
25 "http://tvtime.sourceforge.net/DTD/tvtime1.dtd">
26 <tvtime xmlns="http://tvtime.sourceforge.net/DTD/">
27 </tvtime>
28 You can find the DTD and other information about the XML configuration
30 files at http://tvtime.sourceforge.net/DTD/
31 ⟨http://tvtime.sourceforge.net/DTD/⟩
32
35 tvtime supports a multitude of options. The <option> tag should be
36 contained within a <tvtime> tag.
37 The following is a list of options and their default values, along with
39 a description of what the option does.
40 <option name="Verbose" value="0"/>
43 The verbose setting indicates that we should print full informa‐
44 tional and warning messages to stderr while running tvtime.
45 Otherwise, only fatal errors will be printed to the output.
46 <option name="V4LDevice" value="/dev/video0"/>
49 This sets the default capture device to use.
50 <option name="V4LInput" value="0"/>
53 This sets the default capture card input to be opened by tvtime.
54 For example, for my WinTV card has the tuner as source 0, and
55 its composite input as source 1. Sources can be changed at run‐
56 time using the toggle_input command, which is key command “i” by
57 default.
58 <option name="Norm" value="NTSC"/>
61 This sets the default TV norm. Valid options are:
62 · NTSC
64 · NTSC-JP
65 · SECAM
66 · PAL
67 · PAL-Nc
68 · PAL-M
69 · PAL-N
70 · PAL-60
71 <option name="SaveAndRestorePictureSettings" value="1"/>
74 This option indicates whether tvtime should enable its own sav‐
75 ing and restoring of picture settings, both on startup and per
76 channel change.
77 <option name="AudioMode" value="stereo"/>
80 This option saves the last used audio mode. This will be used
81 to remember which audio mode to select when the application is
82 next started. Valid options here are "mono", "stereo", "lang1",
83 "lang2" or "sap".
84 <option name="AudioBoost" value="-1"/>
87 This option sets the audio boost. This is a percentage for how
88 much to set the volume coming out of the capture card. By de‐
89 fault, tvtime does not set the audio at all. However, because
90 the volume sometimes does not have a sane default, or is reset
91 by other applications, you can use this value to have it always
92 set to your favorite volume. Use -1 to have tvtime not touch
93 the volume.
94 <option name="ShowCC" value="0"/>
97 This option saves the state of closed caption decoding. Closed
98 captions are an NTSC-specific text version of the audio for the
99 hearing impaired.
100 <option name="ColourInvert" value="0"/>
103 This value saves the on-off state of the colour invert filter
104 across sessions.
105 <option name="MirrorInput" value="0"/>
108 This value saves the on-off state of the mirror filter across
109 sessions.
110 <option name="Frequencies" value="US-Cable"/>
113 This sets the default frequency table to use for any tuners
114 found. Possibilities are:
115 · us-cable
117 · us-broadcast
118 · japan-cable
119 · japan-broadcast
120 · europe
121 · australia
122 · australia-optus
123 · newzealand
124 · france
125 · russia
126 <option name="NTSCCableMode" value="Standard"/>
129 There are two special NTSC cable standards in the US: IRC and
130 HRC. In IRC, channels 5 and 6 are on different frequencies, and
131 HRC mode shifts all frequencies up by 1.25MHz (and is also weird
132 on channels 5 and 6). Use this option to set the cable mode to
133 Standard, IRC, or HRC. It is very rare that you will see cable
134 systems that use IRC or HRC cable.
135 <option name="CheckForSignal" value="1"/>
139 Toggle whether tvtime should check if there is a signal present
140 when changing channels etc. If your card doesn't suck, you
141 shouldn't need to shut this off. Disabling this feature will
142 also disable the channel scanner.
143 <option name="InputWidth" value="720"/>
146 This sets how many pixels per scanline to request from the cap‐
147 ture card. A higher setting gives better quality, while a lower
148 setting means we do less work, and so tvtime will run faster.
149 If you have a slower CPU (like, less than 500Mhz or so), maybe
150 values of 480 or 400 might suit you best. For best quality,
151 choose a high value like 720 or 768. Most capture cards cannot
152 sample higher than 768 pixels per scanline.
153 <option name="XMLTVFile" value="none"/>
156 Set this to a filename to get show listings from an xmltv file.
157 Set to "none" if you do not wish to use xmltv.
158 <option name="XMLTVLanguage" value="none"/>
161 Set this to a two-letter language code to set the language to
162 use for entries in the XMLTV file (for example, use "de" for
163 German). Set to "none" if you wish to use the default language
164 of the file.
165 <option name="UseXDS" value="0"/>
168 Set this to 1 to enable XDS channel information decoding. This
169 option is specific to NTSC regions. XDS is used to send infor‐
170 mation about the channel including the network name and call
171 letters, and sometimes information about the current show.
172 <option name="VBIDevice" value="/dev/vbi0"/>
175 This sets which device to use for VBI decoding.
176 <option name="MixerDevice" value="/dev/mixer:line"/>
179 This sets the mixer device and channel to use. The format is
180 device name:channel name for OSS mixer (e.g., "/dev/mixer:Line")
181 or device/channel for ALSA (e.g., "hw:0/CD").
182 Valid OSS channels are:
184 vol, bass, treble, synth, pcm, speaker, line, mic, cd, mix,
186 pcm2, rec, igain, ogain, line1, line2, line3, dig1, dig2, dig3,
187 phin, phout, video, radio, monitor
188 <option name="SquarePixels" value="1"/>
191 Disabling this option tells tvtime to use the X server DPI to
192 determine pixel shape. By default, tvtime assumes pixels are
193 square. Set this to 0 if you have a 4:3 monitor but run it at
194 1280x1024 and want tvtime to do the right thing.
195 <option name="Widescreen" value="0"/>
198 This option enables 16:9 aspect ratio mode by default on start‐
199 up.
200 <option name="WindowGeometry" value="0x576"/>
203 Sets the geometry of the window. A width value of 0 signifies
204 that the appropriate width for the given height will be used.
205 For 4:3 content on a square pixel display, this defaults to a
206 768×576 window.
207 <option name="Overscan" value="0.0"/>
210 This sets the percent of the sides to leave to the overscan,
211 that is, don't show them at all. Safe action area on a televi‐
212 sion is 10% in the overscan, but that's a bit restrictive. If
213 you want tvtime to look like a TV, a good value would be about
214 6–8%. The value is in percent, so for 8%, use 8.0.
215 <option name="Fullscreen" value="0"/>
218 Set this to 1 to have tvtime start in fullscreen mode. This
219 setting is set at runtime so that when you quit tvtime in
220 fullscreen, starting it again will start back in fullscreen
221 mode.
222 <option name="AlwaysOnTop" value="0"/>
225 Set this to 1 to have tvtime start in always-on-top mode under
226 supporting window managers. This setting is set at runtime so
227 that when you quit tvtime in always-on-top mode, starting it
228 again will start back in always-on-top mode.
229 <option name="FullscreenPosition" value="Centre"/>
232 Sets the position of the output when in fullscreen mode: top,
233 bottom or centre. When set to top, tvtime in fullscreen will
234 place its output at the top of the screen. Use if you have a
235 projector to help tvtime fit properly onto your screen.
236 <option name="FramerateMode" value="0"/>
239 This sets the framerate of the output from tvtime.
240 0 Full framerate mode, every field is deinterlaced. 59.94fps
242 for NTSC, 50fps for PAL.
243 1 Half framerate mode, deinterlace every top field to a frame
246 (TFF). 29.97fps for NTSC, 25fps for PAL.
247 2 Half framerate mode, deinterlace every bottom field to a
250 frame (BFF). 29.97fps for NTSC, 25fps for PAL.
251 The two half framerate modes are useful for progressive content
253 from video game consoles. Use weave and select either TFF or
254 BFF, whichever does not exhibit interlace effects.
255 <option name="QuietScreenshots" value="0"/>
258 When this option is turned on, screenshots will not announce
259 themselves on the OSD. This is useful if you intend to take a
260 lot of screenshots, and don't want the text to interrupt your TV
261 watching or appear in other screenshots.
262 <option name="ProcessPriority" value="-10"/>
265 Sets the default process priority. By default, tvtime tries to
266 set itself at a priority of –10 which higher than normal appli‐
267 cations. Acceptable values are from –20 to 20, with lower val‐
268 ues meaning higher priority.
269 <option name="TimeFormat" value="%X"/>
272 Sets the time format to be used in the tvtime on-screen display.
273 The format is a string in the same format as strftime(3). The
274 default is to use the time format of your locale.
275 <option name="ScreenShotDir" value="~"/>
278 This is the default directory in which screenshots are placed.
279 The default is to save them into the user's home directory.
280 <option name="ChannelTextFG" value="0xFFFFFF00"/>
283 <option name="OtherTextFG" value="0xFFF5DEB3"/>
284 These options set the ARGB colours used for the text in the on-
285 screen display. The default for the channel name is “yellow”
286 (0xffffff00), and the default for the surrounding text is
287 “wheat” (0xfff5deb3). The colour format can be hexadecimal or
288 decimal. If the alpha channel is not specified the default is
289 “opaque” (255).
290 Examples: 0xffaadd, 0xff0000ff, 0xff, 0xffff, 255 255 0, 0,
293 16777215.
294 <option name="UnmuteVolume" value="-1"/>
297 This setting saves the volume before muting across tvtime ses‐
298 sions. You should not ever need to set this yourself.
299 <option name="Muted" value="0"/>
302 This setting saves whether or not tvtime was muted when it was
303 last exited. You should not ever need to set this yourself.
304 <option name="MuteOnExit" value="0"/>
307 This setting controls whether tvtime should mute its mixer de‐
308 vice on exit. Use this to work around noisy capture cards.
309 <option name="ShowTaglines" value="1"/>
312 This setting controls whether tvtime should show the silly
313 taglines in the window title bar. Set to 0 to shut them off.
314 <option name="PrevChannel" value="2"/>
317 This setting is saved at runtime to remember the previous chan‐
318 nel.
319 <option name="Channel" value="2"/>
322 This setting is saved at runtime to remember the current chan‐
323 nel.
324 <option name="DeinterlaceMethod" value="AdaptiveAdvanced"/>
327 This setting is saved at runtime to remember the deinterlacer
328 used.
329 Supported deinterlacers are:
331 TelevisionFull Television: Full Resolution
333 TelevisionHalf Television: Half Resolution
334 BlurVertical Blur: Vertical
335 BlurTemporal Blur: Temporal
336 AdaptiveSearch Motion Adaptive: Motion Search
337 AdaptiveAdvanced
338 Motion Adaptive: Advanced Detection
339 AdaptiveSimple Motion Adaptive: Simple Detection
340 ProgressiveTFF Progressive: Top Field First
341 ProgressiveBFF Progressive: Bottom Field First
342
345 Key presses and mouse button clicks can be mapped to tvtime commands.
346 For a description of each command, see tvtime-command(1).
347 Multiple keys and mouse buttons may be bound to the same command. For
349 convenience, tvtime supplies aliases for special keys. The special
350 keys known to tvtime are:
351 Up, Down, Left, Right, Insert, Home, End,R PageUp, PageDown, F1, F2,
353 F3, F4, F5, F6, F7, F8, F9, F10, F11, F12, F13, F14, F15, Backspace,
354 Escape, Enter, Print, Menu
355 An example key binding would be for the command CHANNEL_INC. In this
357 case, we have two keys (Up and k) bound to the command as well as a
358 mouse button (4).
359 <bind command="channel_inc">
361 <keyboard key="up"/>
362 <keyboard key="k"/>
363 <mouse button="4"/>
364 </bind>
365 Some commands can take arguments, for example, the SCREENSHOT command
367 can take an argument for the filename. Arguments can be given to a key
368 binding as follows:
369 <bind command="screenshot" argument="/tmp/last-screenshot.png">
371 <keyboard key="s"/>
372 </bind>
373
376 Billy Biggs.
377
380 tvtime(1), tvtime-configure(1), tvtime-command(1), tvtime-scanner(1),
381 stationlist.xml(5).
382tvtime 1.0RC1 October 2004 tvtime.xml(5)