'\" t
.\"     Title: zapping
.\"    Author: [see the "Authors" section]
.\" Generator: DocBook XSL Stylesheets v1.78.1 <http://docbook.sf.net/>
.\"      Date: 10/15/2014
.\"    Manual: [FIXME: manual]
.\"    Source: [FIXME: source]
.\"  Language: English
.\"
.TH "ZAPPING" "1" "10/15/2014" "[FIXME: source]" "[FIXME: manual]"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
zapping \- a Gnome TV and Teletext viewer
.SH "SYNOPSIS"
.HP \w'\fBzapping\fR\ 'u
\fBzapping\fR [\-b,\ \-\-bpp\ \fINUMBER\fR] [\-c,\ \-\-command\ \fISTRING\fR] [\-\-console\-errors] [\-\-cpu\-features\ \fIFEATURES\fR] [\-d,\ \-\-debug] [\-\-device\ \fIFILENAME\fR] [\-\-dword\-align] [\-n,\ \-\-tunerless\-norm\ \fISTRING\fR] [\-\-no\-overlay,\ \-\-remote] [\-\-no\-plugins] [\-\-no\-vbi] [\-\-no\-xv\-image] [\-\-no\-xv\-video] [\-v,\ \-\-no\-xv] [\-\-xv\-image\-port\ \fINUMBER\fR] [\-\-xv\-port\ \fINUMBER\fR,\ \-\-xv\-video\-port\ \fINUMBER\fR] [\-y,\ \-\-yuv\-format\ \fISTRING\fR] [\-z,\ \-\-no\-zsfb]
.SH "DESCRIPTION"
.PP
Zapping
is a program to watch TV on a computer, within the Gnome environment\&. You can take screenshots and record video and audio\&.
Zapping
has a Teletext viewer built in and supports Closed Caption and Teletext subtitles\&. For more information open the Gnome help and choose Applications \-> Multimedia \-> Zapping\&. This manual page refers to
\fBzapping\fR
version 0\&.10\&.
.SH "OPTIONS"
.PP
\fB\-b, \-\-bpp \fR\fB\fINUMBER\fR\fR
.RS 4
Color depth of the X display\&. In TrueColor mode (24 or 32 bits per pixel) you might get a very distorted image that spreads all around the desktop\&. This usually means
Zapping
could not correctly determine the color depth, which can be given here\&.
.RE
.PP
\fB\-c, \-\-command \fR\fB\fICOMMAND\fR\fR
.RS 4
Execute the given command and exit\&. This was intended to create a sort of batch mode, you may want to use
\fBzapping_remote\fR(1)
instead\&. Only one command is implemented\&. The
\fBset_channel\fR
command allows one to change the channel by giving the channel name or RF channel number, for example:
.sp
.if n \{\
.RS 4
.\}
.nf
zapping \-c "set_channel BBC"
.fi
.if n \{\
.RE
.\}
.RE
.PP
\fB\-\-console\-errors\fR
.RS 4
Redirect the error messages to the console, useful for bug reports\&.
.RE
.PP
\fB\-\-cpu\-features\fR \fIFEATURES\fR
.RS 4
Override the CPU detection for tests\&. Possible features are: none, mmx, 3dnow, sse, sse2, sse3, altivec\&. When your CPU does not support the given features
Zapping
may crash\&.
.RE
.PP
\fB\-d, \-\-debug\fR
.RS 4
Print debug messages on standard output\&. You should include this information when submitting a bug report, as it can help to trace the problem\&.
.RE
.PP
\fB\-\-device \fR\fB\fIFILENAME\fR\fR
.RS 4
Kernel video device to use, usually
/dev/video\&. You can specify
emulator
for tests\&.
.RE
.PP
\fB\-\-dword\-align\fR
.RS 4
Forces doubleword alignment of the video in overlay mode\&. Can help when the image is distorted at certain sizes but looks fine at others\&.
.RE
.PP
\fB\-n, \-\-tunerless\-norm \fR\fB\fISTRING\fR\fR
.RS 4
This option has no function but is recognized for compatibility with earlier versions of
Zapping\&. It determined the video standard to be used when your TV card has no tuner, one of NTSC, PAL or SECAM\&.
.RE
.PP
\fB\-\-no\-overlay, \-\-remote\fR
.RS 4
Do not overlay video\&. The
\fB\-\-remote\fR
option refers to the X display\&. Overlay is only possible if the graphics card and TV card are plugged into the same computer\&. Capture mode is possible on a remote display (on another computer or in a nested display) but requires a high network bandwidth\&.
.RE
.PP
\fB\-\-no\-plugins\fR
.RS 4
Do not use any plugins, usually for testing purposes\&.
.RE
.PP
\fB\-\-no\-vbi\fR
.RS 4
Do not capture and decode VBI data, i\&.e\&. Teletext, Subtitles, Closed Caption and station names\&. This option is intended for tests and applies only to the current session\&. To override it or disable VBI support permanently see the Devices \-> VBI section in the
Zapping
preferences\&.
.RE
.PP
\fB\-\-no\-xv\-video\fR
.RS 4
Do not use the XVideo extension for video overlay\&.
.RE
.PP
\fB\-\-no\-xv\-image\fR
.RS 4
Do not use the XVideo extension for hardware image scaling\&.
.RE
.PP
\fB\-v, \-\-no\-xv\fR
.RS 4
Do not use the XVideo extension for video overlay or hardware image scaling\&.
.RE
.PP
\fB\-\-xv\-image\-port \fR\fB\fINUMBER\fR\fR
.RS 4
Number of the XVideo port to use for hardware image scaling\&. Zapping lists the available ports with the
\fB\-d\fR
option\&.
.RE
.PP
\fB\-\-xv\-port \fR\fB\fINUMBER\fR\fR\fB, \-\-xv\-video\-port \fR\fB\fINUMBER\fR\fR
.RS 4
Number of the XVideo port (similar to a device) to use for video overlay\&. Zapping lists the available ports with the
\fB\-d\fR
option\&.
.RE
.PP
\fB\-y, \-\-yuv\-format \fR\fB\fISTRING\fR\fR
.RS 4
This option has no function but is recognized for compatibility with earlier versions of
Zapping\&. It determined the pixel format in capture mode when XVideo hardware image scaling was available, either YUYV or YVU420\&.
.RE
.PP
\fB\-z, \-\-no\-zsfb\fR
.RS 4
This option has no function but is recognized for compatibility with earlier versions of
Zapping\&. It used to prevent the execution of
\fBzapping_setup_fb\fR(1)
on startup\&. Now
Zapping
calls the helper application only if necessary\&.
.RE
.SH "SEE ALSO"
.PP
\fBzapping_remote\fR(1),
\fBzapping_setup_fb\fR(1)
.SH "AUTHORS"
.PP
Zapping
was written by Iñaki García Etxebarria, Michael H\&. Schimek (mschimek@users\&.sourceforge\&.net) and many contributors\&.
.PP
This manual page was written by Michael H\&. Schimek based on work by Christian Marillat\&.
.SH "CONTACT"
.PP
Zapping
homepage: http://zapping\&.sourceforge\&.net
.PP
Please report bugs with the
Zapping
bug tracker http://sourceforge\&.net/tracker/?group_id=2599 or mail us at zapping\-misc@lists\&.sourceforge\&.net