wmtv: Update and tidy up README.

This commit is contained in:
Doug Torrance 2016-02-01 00:45:22 -05:00 committed by Carlos R. Mafra
parent 19e8a20f6e
commit aec6b65e71

View file

@ -1,32 +1,36 @@
=========================================================
WMTV - WindowMaker TV
<wliang@tartarus.uwa.edu.au>
=========================================================
Version : 0.6.5
Release Date : 25th April 1999
================================================================================
WMTV - WindowMaker TV
<wmaker-dev@lists.windowmaker.org>
================================================================================
Description
===========
WMTV is a WindowMaker dock.app that controls TV Cards which are supported under the Linux Kernel 2.2.x series (mainly for cards based on BrookTree BT848/848a/849a/878/879 chipsets: There are lots of cards out there which uses these chipsets such as the Hauppauge WinTV, Aimslab VideoExtreme, miroVIDEO PCTV, AverMedia TVPhone, Spirit TV, MagicXPress TView, Teppro TEV, etc).
WMTV is a WindowMaker dock.app that controls TV Cards which are supported under
the Linux Kernel 2.2.x series (mainly for cards based on BrookTree BT848/848a/
849a/878/879 chipsets: There are lots of cards out there which uses these
chipsets such as the Hauppauge WinTV, Aimslab VideoExtreme, miroVIDEO PCTV,
AverMedia TVPhone, Spirit TV, MagicXPress TView, Teppro TEV, etc).
Installation
============
root/setuid root required to run this program.
2) su
2) make install
1) autoreconf -i
2) ./configure
3) make
4) make install
3) copy wmtvrc.sample to ~/.wmtvrc
4) configure wmtv by editing ~/.wmtvrc or /etc/wmtvrc ( the former takes precedence)
4) configure wmtv by editing ~/.wmtvrc or /etc/wmtvrc
(the former takes precedence)
Note: Dock the application before switching the TV On.
Features
========
WMTV is "Just another gadget(tm)". A miniature sized television screen which sits on your WindowMaker dock. However, it'll become a full featured television application in future major releases.
WMTV is "Just another gadget(tm)". A miniature sized television screen which
sits on your WindowMaker dock. However, it'll become a full featured television
application in future major releases.
Currently supported:
- Channel Presets
@ -34,7 +38,8 @@ Currently supported:
- FineTuning (Television source) - writes to config file now
- Scanning of TV Stations (Television source)
- External TV application support
- All video sources (Television/S-Video/CompositeX) depending on your card
- All video sources (Television/S-Video/CompositeX) depending on your
card
- 8/16/24/32 bit displays
- Modification of config file after WMTV is executed
(Turn Off and Turn On again to reinitialise config file)
@ -49,20 +54,28 @@ Button map:
Tips:
There are 3 modes of operation on this applications.
You can cycle through the 3 modes by clicking on the right most button <3> repeatedly.
You can cycle through the 3 modes by clicking on the right most button <3>
repeatedly.
The 3 modes are described below:
On mode
---------
Clicking on the rightmost button <3> for the first time (after the start of WMTV) would turn TV on. During this mode, the left <1> and right <2> buttons are used to change preset channels which has been defined in your config file. Left button to move down 1 channel and Right button to move up one
channel.
Clicking on the rightmost button <3> for the first time (after the star
of WMTV) would turn TV on. During this mode, the left <1> and right <2>
buttons are used to change preset channels which has been defined in
your config file. Left button to move down 1 channel and Right button
to move up one channel.
Tune mode
---------
Clicking again on button <3> after On mode would bring WMTV into tune mode. During this mode, the left <1> and right <2> buttons have two purposes
individually. Left clicking on the left <1> or right <2> buttons would
perform scans of channels. Scanning will stop when there is a strong signal strength. Right clicking on the left <1> or right <2> button would fine
tune the current frequency. After tuning, clicking on button <3> would set the fine tuned offset into your config file and bring you back into "On mode".
Clicking again on button <3> after On mode would bring WMTV into tune
mode. During this mode, the left <1> and right <2> buttons have two
purposes individually. Left clicking on the left <1> or right <2>
buttons would perform scans of channels. Scanning will stop when there
is a strong signal strength. Right clicking on the left <1> or right <2>
button would fine tune the current frequency. After tuning, clicking on
button <3> would set the fine tuned offset into your config file and
bring you back into "On mode".
Off mode
--------
@ -71,9 +84,12 @@ The 3 modes are described below:
Right clicking once on the TV Screen would mute/unmute the audio.
Double clicking LEFT mouse button on the TV Screen would launch your favorite TV application when specified with --exe <filename> option in the command line.
If the external application is not set, It'll automatically switch to the build in full screen mode.
Double clicking the MIDDLE mouse button on the TV Screen would bring you into the built in full screen mode.
Double clicking LEFT mouse button on the TV Screen would launch your favorite TV
application when specified with --exe <filename> option in the command line.
If the external application is not set, It'll automatically switch to the build
in full screen mode.
Double clicking the MIDDLE mouse button on the TV Screen would bring you into
the built in full screen mode.
To launch an external application:
@ -90,12 +106,12 @@ Full Screen Mode:
Keyboard functions
------------------
Up - Switch preset channels up.
Up - Switch preset channels up.
Down - Switch preset channels down.
Right - Volume up.
Left - Volume down.
Escape - Return to initial screen.
m - mute/unmute audio.
m - mute/unmute audio.
Configuration file
==================
@ -126,7 +142,9 @@ Settings
--------
source = {Television|CompositeX|S-Video} (X is an integer)
freqnorm = {ntsc-bcast|ntsc-cable|ntsc-cable-hrc|ntsc-bcast-jp|ntsc-cable-jp|pal-europe|pal-europe-east|pal-italy|pal-newzealand|pal-australia|pal-ireland}
freqnorm = {ntsc-bcast|ntsc-cable|ntsc-cable-hrc|ntsc-bcast-jp|ntsc-cable-jp|
pal-europe|pal-europe-east|pal-italy|pal-newzealand|pal-australia|
pal-ireland}
maxpreset = integer (maximum channel presets)
@ -145,11 +163,13 @@ separate it with a new line as in the sample config file above.
E5|E6|E7|E8|E9|E10|E11|E12|
R6|R7|R8|R9|R10|R11|R12|
SE11|SE12|SE13|SE14|SE15|SE16|SE17|SE18|SE19|SE20|
S21|S22|S23|S24|S25|S26|S27|S28|S29|S30|S31|S32|S33|S34|S35|S36|S37|S38|S39|S40|S41
S21|S22|S23|S24|S25|S26|S27|S28|S29|S30|S31|S32|S33|S34|S35|S36|S37|S38|S39|
S40|S41
T7|T8|T9|T10|T11|T12|T13|T14|
1 - 125
}
finetune parameters could be added spaced after the channel name above in a bracket.
finetune parameters could be added spaced after the channel name above in a
bracket.
for example:
32 (50) # channel 32 plus 50
@ -179,7 +199,8 @@ NOTE
Please refer to COPYING for licensing info.
This program might not work on your system and there is no way I will be held
responsible for anything.
This does to your system including loss of data, loss of uptime, loss of hair and etc.
This does to your system including loss of data, loss of uptime, loss of hair
and etc.
Please report any bugs/comments/feedbacks to <wliang@tartarus.uwa.edu.au>
Please visit http://www.student.uwa.edu.au/~wliang for updates on WMTV.
Please report any bugs/comments/feedbacks to <wmaker-dev@lists.windowmaker.org>
Please visit http://windowmaker.org/dockapps/?name=wmtv for updates on WMTV.