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 WMTV - WindowMaker TV
<wliang@tartarus.uwa.edu.au> <wmaker-dev@lists.windowmaker.org>
========================================================= ================================================================================
Version : 0.6.5
Release Date : 25th April 1999
Description 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 Installation
============ ============
root/setuid root required to run this program.
2) su 1) autoreconf -i
2) make install 2) ./configure
3) make
4) make install
3) copy wmtvrc.sample to ~/.wmtvrc 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. Note: Dock the application before switching the TV On.
Features 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: Currently supported:
- Channel Presets - Channel Presets
@ -34,7 +38,8 @@ Currently supported:
- FineTuning (Television source) - writes to config file now - FineTuning (Television source) - writes to config file now
- Scanning of TV Stations (Television source) - Scanning of TV Stations (Television source)
- External TV application support - 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 - 8/16/24/32 bit displays
- Modification of config file after WMTV is executed - Modification of config file after WMTV is executed
(Turn Off and Turn On again to reinitialise config file) (Turn Off and Turn On again to reinitialise config file)
@ -49,20 +54,28 @@ Button map:
Tips: Tips:
There are 3 modes of operation on this applications. 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: The 3 modes are described below:
On mode 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 Clicking on the rightmost button <3> for the first time (after the star
channel. 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 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 Clicking again on button <3> after On mode would bring WMTV into tune
individually. Left clicking on the left <1> or right <2> buttons would mode. During this mode, the left <1> and right <2> buttons have two
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 purposes individually. Left clicking on the left <1> or right <2>
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". 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 Off mode
-------- --------
@ -71,9 +84,12 @@ The 3 modes are described below:
Right clicking once on the TV Screen would mute/unmute the audio. 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. Double clicking LEFT mouse button on the TV Screen would launch your favorite TV
If the external application is not set, It'll automatically switch to the build in full screen mode. application when specified with --exe <filename> option in the command line.
Double clicking the MIDDLE mouse button on the TV Screen would bring you into the built in full screen mode. 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: To launch an external application:
@ -126,7 +142,9 @@ Settings
-------- --------
source = {Television|CompositeX|S-Video} (X is an integer) 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) 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| E5|E6|E7|E8|E9|E10|E11|E12|
R6|R7|R8|R9|R10|R11|R12| R6|R7|R8|R9|R10|R11|R12|
SE11|SE12|SE13|SE14|SE15|SE16|SE17|SE18|SE19|SE20| 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| T7|T8|T9|T10|T11|T12|T13|T14|
1 - 125 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: for example:
32 (50) # channel 32 plus 50 32 (50) # channel 32 plus 50
@ -179,7 +199,8 @@ NOTE
Please refer to COPYING for licensing info. Please refer to COPYING for licensing info.
This program might not work on your system and there is no way I will be held This program might not work on your system and there is no way I will be held
responsible for anything. 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 report any bugs/comments/feedbacks to <wmaker-dev@lists.windowmaker.org>
Please visit http://www.student.uwa.edu.au/~wliang for updates on WMTV. Please visit http://windowmaker.org/dockapps/?name=wmtv for updates on WMTV.