dvbsnoop   - an open source DVB/MPEG stream analyzer
====================================================


http://dvbsnoop.sourceforge.net/
http://cvs.tuxbox.org/



dvbsnoop is a DVB/MPEG stream analyzer program.
The program can be used to sniff, monitor, debug, dump
or view DVB/MPEG/DSM-CC/MHP stream information (digital
television or data broadcasts) sent via satellite, cable
or terrestrial.

The program was mainly written to learn and understand the DVB 
protocol structures and streams. dvbsnoop is currently part of
the tuxbox project, bringing Linux based TV software to some
set top boxes (digital satellite/cable receivers).


Documentation and example outputs can be found at:

	http://dvbsnoop.sourceforge.net



Disclaimer:
===========
  You are using this program at your own risk!
  This program may not be used to hack pay tv or encrypted dvb services
  in any way.



License: 
========

	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




Basic requirements:
===================

  - a DVB card (not needed for offline decoding of recorded files)
  - Linux DVB API version 1 or 3 installed (see www.linuxtv.org)
 or
  - a Linux based set top box (using DVB API version 1 or 3)
    (e.g. 'dbox2' or 'dreambox')



Installation:
=============
  - install the DVB API driver from http://www.linuxtv.org
    (linux kernel 2.6.x and above are already providing the DVB API)

  - download the latest source from http://dvbsnoop.sourceforge.net
    (download a tarball or checkout from cvs)

  - unzip and untar the archive (if needed)
      gzip -d  dvbsnoop-<version>.tar.gz
      tar xvf  dvbsnoop-<version>.tar
      cd dvbsnoop-<version>

  - configure the source
      ./autogen.sh	# e.g. on "dbox2" cdk, use if needed
      ./configure
    
    or you may specify a path to DVB API include files
      ./configure CPPFLAGS=-I/path/to/dvb-kernel/linux/include

  - compile 
      make
      make install

  - test
      dvbsnoop -help

  - PROBLEMS compiling dvbsnoop?
      dvbsnoop should compile smoothly on any ANSI-C-Compiler. But it was
      tested on GCC (gcc-3.x) only.
      If you see any problems during 'autoconf.sh' or 'configure' execution,
      please check if you have the latest versions of 'autoconf' and 'configure'
      installed. In cases, please update your system (check packages 
      automake, autoconf and libtool).



Posting dvbsnoop output:
========================
  If you are posting dvbsnoop output to mailing lists, newsgroups, public boards
  or whatever, please always include the dvbsnoop header:

   e.g.: " dvbsnoop V1.2.49 -- http://dvbsnoop.sourceforge.net/" 

   The version information is helpful if there are discussions about the
   decoding output.



Using source code snippets or dvbsnoop knowledge for your own purpose:
======================================================================
  Feel free to use dvbsnoop source for your own programs as knowledge 
  or code base.  In any cases, please include a link or reference to
  dvbsnoop in your program or documentation... Thanks.



Bugs, requests:
===============
  Well, if you find some bugs, please let me know.
  (check first, if the data stream is not broken).

  Please do not send binary data stream files or large 
  decoding output via email! (If needed, I will ask for it!)
  But it is a good advise to save the data stream using
  the option "dvbsnoop -s ... -b ... > file" on your harddrive.
  It might be helpful for further investigations.

  To prevent spam-filtering please preceed your mail subject
  with "dvbsnoop: "  (e.g. mail topic: "dvbsnoop: bugreport xyz")



Keywords:
=========
    DVB stream analyzer mpeg stream analyzer, TS stream analyzer, MPEG,
    MPG, descriptor, digital television, satellite TV, cable TV, DVB-C,
    DVB-S, DVB-T, MHP, DSM-CC, SI, PES, TOT, PAT, PMT, SDT, EIT, NIT,
    TDST, RST, SIT, DIT, BAT, EMM, ECM, PSI, SI tables, SSU, INT, UNT, datagram,
    sections, transport stream analyzer, packetized elementary stream, demux,
    ISO/IEC 13818-1, ISO/IEC 13818-6, ETSI EN 300468, ETSI EN 301162,
    ETSI TS 102006, ETSI EN 301192, ETSI TR 101202, ITU H.222.0,
    data carousel, object carousel, dvb snoop, TV ANYTIME


   


(c) 2001-2005   Rainer Scherg (Rainer.Scherg@gmx.de)
http://dvbsnoop.sourceforge.net