File: README

package info (click to toggle)
wmtv 0.6.6-1
  • links: PTS, VCS
  • area: main
  • in suites: bullseye, sid, stretch
  • size: 204 kB
  • ctags: 196
  • sloc: ansic: 1,955; makefile: 19
file content (206 lines) | stat: -rw-r--r-- 5,917 bytes parent folder | download
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
================================================================================
			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).


Installation
============

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)

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.

Currently supported:
	- Channel Presets
	- TV Modes - PAL/Secam/NTSC
	- 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
	- 8/16/24/32 bit displays
	- Modification of config file after WMTV is executed
	  (Turn Off and Turn On again to reinitialise config file)
	- Full Screen display!
	- Icon should be of size 64x64

Button map:

		[ < ] [ > ] [ 0 ]

	     <1>   <2>   <3>

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.
The 3 modes are described below:

	On mode
	---------
	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".

	Off mode
	--------
	Holding down button <3> for about 3 seconds from any of the two modes
	described above, would turn the TV off.

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.

To launch an external application:

foo@bar > wmtv --exe /usr/X11R6/bin/xawtv		# example.
or
foo@bar > wmtv -e /usr/X11R6/bin/xawtv

If you do not specify any program to be launched during startup of WMTV,
double clicking on the TV Screen would launch the inbuilt full screen feature.
Make sure you have a 640x480 Modeline defined in your XF86Config file.

Full Screen Mode:
	Single click on any mouse button will return to initial screen.

	Keyboard functions
	------------------
		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.

Configuration file
==================
This section describes on how to configure WMTV's configuration file.
Your configuration file is located in your home directory as ".wmtvrc".

Excerpt from a sample config file:
/*-----------------------

source = Television
freqnorm = pal-australia
maxpreset = 7
mode = pal
fullscreen = 640x480

[channel]
2
7
9
10
32 (50)
SE11
S21

-------------------------*/

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}

maxpreset = integer (maximum channel presets)

mode = {pal|ntsc|secam}

fullscreen = {widthxheight}

[channel]
choose a total of <maxpreset> from the below channels.
separate it with a new line as in the sample config file above.
{
 E2|E3|E4|
 S01|S02|S03|
 R1|R2|R3|R4|R5|
 SE1|SE2|SE3|SE4|SE5|SE6|SE7|SE8|SE9|SE10|
 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
 T7|T8|T9|T10|T11|T12|T13|T14|
 1 - 125
}
finetune parameters could be added spaced after the channel name above in a
bracket.
for example:
	32 (50) 		# channel 32 plus 50

	or

	SE11 (-10)		# channel SE11 minus 10


TODO
====

- Image Capture
- On Screen Display (OSD)
- Other controls
- Advance image clippings
- Video Capture
- Other misc features


BUGS
====
Ask flik. Bug me if you've found any.


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.

Please report any bugs/comments/feedbacks to <wmaker-dev@lists.windowmaker.org>
Please visit http://windowmaker.org/dockapps/?name=wmtv for updates on WMTV.