tvtime(1)

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

NAME

6       tvtime - a high quality television application
7
8

SYNOPSIS

10       tvtime [ OPTION ] ...
11
12

DESCRIPTION

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

USAGE

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

OPTIONS

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

FILES

259       /tvtime/tvtime.xml
260       $HOME/.tvtime/tvtime.xml
261       $HOME/.tvtime/stationlist.xml
262       /var/run/tvtime/TV-*/tvtimefifo
263
264

AUTHORS

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