aboutsummaryrefslogtreecommitdiffstats
path: root/man/fbtv.1
blob: e8aa92ccec732ef0a7ab410bf75daf3726b16030 (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
.TH fbtv 1 "(c) 1998 Gerd Knorr"
.SH NAME
fbtv - a console program for watching TV
.SH SYNOPSIS
.B fbtv [ options ] [ station name ]
.SH DESCRIPTION
.B fbtv
is a program for watching TV with your linux box.  It runs on top of a
graphic framebuffer device (/dev/fb0).  You'll need a new 2.1.x kernel
to play with this.
.B fbtv
shares the config file ($HOME/.xawtv) with the
.B xawtv
application.  Check the xawtv(1) manpage for details about the config
file format.
.SH OPTIONS
.TP
.B -o base
set basestring for the snapshot output files.  The filename will be
"base-timestamp-nr.ext".
.TP
.B -v
Be verbose.
.TP
.B -c device
video4linux device (default is /dev/video0).
.TP
.B -d device
framebuffer device (default is $FRAMEBUFFER; /dev/fb0 if unset)
.TP
.B -g
grayscaled display (works for 256 color mode only)
.TP
.B -s widthxheight
display the TV picture in
.B width
x
.B height
size in the upper right corner.
.TP
.B -f font
font for text.  Default is to look for lat1-16.psf in
/usr/lib/kbd/consolefonts and /usr/share/consolefonts.  If you have a
local X11 font server running (or the FONTSERVER environment variable
set to some working server), you can also give X11 font specs here.
.TP
.B -m mode
video mode for TV.  fbtv will look up the mode in /etc/fb.modes.
.TP
.B -j joydev
joystick device to use for controlling fbtv.
.TP
.B -k
keep capture on when switching consoles.  Might be useful together
with -s switch, you have a video picture while working on another
console.  This is more or less a dirty hack.  Works only if all
your consoles have the same video mode and fbcon does not use
panning to speed up scrolling.  For a multiheaded setup this
is useful too.
.TP
.B -q
quiet mode.  Doesn't reserve space for the status line at the top,
doesn't display the status messages and clock.  You can toggle this
at runtime too ('F').
.TP
.B -M
EXPERIMENTAL: Turn on backend scaler mode (write yuv to offscreen
memory and let the gfx board scale up the video).  Supported hardware:
Matrox G200/G400 (with matroxfb) and ATI Mach64 VT/GT (with atyfb,
16bpp only).  You'll need at least bttv-0.7.16 or kernel 2.3.50.
.SH USAGE
fbtv is supported to work much like xawtv from user's point of view.
You might have noticed that xawtv has a lot of keyboard shortcuts.
They work in fbtv too (if it useful).  Here is the list:

.nf
G            \fBG\fPrab picture (full size, ppm)
J            Grab picture (full size, \fBj\fPpeg)
F            \fBF\fPullscreen.  Toggle quiet mode (see above).

up/down      tune up/down one channel
left/right   fine tuning
pgup/pgdown  station up/down

ESC,Q        \fBQ\fPuit
X            \fBQ\fPuit, but leave sound on.

+/-          Volume up/down
Enter        mute
.fi

The channel hotkeys defined in $HOME/.xawtv are supported too, with one
exception: modifier keys (something like "key = Ctrl+F1") do not work.

.SH FULLSCREEN TV
Some hints from Dag Bakke <dag.bakke@riksnett.no>:
.P
The BT8xx cards can produce images up to 768x576 pixels.  In order to
have fbtv make use of your entire monitor-size and get maximum image
quality, you need to create a 768x576 pixels framebufferconsole. This
can be accomplished with the fbset(1) utility, which is availabile at
various locations.  See: http://www.cs.kuleuven.ac.be/~geert/bin/
.P
Or, you can let fbtv handle the videomode changes with the -m switch.
This requires that you have a small database with the various
videomodes availabile. The file containing the videomodes is normally
named /etc/fb.modes. For example, the following entry produces a
768x576x32bpp mode, with 75Hz refresh on a Matrox G200.

.nf
mode "tv"
    # D: 49.188 MHz, H: 46.580 kHz, V: 75.008 Hz
    geometry 768 576 768 576 32
    timings 20330 128 32 32 8 128 5
endmode
.fi

The command "fbtv -q -mtv" thus gives you crisp clear (well, as
good as the received signal anyway) tv on your entire screen. Alias
this command to 'tv', and you're set.
.P
.B NB!
Please note that your monitor may or may not be able to handle such a
"custom" resolution. And that misuse of the aforementioned fbset
utility can toast your monitor. It is a lot easier to pull smoke out
of electronic components, than to put it back in.
.P
A database of the standard VESA-modes can be downloaded from:
ftp://platan.vc.cvut.cz/pub/linux/matrox-latest/fb.modes.vesa60.gz

.SH SEE ALSO
xawtv(1)
.SH AUTHOR
Gerd Knorr <kraxel@goldbach.in-berlin.de>
.SH COPYRIGHT
Copyright (C) 1997,98 Gerd Knorr <kraxel@goldbach.in-berlin.de>

This program is free software; you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation; either version 2 of the License, or
(at your option) any later version.

This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
GNU General Public License for more details.

You should have received a copy of the GNU General Public License
along with this program; if not, write to the Free Software
Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.

Privacy Policy