1tvtime-command(1) General Commands Manual tvtime-command(1)
2
6 tvtime-command - control a running tvtime process
7
10 tvtime-command [COMMAND] ...
11
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
21 AUTO_ADJUST_PICT
22 Restores the picture settings (brightness, contrast, hue,
23 colour) to their default values.
24 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 BRIGHTNESS_DOWN
34 Lowers the brightness setting on the input.
35 BRIGHTNESS_UP
38 Increases the brightness setting on the input.
39 CHANNEL_[0-9]
42 Simulates a keypad number press.
43 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 CHANNEL_DEC / CHANNEL_DOWN
53 Move one channel down in the channel list.
54 CHANNEL_INC / CHANNEL_UP
57 Move one channel up in the channel list.
58 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 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 CHANNEL_SAVE_TUNING
72 Saves the current fine tuning settings as a custom channel in
73 the station list.
74 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 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 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 COLOUR_UP / COLOR_UP
94 Increases the input colour picture setting. This will give the
95 image more colour.
96 CONTRAST_DOWN
99 Decreases the contrast setting of the input.
100 CONTRAST_UP
103 Increases the contrast setting of the input.
104 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 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 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 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 FINETUNE_DOWN
131 Decreases the fine tuning setting for the current channel.
132 FINETUNE_UP
135 Increases the fine tuning for the current channel.
136 HUE_DOWN
139 Decreases the hue setting of the input.
140 HUE_UP Increases the hue setting of the input.
143 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 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 MENU_DOWN
158 In menu mode, this command moves the cursor down one entry in
159 the menu.
160 MENU_ENTER
163 In menu mode, this command selects the current entry or moves
164 forward one level in the menu.
165 MENU_EXIT
168 In menu mode, this command shuts off the menu.
169 MENU_BACK
172 In menu mode, this command moves back one level in the menu.
173 MENU_ENTER
176 In menu mode, this command selects the current entry or moves
177 forward one level in the menu.
178 MENU_UP
181 In menu mode, this command moves the cursor up one entry in the
182 menu.
183 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 MIXER_TOGGLE_MUTE
192 Toggles the mute status with the mixer, and not with the capture
193 card like TOGGLE_MUTE does.
194 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 NOOP The command to do nothing. Useful for when you want to blank
203 out one of the default key bindings in tvtime.
204 OVERSCAN_DOWN
207 Decreases the overscan compensation amount. This will show more
208 of the captured input.
209 OVERSCAN_UP
212 Increases the overscan compensation amount. This will show less
213 of the captured input.
214 PICTURE
217 Selects which picture setting (brightness/contrast/colour/hue)
218 to change using the PICTURE_UP and PICTURE_DOWN commands.
219 PICTURE_UP
222 Increases the current picture setting value (brightness/con‐
223 trast/colour/hue).
224 PICTURE_DOWN
227 Decreases the current picture setting value (brightness/con‐
228 trast/colour/hue).
229 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 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 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 SAVE_PICTURE_GLOBAL
250 Saves the current picture settings as the global defaults.
251 SAVE_PICTURE_CHANNEL
254 Saves the current picture settings as the defaults for the cur‐
255 rent channel on the tuner.
256 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 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 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 SET_FRAMERATE
277 This command takes a parameter and sets the current framerate.
278 Valid options are "full", "top" and "bottom".
279 SET_FREQUENCY_TABLE
282 This command takes a parameter and sets the current frequency
283 table.
284 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 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 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 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 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 SET_STATION
317 This command takes a station name or number as a parameter and
318 changes the channel to the station given.
319 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 SHOW_DEINTERLACER_INFO
328 Shows a help screen on the OSD describing the current deinter‐
329 lacer setting.
330 SHOW_MENU
333 This command is used to bring up the tvtime setup menu.
334 SHOW_STATS
337 Shows a debug screen showing statistics about the running
338 instance of tvtime.
339 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 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 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 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 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 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 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 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 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 TOGGLE_DEINTERLACER
400 This toggles between the available deinterlacing methods.
401 TOGGLE_FULLSCREEN
404 This toggles between fullscreen and windowed mode.
405 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 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 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 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 TOGGLE_MUTE
434 Toggles the mute state in the capture card (and not in your
435 soundcard).
436 TOGGLE_NTSC_CABLE_MODE
439 Toggles the NTSC cable mode settings: Standard, IRC, and HRC are
440 available.
441 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 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 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 TOGGLE_PULLDOWN_DETECTION
462 Enables or disables the 2–3 pulldown detection feature for NTSC
463 input.
464 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 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 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 TOGGLE_XMLTV_LANGUAGE
490 Toggles which language to show by default from the XMLTV file
491 from the ones available in the file.
492 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 QUIT Asks the running tvtime process to exit.
501
504 Billy Biggs, Stewart Allen.
505
508 tvtime(1), tvtime.xml(5), stationlist.xml(5).
509tvtime 1.0RC1 October 2004 tvtime-command(1)