aboutsummaryrefslogtreecommitdiffstats
path: root/docs/html/default.tvtime.xml
blob: 9aa80491b8881d801a9d022705e0c0440a040066 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
<?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/">

  <!--
    Default $HOME/.tvtime/tvtime.xml configuration file.
    Do not edit this config file while tvtime is running, it
    will be overwritten during runtime to update program settings.
  -->


  <!--
    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="Verbose" value="0"/>


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

  <!--
    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="V4LInput" value="0"/>

  <!--
    This sets the default TV norm.  Valid options are:
       NTSC
       NTSC-JP
       SECAM
       PAL
       PAL-Nc
       PAL-M
       PAL-N
       PAL-60
  -->
  <option name="Norm" value="NTSC"/>

  <!--
    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="Frequencies" value="US-Cable"/>

  <!--
    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="NTSCCableMode" value="Standard"/>

  <!--
    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="CheckForSignal" value="1"/>

  <!--
    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="InputWidth" value="720"/>

  <!--
    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="XMLTVFile" 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="XMLTVLanguage" value="none"/>

  <!--
    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.  This information is
    then shown on the OSD and saved to the stationlist.xml file.
  -->
  <option name="UseXDS" value="0"/>

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

  <!--
    This sets the mixer device and channel to use.  The format is device
    name:channel name.  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
   -->
  <option name="MixerDevice" value="/dev/mixer:line"/>

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

  <!--
    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
    768x576 window.
  -->
  <option name="WindowGeometry" value="0x576"/>

  <!--
    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="Overscan" value="3.5"/>

  <!--
    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="Fullscreen" value="0"/>

  <!--
    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 this if you have a projector to help
    tvtime fit properly onto your screen.
  -->
  <option name="FullscreenPosition" value="Centre"/>

  <!--
    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="AlwaysOnTop" 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="FramerateMode" value="0"/>

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

  <!--
    If Save/Restore is turned on, this is where we store the global
    default settings.  Each value is from 0-100.  If the value is -1, then
    we don't set that setting on startup.
  -->
  <option name="DefaultBrightness" value="-1"/>
  <option name="DefaultContrast" value="-1"/>
  <option name="DefaultColour" value="-1"/>
  <option name="DefaultHue" value="-1"/>

  <!--
    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="AudioMode" value="stereo"/>

  <!--
    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 valume to have it always set to your
    favorite volume.  Use -1 to have tvtime not touch the volume.
  -->
  <option name="AudioBoost" value="-1"/>

  <!--
    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="ShowCC" value="0"/>

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

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

  <!--
    This indicates whether the luma correction option should be enabled by
    default when starting the application.  Luma correction can be turned
    on or off within the application using the "c" key.
  -->
  <option name="ApplyLumaCorrection" value="0"/>

  <!--
    This indicates the power for correction.  A value of 1.0 does
    nothing except apply Bt8x8 correction, if you have a Bt8x8-based
    capture card.  Values less than one make the output darker, and
    values greater than one make the output brighter.  The valid range
    is 0.1 to 10.0 in increments of 0.1.
  -->
  <option name="LumaCorrection" value="1.0"/>


  <!--
    Sets the default process priority.  By default, tvtime tries to be
    a real hog and get -19 priority, which is insane, but hey, if a
    frame comes in we need to process it right away or it gets dropped,
    right? :)    Acceptable values are from -20 to 20, with lower values
    meaning higher priority (blame UNIX for that).
  -->
  <option name="ProcessPriority" value="-19"/>

  <!--
    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="TimeFormat" value="%X"/>

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

  <!--
    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="ChannelTextFG" value="0xFFFFFF00"/>
  <option name="OtherTextFG" value="0xFFF5DEB3"/>

  <!--
    This setting is saved at runtime to remember the current channel.
  -->
  <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 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
  -->
  <option name="DeinterlaceMethod" value="AdaptiveAdvanced"/>


  <!--
    The rest of the configuration file defines how the input to
    tvtime is mapped to tvtime commands.  Each command can be bound
    to multiple keys and mouse buttons.  Up to nine mouse buttons
    are supported.


    Commands known to tvtime:

      AUTO_ADJUST_PICT           OVERSCAN_DOWN            
      AUTO_ADJUST_WINDOW         OVERSCAN_UP              
      BRIGHTNESS_DOWN            PICTURE                  
      BRIGHTNESS_UP              PICTURE_UP               
      CHANNEL_1                  PICTURE_DOWN             
      CHANNEL_2                  RESTART                  
      CHANNEL_3                  RIGHT                    
      CHANNEL_4                  RUN_COMMAND              
      CHANNEL_5                  SAVE_PICTURE_GLOBAL      
      CHANNEL_6                  SAVE_PICTURE_CHANNEL     
      CHANNEL_7                  SCREENSHOT               
      CHANNEL_8                  SCROLL_CONSOLE_DOWN      
      CHANNEL_9                  SCROLL_CONSOLE_UP        
      CHANNEL_0                  SET_AUDIO_MODE           
      CHANNEL_ACTIVATE_ALL       SET_DEINTERLACER         
      CHANNEL_DEC                SET_FRAMERATE            
      CHANNEL_DOWN               SET_FREQUENCY_TABLE      
      CHANNEL_INC                SET_FULLSCREEN_POSITION  
      CHANNEL_JUMP               SET_INPUT_WIDTH          
      CHANNEL_PREV               SET_MATTE                
      CHANNEL_RENUMBER           SET_NORM                 
      CHANNEL_SAVE_TUNING        SHOW_DEINTERLACER_INFO   
      CHANNEL_SCAN               SHOW_MENU                
      CHANNEL_SKIP               SHOW_STATS               
      CHANNEL_UP                 SLEEP                    
      COLOR_DOWN                 TOGGLE_ALWAYSONTOP       
      COLOR_UP                   TOGGLE_ASPECT            
      COLOUR_DOWN                TOGGLE_AUDIO_MODE        
      COLOUR_UP                  TOGGLE_BARS              
      CONTRAST_DOWN              TOGGLE_CC                
      CONTRAST_UP                TOGGLE_CHROMA_KILL       
      DISPLAY_INFO               TOGGLE_COLOR_INVERT      
      DISPLAY_MESSAGE            TOGGLE_COLOUR_INVERT     
      DOWN                       TOGGLE_CONSOLE           
      ENTER                      TOGGLE_DEINTERLACER      
      FINETUNE_DOWN              TOGGLE_FULLSCREEN        
      FINETUNE_UP                TOGGLE_FRAMERATE         
      HUE_DOWN                   TOGGLE_INPUT             
      HUE_UP                     TOGGLE_LUMA_CORRECTION   
      KEY_EVENT                  TOGGLE_MATTE             
      LEFT                       TOGGLE_MIRROR            
      LUMA_DOWN                  TOGGLE_MODE              
      LUMA_UP                    TOGGLE_MUTE              
      MENU_DOWN                  TOGGLE_NTSC_CABLE_MODE   
      MENU_ENTER                 TOGGLE_PAL_SECAM         
      MENU_EXIT                  TOGGLE_PAUSE             
      MENU_BACK                  TOGGLE_PULLDOWN_DETECTION
      MENU_UP                    TOGGLE_SIGNAL_DETECTION  
      MIXER_DOWN                 TOGGLE_XDS               
      MIXER_TOGGLE_MUTE          UP                       
      MIXER_UP                   QUIT                     
      NOOP                                                

    Special keys known by tvtime:

      Up, Down, Left, Right, Insert, Home, End, PgUp, Page_Up, PageUp,
      PgDn, Page_Down, PageDown, F1, F2, F3, F4, F5, F6, F7, F8, F9,
      F10, F11, F12, F13, F14, F15 Backspace, BS, Delete, Del, Esc,
      Escape, Enter, Print, Menu, Tab
  -->

  <bind command="quit">
    <keyboard key="escape"/>
    <keyboard key="q"/>
  </bind>

  <bind command="show_menu">
    <keyboard key="F1"/>
    <keyboard key="Tab"/>
    <mouse button="3"/>
  </bind>

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

  <bind command="down">
    <keyboard key="down"/>
    <mouse button="5"/>
  </bind>

  <bind command="left">
    <keyboard key="left"/>
    <keyboard key="-"/>
  </bind>

  <bind command="right">
    <keyboard key="right"/>
    <keyboard key="+"/>
  </bind>

  <bind command="channel_prev">
    <keyboard key="backspace"/>
  </bind>

  <bind command="toggle_mute">
    <keyboard key="m"/>
    <mouse button="2"/>
  </bind>

  <bind command="enter">
    <keyboard key="enter"/>
  </bind>

  <bind command="picture">
    <keyboard key="F5"/>
  </bind>

  <bind command="picture_down">
    <keyboard key="F6"/>
  </bind>

  <bind command="picture_up">
    <keyboard key="F7"/>
  </bind>

  <bind command="channel_renumber">
    <keyboard key="r"/>
  </bind>

  <bind command="show_stats">
    <keyboard key="d"/>
  </bind>

  <bind command="toggle_fullscreen">
    <keyboard key="f"/>
  </bind>

  <bind command="toggle_input">
    <keyboard key="i"/>
  </bind>

  <bind command="toggle_aspect">
    <keyboard key="a"/>
  </bind>

  <bind command="screenshot">
    <keyboard key="s"/>
  </bind>

  <bind command="toggle_deinterlacer">
    <keyboard key="t"/>
  </bind>

  <bind command="toggle_pulldown_detection">
    <keyboard key="p"/>
  </bind>

  <bind command="toggle_cc">
    <keyboard key="c"/>
  </bind>

  <bind command="toggle_framerate">
    <keyboard key="="/>
  </bind>

  <bind command="toggle_audio_mode">
    <keyboard key="e"/>
  </bind>

  <bind command="overscan_up">
    <keyboard key="&gt;"/>
  </bind>

  <bind command="overscan_down">
    <keyboard key="&lt;"/>
  </bind>

  <bind command="display_info">
    <mouse button="1"/>
  </bind>

  <bind command="toggle_matte">
    <keyboard key="insert"/>
  </bind>

  <bind command="toggle_alwaysontop">
    <keyboard key="v"/>
  </bind>

  <!--
    The following keys are active when tvtime is displaying the menu.
   -->
  <bind command="menu_exit">
    <keyboard key="esc"/>
    <keyboard key="q"/>
    <keyboard key="F1"/>
    <keyboard key="Tab"/>
    <mouse button="3"/>
  </bind>

  <bind command="menu_enter">
    <keyboard key="enter"/>
    <mouse button="1"/>
  </bind>

  <!--
    The following keys are not part of the core tvtime functionality,
    that is, they are mostly for debugging, but are bound to keys by
    default in tvtime.
   -->

  <bind command="auto_adjust_window">  <keyboard key="/"/>    </bind>
  <bind command="toggle_bars">         <keyboard key="b"/>    </bind>
  <bind command="toggle_pause">        <keyboard key="end"/>  </bind>
  <bind command="mixer_toggle_mute">   <keyboard key=","/>    </bind>
  <bind command="auto_adjust_pict">    <keyboard key=" "/>    </bind>

</tvtime>

Privacy Policy