aboutsummaryrefslogtreecommitdiffstats
path: root/README
blob: 8d2d13e23e28f7d117827212c7704c01fecd27a6 (plain)
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
small is beautiful
==================

This is a _simple_ xaw-based TV Program which uses the bttv driver or
video4linux (included in 2.1.x).  Copy Policy is GNU GPL.


compile & install
=================

There is modified bttv-0.5.8 in the bttv subdirectory.  Only the
driver itself is included.  If you use the bttv for the first time, I
recommend to get the whole bttv package from Ralph's page (see below)
and check out the documentation. Some (very limited) informations can
be found in the bttv/MODULES file.

$ ./configure --with-bttv=/path/to/bttv/driver && make

should compile xawtv, radio, maybe kradio and v4l-conf.  If you omit
the --with-bttv option, the driver in the bttv directory will be used.

You can install xawtv, v4l-conf and kradio (as root) with:

# make install


usage
=====

bttv
----

Of cource you have to load the modules as very first thing.  There is
a script called "update" in the bttv/drivers directory.  I use this
one to load a new version while doing driver hacking.  You can use it
too, but check the module arguments before.  They work for my setup,
and probably do *not* for yours.  The module arguments are documented
in bttv/driver/MODULES. 

If you have some problems to make the driver work, check out the
Trouble-Shooting file.  Don't expect to get a answer for questions
which are covered there.


v4l-conf
--------

v4l-conf is a small tool which tells video4linux about the current
video mode (size and color depth).  This requires root priviliges,
becauce it is easy to crash the box by passing bogous values there.
It requires the X-Server up and running.  It is a temporary hack, this
problem probably will be solved in a better way later on (Alan plans
to write a X-Server extention).  Try "v4l-conf -h" for a short
description.

It is installed suid-root now, and xawtv runs it at startup.  Should
work out-of-the-box without extra configuration.


xawtv
-----

There is a man page now, check it out.

xawtv will not work without the app-defaults.  You'll get a error
message about a zero-sized shell widget if the app-defaults are
not correctly installed.

If you want to try xawtv without installing it, type...

	$ XUSERFILESEARCHPATH=./%N.ad
	$ export XUSERFILESEARCHPATH
	$ ./xawtv

...to make sure xawtv finds the application defaults (the Xawtv.ad
file).


fbtv
----

TV program for the linux console.  Runs on top of a graphic framebuffer,
tested with vesafb (check vger CVS) so far.  Shares config file
($HOME/.xawtv) and (most) keyboard shortcuts with xawtv.  Read the source
code for details.


set-tv
------

Simple command line tuner.  Reads like xawtv the config file $HOME/.xawtv.
Expects a channel name on the command line.  Assuming you have a station
named [ZDF] in your $HOME/.xawtv file, "set-tv zdf" will tune in the
channel defined there.  That way you can tune in a station to grab
teletext (or whatever) without starting up X11.

It prints some useless messages about video resolution due to the fact that
it shares alot of code with xawtv, maybe I fix this later.


grab-one
--------

Command line tool for grabbing single pictures (full-size, PPM or raw).
Try "grab-one -h" for a description.


dump-mixers
-----------

Just does what the name suggests:  It simply dumps the current mixer
settings to stdout.  I used it to debug the msp3400 module, maybe
someone finds this useful...


vic
---

The grabber-bttv-0.5.6.cc file is a grabber driver for vic, works with
plain bttv-0.5.6.  Up to 12 fps.

There is newer version, grabber-video4linux.cc.  This one runs with newer
bttv versions (0.5.7/8) and the current kernel code.

Both versions are tested only with PAL.  The "large" picture size probably
doest'nt work with NTSC.  

If you plan to compile vic:  It is'nt trivial, you should have some
basic knowledge about C and writing/editing Makefiles. 


radio & kradio
--------------

radio support is still very experimental. If you want to play with it:
* You need a special file for it (/dev/bttv-fm, char dev, major 81,
  minor 64).
* "insmod bttv radio=1"

radio is a quite simple command line radio application.  It just
promps for a (FM) frequency.

kradio is a more comfortable KDE application.  There is a font in the
font subdirectory, it is required for kradio (for a cool LED-Style
display :-).  Make sure the KDEDIR and QTDIR environment variables are
set correctly.


videotext / teletext
--------------------

Ralph has written a software decoder for teletext.  You can donwload
it from his web-page.  There is a program called videoteXt which can
be used to view the teletext pages.  A link to this package is on
Ralphs page too.


resources
=========

http://www.cs.tu-berlin.de/~kraxel/linux/#xawtv		- xawtv       [me]
http://www.thp.uni-koeln.de/~rjkm/linux/bttv.html	- bttv driver [Ralph]
http://roadrunner.swansea.uk.linux.org/v4l.shtml	- video4linux [Alan]
http://www-nrg.ee.lbl.gov/vic/				- vic
http://www.kde.org					- KDE


Have fun!

  Gerd

--
Gerd Knorr <kraxel@cs.tu-berlin.de>

Privacy Policy