1tvtime-command(1)           General Commands Manual          tvtime-command(1)
2
3
4

NAME

6       tvtime-command - control a running tvtime process
7
8

SYNOPSIS

10       tvtime-command [COMMAND] ...
11
12

DESCRIPTION

14       tvtime-command  allows  a  user  to control a running tvtime process by
15       sending it commands.  It communicates with tvtime through a FIFO,  oth‐
16       erwise  known  as a named pipe.  Commands are case-insensitive, and are
17       executed in order.
18
19

COMMANDS

21       AUTO_ADJUST_PICT
22              Restores  the  picture  settings  (brightness,  contrast,   hue,
23              colour) to their default values.
24
25
26       AUTO_ADJUST_WINDOW
27              Automatically  resize the window to match the content inside it.
28              This is for when you resize tvtime into, say, a long  rectangle,
29              and  want  it to jump back to being a perfect 4:3 box around the
30              content.
31
32
33       BRIGHTNESS_DOWN
34              Lowers the brightness setting on the input.
35
36
37       BRIGHTNESS_UP
38              Increases the brightness setting on the input.
39
40
41       CHANNEL_[0-9]
42              Simulates a keypad number press.
43
44
45       CHANNEL_ACTIVATE_ALL
46              Re-activates all channels in the list.  Use this to  re-initial‐
47              ize  the  channel list before running the scanner if you believe
48              some channels are missing, or if new channels have become avail‐
49              able.
50
51
52       CHANNEL_DEC / CHANNEL_DOWN
53              Move one channel down in the channel list.
54
55
56       CHANNEL_INC / CHANNEL_UP
57              Move one channel up in the channel list.
58
59
60       CHANNEL_JUMP / CHANNEL_PREV
61              Changes  to  the  last  channel you were at.  Useful for jumping
62              back and forth between two programs on distant channels.
63
64
65       CHANNEL_RENUMBER
66              Renumbers the current channel.  This will swap the current chan‐
67              nel  with  the  number  you type in.  Use this to configure your
68              station list to suit preference or locality.
69
70
71       CHANNEL_SAVE_TUNING
72              Saves the current fine tuning settings as a  custom  channel  in
73              the station list.
74
75
76       CHANNEL_SCAN
77              Walks  from  the current position through the channel list, dis‐
78              abling any channels for which no signal is detected.  This  com‐
79              mand is only available if signal checking is enabled.
80
81
82       CHANNEL_SKIP
83              Toggles  the  current channel as being active or disabled in the
84              station list.  You can use this to manually scan  your  channels
85              and enable those with signal or disable duplicate stations.
86
87
88       COLOUR_DOWN / COLOR_DOWN
89              Decreases  the input colour picture setting.  This will make the
90              image less colourful until it is black-and-white.
91
92
93       COLOUR_UP / COLOR_UP
94              Increases the input colour picture setting.  This will give  the
95              image more colour.
96
97
98       CONTRAST_DOWN
99              Decreases the contrast setting of the input.
100
101
102       CONTRAST_UP
103              Increases the contrast setting of the input.
104
105
106       DISPLAY_INFO
107              This  will  re-display  the OSD for the current channel, showing
108              the channel information, current deinterlacer and framerate, the
109              time, and input settings.
110
111
112       DISPLAY_MESSAGE
113              This will display a message along the bottom of the OSD.  Useful
114              for cron jobs or other scripts to send notifications to  a  user
115              running tvtime.
116
117
118       DOWN   This  command provides the dual functionality of channel down or
119              menu arrow down, depending on  whether  the  menu  is  currently
120              active.   This  command  is  to  be used together with the LEFT,
121              RIGHT and UP commands.
122
123
124       ENTER  Sends a virtual enter command.  Use this when changing the chan‐
125              nel:
126                  tvtime-command channel_1 channel_5 enter
127              will change to channel 15.
128
129
130       FINETUNE_DOWN
131              Decreases the fine tuning setting for the current channel.
132
133
134       FINETUNE_UP
135              Increases the fine tuning for the current channel.
136
137
138       HUE_DOWN
139              Decreases the hue setting of the input.
140
141
142       HUE_UP Increases the hue setting of the input.
143
144
145       KEY_EVENT
146              Sends  a  fake  keystroke  event  to tvtime.  This is useful for
147              doing complex operations via a remote control, as you can  indi‐
148              rect events to tvtime's internal key binding system.
149
150
151       LEFT   This  command  provides  the  dual functionality of mixer volume
152              down or menu back command, depending on whether the menu is cur‐
153              rently  active.   This  command  is to be used together with the
154              RIGHT, UP and DOWN commands.
155
156
157       MENU_DOWN
158              In menu mode, this command moves the cursor down  one  entry  in
159              the menu.
160
161
162       MENU_ENTER
163              In  menu  mode,  this command selects the current entry or moves
164              forward one level in the menu.
165
166
167       MENU_EXIT
168              In menu mode, this command shuts off the menu.
169
170
171       MENU_BACK
172              In menu mode, this command moves back one level in the menu.
173
174
175       MENU_ENTER
176              In menu mode, this command selects the current  entry  or  moves
177              forward one level in the menu.
178
179
180       MENU_UP
181              In  menu mode, this command moves the cursor up one entry in the
182              menu.
183
184
185       MIXER_DOWN
186              Decreases the  volume  setting  for  the  Line  In  device  from
187              /dev/mixer.   An  optional parameter specifies the percentage to
188              decrease by.
189
190
191       MIXER_TOGGLE_MUTE
192              Toggles the mute status with the mixer, and not with the capture
193              card like TOGGLE_MUTE does.
194
195
196       MIXER_UP
197              Increases  the  volume  setting  for  the  Line  In  device from
198              /dev/mixer.  An optional parameter specifies the  percentage  to
199              increase by.
200
201
202       NOOP   The  command  to  do nothing.  Useful for when you want to blank
203              out one of the default key bindings in tvtime.
204
205
206       OVERSCAN_DOWN
207              Decreases the overscan compensation amount.  This will show more
208              of the captured input.
209
210
211       OVERSCAN_UP
212              Increases the overscan compensation amount.  This will show less
213              of the captured input.
214
215
216       PICTURE
217              Selects which picture  setting  (brightness/contrast/colour/hue)
218              to change using the PICTURE_UP and PICTURE_DOWN commands.
219
220
221       PICTURE_UP
222              Increases  the  current  picture  setting value (brightness/con‐
223              trast/colour/hue).
224
225
226       PICTURE_DOWN
227              Decreases the current  picture  setting  value  (brightness/con‐
228              trast/colour/hue).
229
230
231       RESTART
232              Asks tvtime to restart itself.  This is used in the menu when we
233              have changed a value that we can't yet change at runtime.
234
235
236       RIGHT  This command provides the dual functionality of mixer volume  up
237              or  menu  enter  command,  depending on whether the menu is cur‐
238              rently active.  This command is to be  used  together  with  the
239              LEFT, UP and DOWN commands.
240
241
242       RUN_COMMAND
243              Instructs  tvtime to spawn a command.  This can be used to start
244              a program using a key in  tvtime  or  lirc,  such  as  to  spawn
245              mythepg or alevt.  Using tvtime-command run_command "xterm" will
246              have tvtime call system( "xterm &" ).
247
248
249       SAVE_PICTURE_GLOBAL
250              Saves the current picture settings as the global defaults.
251
252
253       SAVE_PICTURE_CHANNEL
254              Saves the current picture settings as the defaults for the  cur‐
255              rent channel on the tuner.
256
257
258       SCREENSHOT
259              Asks  tvtime to take a screenshot.  Screenshots are saved to the
260              directory listed as the screenshot directory in  the  tvtime.xml
261              configuration  file.   The  default  is  the running user's home
262              directory.
263
264
265       SET_AUDIO_MODE
266              This command takes a parameter and sets the current audio  mode.
267              Valid options are "mono", "stereo", "sap", "lang1" or "lang2".
268
269
270       SET_DEINTERLACER
271              This  command  takes  a  parameter and sets the current deinter‐
272              lacer.  Valid options are the short name of any of the  deinter‐
273              lacers available in tvtime.
274
275
276       SET_FRAMERATE
277              This  command  takes a parameter and sets the current framerate.
278              Valid options are "full", "top" and "bottom".
279
280
281       SET_FREQUENCY_TABLE
282              This command takes a parameter and sets  the  current  frequency
283              table.
284
285
286       SET_FULLSCREEN_POSITION
287              This  command  sets where widescreen output will be aligned when
288              in fullscreen mode, either top for the top of the  screen,  cen‐
289              ter, or bottom.
290
291
292       SET_INPUT
293              This  command  takes  a  parameter and sets the the capture card
294              input (0-n).  Among the Inputs are: the tuner, composite, or  S-
295              Video connectors on the capture card.
296
297
298       SET_INPUT_WIDTH
299              This  command takes a parameter and sets the current input width
300              in pixels.  It will be used in tvtime after a restart.
301
302
303       SET_MATTE
304              This command sets the  matte  to  apply  to  the  output.   This
305              changes  the size of the output window, and is useful for watch‐
306              ing a 2.35:1 movie in a long, thin window, or for watching it at
307              the  top  of  the  screen  using the fullscreen position option.
308              Valid options here are 16:9, 1.85:1, 2.35:1 or 4:3.
309
310
311       SET_NORM
312              This command takes a parameter and sets the  current  television
313              standard.  It will be used in tvtime after a restart.
314
315
316       SET_STATION
317              This  command  takes a station name or number as a parameter and
318              changes the channel to the station given.
319
320
321       SET_XMLTV_LANGUAGE
322              Set the preferred language code for XMLTV data. The argument can
323              be either the two-letter language code according to ISO 639 or a
324              number to select one of the known languages.
325
326
327       SHOW_DEINTERLACER_INFO
328              Shows a help screen on the OSD describing the  current  deinter‐
329              lacer setting.
330
331
332       SHOW_MENU
333              This command is used to bring up the tvtime setup menu.
334
335
336       SHOW_STATS
337              Shows  a  debug  screen  showing  statistics  about  the running
338              instance of tvtime.
339
340
341       SLEEP  This command sets the sleep timer to tell tvtime to shut  itself
342              off  after  a certain amount of time.  Sending this command will
343              first activate the feature, and sending it again  will  increase
344              the  timer  up  until  a maximum value at which point it is shut
345              off.
346
347
348       TOGGLE_ALWAYSONTOP
349              If supported by your window manager, this command  will  ask  to
350              have  the  window be put into an "always on top" state, where no
351              other window can be stacked above it.
352
353
354       TOGGLE_ASPECT
355              Toggles the display between 4:3 and 16:9 mode.  Use 16:9 mode if
356              you have configured an external DVD player or satellite receiver
357              to output anamorphic 16:9 content.
358
359
360       TOGGLE_AUDIO_MODE
361              Toggles between the available audio modes on this  channel.   It
362              can  take  some  time before the driver discovers that modes are
363              available.
364
365
366       TOGGLE_BARS
367              Asks tvtime to display colourbars.  The colourbars are generated
368              by tvtime and are not related to the capture card, but simply to
369              help configure your video card and display  device.   Once  your
370              settings  are correct with these colourbars, try colourbars from
371              an input source like an external DVD player and make  sure  they
372              match up.
373
374
375       TOGGLE_CC
376              Enables closed caption information to be displayed in the tvtime
377              window.  Closed captioning is only available if you have enabled
378              VBI reading in your tvtime.xml configuration file.
379
380
381       TOGGLE_CHANNEL_PAL_DK
382              For  PAL  users,  toggles  the audio mode of the current channel
383              between the PAL-BG and PAL-DK audio norms.
384
385
386       TOGGLE_CHROMA_KILL
387              Enables or disables the chroma killer filter,  which  makes  the
388              input  black  and white.  Useful when watching a black-and-white
389              movie to avoid chrominance artifacts.
390
391
392       TOGGLE_COLOR_INVERT / TOGGLE_COLOUR_INVERT
393              Turns on or off the colour invert filter.  This is  (apparently)
394              useful  for users of the Australian cable company Optus who want
395              to avoid using the decryption boxes and tune using their capture
396              card directly.
397
398
399       TOGGLE_DEINTERLACER
400              This toggles between the available deinterlacing methods.
401
402
403       TOGGLE_FULLSCREEN
404              This toggles between fullscreen and windowed mode.
405
406
407       TOGGLE_FRAMERATE
408              Toggles  the framerate at which tvtime will output.  Options are
409              full frame rate (every field  deinterlaced  to  a  frame),  half
410              frame  rate  TFF  (every  top field deinterlaced to a frame) and
411              half frame rate  BFF  (every  bottom  field  deinterlaced  to  a
412              frame).
413
414
415       TOGGLE_INPUT
416              Switches the capture card input used.  Among the Inputs are: the
417              tuner, composite, or S-Video connectors on the capture card.
418
419
420       TOGGLE_MATTE
421              Switches between the available mattes.  This cuts  off  the  top
422              and  bottom  of  the input picture to help fit the window to the
423              image content.
424
425
426       TOGGLE_MIRROR
427              Turns on or off the mirror filter, which flips the input.   This
428              is useful for using tvtime with mirroring projectors, although I
429              don't think it will actually work as intended yet since we don't
430              mirror the OSD output.  :)  Comments appreciated.
431
432
433       TOGGLE_MUTE
434              Toggles  the  mute  state  in  the capture card (and not in your
435              soundcard).
436
437
438       TOGGLE_NTSC_CABLE_MODE
439              Toggles the NTSC cable mode settings: Standard, IRC, and HRC are
440              available.
441
442
443       TOGGLE_PAL_DK_AUDIO
444              For  PAL  users,  toggles the default audio mode of all channels
445              between the PAL-BG and PAL-DK audio norms.
446
447
448       TOGGLE_PAL_SECAM
449              Toggles between PAL and SECAM on the current channel.  This fea‐
450              ture  is  useful  for  regions  which receive both PAL and SECAM
451              channels, such that tvtime can be configured  on  a  per-channel
452              basis for the correct norm.
453
454
455       TOGGLE_PAUSE
456              Enters  pause  mode.   Pause mode is a debugging feature used to
457              test deinterlacer filters by allowing to see  the  output  of  a
458              single set of frames with various deinterlacers.
459
460
461       TOGGLE_PULLDOWN_DETECTION
462              Enables  or disables the 2–3 pulldown detection feature for NTSC
463              input.
464
465
466       TOGGLE_QUIET_SCREENSHOTS
467              When this option is turned on,  screenshots  will  not  announce
468              themselves  on  the OSD.  This is useful if you intend to take a
469              lot of screenshots, and don't want the text to interrupt your TV
470              watching or appear in other screenshots.
471
472
473       TOGGLE_SIGNAL_DETECTION
474              Toggles  on  and  off  tvtime's  signal  detection code.  Signal
475              detection enables features like channel scanning  and  increases
476              responsiveness  on channels with poor reception, but may make it
477              impossible to watch stations where the reception is too bad  for
478              the card to detect it reliably.
479
480
481       TOGGLE_XDS
482              Toggles  on  and off tvtime's XDS decoding code.  XDS is used to
483              send information about the channel including  the  network  name
484              and  call  letters,  and sometimes information about the current
485              show.  This information is then shown on the OSD  and  saved  to
486              the stationlist.xml file.
487
488
489       TOGGLE_XMLTV_LANGUAGE
490              Toggles  which  language  to show by default from the XMLTV file
491              from the ones available in the file.
492
493
494       UP     This command provides the dual functionality of  channel  up  or
495              menu  arrow  up,  depending  on  whether  the  menu is currently
496              active.  This command is to be  used  together  with  the  LEFT,
497              RIGHT and DOWN commands.
498
499
500       QUIT   Asks the running tvtime process to exit.
501
502

AUTHORS

504       Billy Biggs, Stewart Allen.
505
506

SEE ALSO

508       tvtime(1), tvtime.xml(5), stationlist.xml(5).
509
510
511
512tvtime 1.0RC1                    October 2004                tvtime-command(1)
Impressum