1tvtime-command(1) General Commands Manual tvtime-command(1)
2
3
4
6 tvtime-command - control a running tvtime process
7
8
10 tvtime-command [COMMAND] ...
11
12
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
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
504 Billy Biggs, Stewart Allen.
505
506
508 tvtime(1), tvtime.xml(5), stationlist.xml(5).
509
510
511
512tvtime 1.0RC1 October 2004 tvtime-command(1)