Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
fbtv(1) 		     General Commands Manual			 fbtv(1)

NAME
     fbtv - a console program for watching TV

SYNOPSIS
     fbtv [ options ] [ station name ]

DESCRIPTION
     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 kernel newer than
     2.1.x to play with this. fbtv shares the config  file  ($HOME/.xawtv)  with
     the  xawtv  application.	Check the xawtv(1) manpage for details about the
     config file format.

OPTIONS
     -h     Display a command line options summary.

     -o base
	    set base string for the snapshot output files.  The filename will be
	    base-timestamp-nr.ext.

     -v     Be verbose.

     -c device
	    video4linux device (default is /dev/video0).

     -D driver
	    video4linux driver (default is libv4l).

     -d device
	    framebuffer device (default is $FRAMEBUFFER; /dev/fb0 if unset)

     -g     grayscaled display (works for 256 color mode only)

     -s widthxheight
	    sets the V4L2 capture in width x height resolution if possible.

     -f font
	    font for text.  Default is to look for lat1-16 console font.  It  no
	    path is specified, it will seek for the font at the following direc-
	    tories:

	      /usr/share/consolefonts/
	      /usr/share/kbd/consolefonts/
	      /usr/lib/kbd/consolefonts/
	      /lib/kbd/consolefonts/

	    If you have a local X11 font server running (or the FONTSERVER envi-
	    ronment  variable set to some working server), you can also give X11
	    font specs here.

     -m mode
	    video mode for TV.	fbtv will look up the mode in /etc/fb.modes.

     -j joydev
	    joystick device to use for controlling fbtv.

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

     -q     quiet  mode.   Doesn't reserve space for the status line at the top,
	    doesn't display the status messages and clock.  When fbtv is started
	    on this mode, it won't try to load the font file at start.

	    You can toggle this at runtime too (using the 'F' key).

     -M     EXPERIMENTAL: Turn on backend scaler mode (write  yuv  to  offscreen
	    memory  and  let the gfx board scale up the video).  Supported hard-
	    ware: 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.

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:

       G	    Grab picture (full size, ppm)
       J	    Grab picture (full size, jpeg)
       F	    Fullscreen.  Toggle quiet mode (see above).

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

       ESC,Q	    Quit
       X	    Quit, but leave sound on.

       +/-	    Volume up/down
       Enter	    mute

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

FULLSCREEN TV
     Some hints from Dag Bakke <dag.bakke@riksnett.no>:

     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  accom-
     plished with the fbset(1) utility, which is available at various locations.
     See: http://www.cs.kuleuven.ac.be/~geert/bin/

     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 avail-
     able. 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.

     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

     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.

     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.

     A database of the standard VESA-modes can be  downloaded  from:  ftp://pla-
     tan.vc.cvut.cz/pub/linux/matrox-latest/fb.modes.vesa60.gz

SEE ALSO
     xawtv(1)

AUTHOR
     Gerd Knorr <kraxel@goldbach.in-berlin.de>

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 un-
     der  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 FIT-
     NESS 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.

			       (c) 1998 Gerd Knorr			 fbtv(1)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=fbtv&sektion=1&manpath=FreeBSD+Ports+15.1.quarterly>

home | help