Table of Contents
martv - a high quality television application clone
of program tvtime
martv [ OPTION ] ...
martv is a clone
of program tvtime with a few modifications that enables cooperation of
tvtime with program mar345dtb. Search for marresearch to see the modifications.
tvtime is a high quality television application for use with video capture
cards. tvtime processes the input from a capture card and displays it on
a computer monitor or projector.
tvtime supports:
- Deinterlaced output
at full interlaced rate of 59.94 frames per second for NTSC source, or 50
frames per second for PAL sources. This gives smoothness of motion and high
visual quality.
- Multiple deinterlacing algorithms for finding the optimal
mode for the video content and available processor speed.
- 16:9 aspect ratio
mode for the highest available resolution when processing input from an
external DVD player or digital satellite receiver.
- A super-slick on-screen-display
for the complete television experience, with a featureful menu system.
Here are the core set of key bindings you want to learn for using
tvtime:
- Escape or q
- Quit
- F1 or tab
- Show menu
- up/down
- Change channels
- 0-9
and Enter
- Change channels
- Backspace
- Jump to previous channel
- i
- Change input
- m
- Mute
- +/- or left/right
- Volume control
- f
- Fullscreen
- s
- Take a screenshot
- Enter
- Display info
- d
Display debug statistics
Here are some advanced keys.
These features are all configurable via the menu, but some of these may
be useful if you use the features often:
- e
- Toggle audio mode (stereo/mono/SAP)
- v
- Toggle always-on-top with supporting window managers
- F5/F6/F7
- Picture settings
- Space
- Restore default picture settings
- /
- Resize the window to match the
content inside it (after applying a matte or switching to 16:9 mode)
- c
- Toggle closed caption decoding (NTSC only)
- -D --decor
- This option
introduced by marresearch removes the window decoration, i.e. all window
borders. You will not be able to move that window any more unless when pressing
the combination of keys Alt+F3.
- -G --xy=X,Y
- This option introduced by marresearch
provides coordinates for the upper left hand corner of the window. When
the program starts up, it will be placed at that location.
- -P --port=PORT|FILE
- This option introduced by marresearch specifies a filename or a TCP/IP
port number. When operating the middle mouse buttons, current x,y coordinates
of the mouse position will be written into the file or onto the TCP/IP-socket.
This is used for transferring information from program martv to program
mar345dtb.
- -y --xhair=XC,YC
- This option introduced by marresearch provides
coordinates for the cross-hair to be displayed on top of the TV window.
- -a, --widescreen
- This option starts tvtime in 16:9 aspect ratio mode.
- -A,
--nowidescreen
- This option starts tvtime in 4:3 aspect ratio mode.
- -h, --help
- Show usage information.
- -k, --slave
- Disables keyboard input in tvtime for
slave mode. Slave mode was added for integration with PVR applications
like freevo or mythtv, so that freevo can handle keyboard input while tvtime
is running. In slave mode, keystrokes are ignored but they are printed
to standard output, and commands are read from standard input in the same
syntax as tvtime-command.
- -m, --fullscreen
- Start tvtime in fullscreen mode.
- -M, --window
- Start tvtime in windowed mode.
- -s, --showdrops
- Print frame skip
information (for debugging).
- -S, --saveoptions
- Save command line options to
the config file. This will save the V4L device, VBI device, input number,
norm, frequency, startup fullscreen setting, aspect ratio, verbose mode,
and output window height.
- -v, --verbose
- The verbose setting indicates that
we should print full informational and warning messages to standard error
while running tvtime. Otherwise, only critical errors will be printed to
the output.
- -F, --configfile=FILE
- Additional config file to load settings
from.
- -g, --geometry=GEOMETRY
- Sets the geometry of the window, for example,
400x300 for a window 400 pixels wide and 300 pixels tall. A width value
of 0 signifies that the appropriate width for the given height will be
used. For 4:3 content on a square pixel display, this defaults to a 768[mu]576
window.
- -I, --inputwidth=SAMPLING
- V4L input scanline sampling (defaults to
720. This sets how many pixels per scanline to request from the capture
card. A higher setting gives better quality, while a lower setting means
we do less work, and so tvtime will run faster. If you have a slower CPU
(like, less than 500Mhz or so), maybe values of 480 or 400 might suit you
best. For best quality, choose a high value like 720 or 768. Many capture
cards cannot sample higher than 768 pixels per scanline.
- -d, --device=NAME
- video4linux device to use (defaults to /dev/video0).
- -b, --vbidevice=DEVICE
- VBI device to use (defaults to /dev/vbi0).
- -i, --input=INPUTNUM
- video4linux
input number (defaults to 0). Cards commonly have a bunch of sources, for
example, on my WinTV card, source 0 is my tuner and source 1 is the composite
input.
- -c, --channel=CHANNEL
- On startup, tvtime will tune to the given channel.
Otherwise, the channels from the config file will be used.
- -n, --norm=NORM
- The mode to set the tuner to (defaults to NTSC). Valid modes are:
| · | NTSC |
| · | PAL |
| · | SECAM |
| · | PAL-NC |
| · | PAL-M |
| · | PAL-N |
| · | NTSC-JP |
- -f, --frequencies=NAME
- The channels you are receiving with the tuner (defaults
to us-cable). Valid values are:
| · | us-cable |
| · | us-broadcast |
| · | japan-cable |
| · | japan-broadcast |
| · | europe |
| · | australia |
| · | australia-optus |
| · | newzealand |
| · | france |
| · | russia |
| · | custom
(first run ’tvtime-scanner’) |
- -t, --xmltv=FILE
- Reads XMLTV listings from the given
file to display on the OSD. Channels are looked up based on their name,
and tvtime will display the show title, sub-title and show description on
the OSD.
- -l, --xmltvlanguage=LANG
- Use XMLTV data in given language, if available.
Languages are represented by their two-letter language code (for example,
"de" for German). The default language used in the file will be used if
this is unset or set to "none"
- -X, --display=DISPLAY
- Uses the given X display
to connect to.
- -x, --mixer=DEVICE[:CH]
- The mixer device and channel for the
volume controls. (defaults to /dev/mixer:line). Valid channels are:
| · | vol |
| · | bass |
| · | treble |
| · | synth |
| · | pcm |
| · | speaker |
| · | line |
| · | mic |
| · | cd |
| · | mix |
| · | pcm2 |
| · | rec |
| · | igain |
| · | ogain |
| · | line1 |
| · | line2 |
| · | line3 |
| · | dig1 |
| · | dig2 |
| · | dig3 |
| · | phin |
| · | phout |
| · | video |
| · | radio |
| · | monitor |
- In order to cooperate with program mar345dtb, program
tvtime obtains initial coordinates for the cross-hair from keyword "VIDEO
ORIGIN x y" in file $MARTABLEDIR/config.$MAR_DTB_NO or $MARTABLEDIR/config.$MAR_SCANNER_NO.
The command line option "--xhair=XC,YC" overrides the values from the configuration
file.
- The display of the cross-hair can be toggled using the OSD menu (press
right mouse button to obtain it), section "Output configuration". The selected
value will be written into the tvtime initialization file (e.g. $HOME/.tvtime/tvtime.xml),
so the choice will be remembered the next time the program starts up.
- When
pressing the middle mouse buttons, the current x,y-coordinates are displayed
in the lower left corner of the TV window and automatically vanish after
a couple of seconds. If a TCP/IP-port number or a filename has been provided
on the command line using option "--port=FILE", the coordinates will be written
to the file or socket, respectively. In the original tvtime program version,
the middle mouse button toggles "mute".
- When starting the program, the program
can be instructed to place its window at a specific location. This is accomplished
by giving the command line option "--xy=X,Y".
- When starting the program,
the program can be instructed to remove its usual window decorations (borders).
This is accomplished by giving the command line option "--decor".
/tvtime/tvtime.xml
$HOME/.tvtime/tvtime.xml
$HOME/.tvtime/stationlist.xml
/var/run/tvtime/TV-*/tvtimefifo
Billy Biggs, Doug Bell, Alexander
S. Belov, Achim Schneider, David I. Lehn, Paul Jara, Robert H[:o]gberg, Craig
Dooley, Bart Dorsey, Nicolas Boos, Simon Law, Mark Trolley, Joachim Koenig,
Stewart Allen, Justin A, Brian Goines, Krister Lagerstrom.
tvtime-command(1)
,
tvtime-configure(1)
, tvtime-scanner(1)
, tvtime.xml(5)
, stationlist.xml(5)
.
Table of Contents