1tvtime(1) General Commands Manual tvtime(1)
2
3
4
6 tvtime - a high quality television application
7
8
10 tvtime [ OPTION ] ...
11
12
14 tvtime is a high quality television application for use with video cap‐
15 ture cards. tvtime processes the input from a capture card and dis‐
16 plays it on a computer monitor or projector.
17
18 tvtime supports:
19
20
21 · Deinterlaced output at full interlaced rate of 59.94 frames per
22 second for NTSC source, or 50 frames per second for PAL sources.
23 This gives smoothness of motion and high visual quality.
24
25
26 · Multiple deinterlacing algorithms for finding the optimal mode for
27 the video content and available processor speed.
28
29
30 · 16:9 aspect ratio mode for the highest available resolution when
31 processing input from an external DVD player or digital satellite
32 receiver.
33
34
35 · A super-slick on-screen-display for the complete television experi‐
36 ence, with a featureful menu system.
37
38
40 Here are the core set of key bindings you want to learn for using
41 tvtime:
42
43
44 Escape or q Quit
45
46 F1 or tab Show menu
47
48 up/down Change channels
49
50 0-9 and Enter Change channels
51
52 Backspace Jump to previous channel
53
54 i Change input
55
56 m Mute
57
58 +/- or left/right Volume control
59
60 f Fullscreen
61
62 s Take a screenshot
63
64 Enter Display info
65
66 d Display debug statistics
67
68 Here are some advanced keys. These features are all configurable via
69 the menu, but some of these may be useful if you use the features
70 often:
71
72
73 e Toggle audio mode (stereo/mono/SAP)
74
75 v Toggle always-on-top with supporting window managers
76
77 F5/F6/F7
78 Picture settings
79
80 Space Restore default picture settings
81
82 / Resize the window to match the content inside it (after
83 applying a matte or switching to 16:9 mode)
84
85 c Toggle closed caption decoding (NTSC only)
86
87
89 -a, --widescreen
90 This option starts tvtime in 16:9 aspect ratio mode.
91
92
93 -A, --nowidescreen
94 This option starts tvtime in 4:3 aspect ratio mode.
95
96
97 -h, --help
98 Show usage information.
99
100
101 -k, --slave
102 Disables keyboard input in tvtime for slave mode. Slave mode
103 was added for integration with PVR applications like freevo or
104 mythtv, so that freevo can handle keyboard input while tvtime is
105 running. In slave mode, keystrokes are ignored but they are
106 printed to standard output, and commands are read from standard
107 input in the same syntax as tvtime-command.
108
109
110 -m, --fullscreen
111 Start tvtime in fullscreen mode.
112
113
114 -M, --window
115 Start tvtime in windowed mode.
116
117
118 -s, --showdrops
119 Print frame skip information (for debugging).
120
121
122 -S, --saveoptions
123 Save command line options to the config file. This will save
124 the V4L device, VBI device, input number, norm, frequency,
125 startup fullscreen setting, aspect ratio, verbose mode, and out‐
126 put window height.
127
128
129 -v, --verbose
130 The verbose setting indicates that we should print full informa‐
131 tional and warning messages to standard error while running
132 tvtime. Otherwise, only critical errors will be printed to the
133 output.
134
135
136 -F, --configfile=FILE
137 Additional config file to load settings from.
138
139
140 -g, --geometry=GEOMETRY
141 Sets the geometry of the window, for example, 400x300 for a win‐
142 dow 400 pixels wide and 300 pixels tall. A width value of 0
143 signifies that the appropriate width for the given height will
144 be used. For 4:3 content on a square pixel display, this
145 defaults to a 768×576 window.
146
147
148 -I, --inputwidth=SAMPLING
149 V4L input scanline sampling (defaults to 720. This sets how
150 many pixels per scanline to request from the capture card. A
151 higher setting gives better quality, while a lower setting means
152 we do less work, and so tvtime will run faster. If you have a
153 slower CPU (like, less than 500Mhz or so), maybe values of
154 480 or 400 might suit you best. For best quality, choose a high
155 value like 720 or 768. Many capture cards cannot sample higher
156 than 768 pixels per scanline.
157
158
159 -d, --device=NAME
160 video4linux device to use (defaults to /dev/video0).
161
162
163 -b, --vbidevice=DEVICE
164 VBI device to use (defaults to /dev/vbi0).
165
166
167 -i, --input=INPUTNUM
168 video4linux input number (defaults to 0). Cards commonly have a
169 bunch of sources, for example, on my WinTV card, source 0 is my
170 tuner and source 1 is the composite input.
171
172
173 -c, --channel=CHANNEL
174 On startup, tvtime will tune to the given channel. Otherwise,
175 the channels from the config file will be used.
176
177
178 -n, --norm=NORM
179 The mode to set the tuner to (defaults to NTSC). Valid modes
180 are:
181
182 · NTSC
183 · PAL
184 · SECAM
185 · PAL-NC
186 · PAL-M
187 · PAL-N
188 · NTSC-JP
189
190
191 -f, --frequencies=NAME
192 The channels you are receiving with the tuner (defaults to
193 us-cable). Valid values are:
194
195 · us-cable
196 · us-broadcast
197 · japan-cable
198 · japan-broadcast
199 · europe
200 · australia
201 · australia-optus
202 · newzealand
203 · france
204 · russia
205 · custom (first run 'tvtime-scanner')
206
207
208 -t, --xmltv=FILE
209 Reads XMLTV listings from the given file to display on the OSD.
210 Channels are looked up based on their name, and tvtime will dis‐
211 play the show title, sub-title and show description on the OSD.
212
213
214 -l, --xmltvlanguage=LANG
215 Use XMLTV data in given language, if available. Languages are
216 represented by their two-letter language code (for example, "de"
217 for German). The default language used in the file will be used
218 if this is unset or set to "none"
219
220
221
222 -X, --display=DISPLAY
223 Uses the given X display to connect to.
224
225
226 -x, --mixer=DEVICE[:CH]
227 The mixer device and channel for the volume controls. (defaults
228 to /dev/mixer:line). Valid channels are:
229
230 · vol
231 · bass
232 · treble
233 · synth
234 · pcm
235 · speaker
236 · line
237 · mic
238 · cd
239 · mix
240 · pcm2
241 · rec
242 · igain
243 · ogain
244 · line1
245 · line2
246 · line3
247 · dig1
248 · dig2
249 · dig3
250 · phin
251 · phout
252 · video
253 · radio
254 · monitor
255
256
257
259 /tvtime/tvtime.xml
260 $HOME/.tvtime/tvtime.xml
261 $HOME/.tvtime/stationlist.xml
262 /var/run/tvtime/TV-*/tvtimefifo
263
264
266 Billy Biggs, Doug Bell, Alexander S. Belov, Achim Schneider, David I.
267 Lehn, Paul Jara, Robert Högberg, Craig Dooley, Bart Dorsey, Nicolas
268 Boos, Simon Law, Mark Trolley, Joachim Koenig, Stewart Allen, Justin A,
269 Brian Goines, Krister Lagerstrom.
270
271
273 tvtime-command(1), tvtime-configure(1), tvtime-scanner(1),
274 tvtime.xml(5), stationlist.xml(5).
275
276
277
278tvtime 1.0RC1 April 2005 tvtime(1)