MPEGCAT(1)																MPEGCAT(1)

NAME

       mpegcat - Extracts structural information and PES streams from an MPEG2 video file

SYNOPSIS

       mpegcat { options } { file }

DESCRIPTION

       mpegcat	dumps  detailed  textual information about an MPEG2 file. It also has an option for writing out a particular Packetized Elementary
       Stream (PES) given its id.

       The original purpose of mpegcat was for debugging stream parsing issues in the gopchop cuts-only MPEG2 video editor, but it has	more  gen-
       eral utility.

OPTIONS

   GENERAL OPTIONS
       -d,--debug
	      Report debug info

       -D,--dvd-format
	      Enable DVD packet extensions

       -h,-?,--help
	      Help

       -w,--write FILE,0xID[,0xSID]
	      Write  PES  with	id ID (and subid SID) to FILE.	Sub Picture Unit (SPU) streams such as overlays, subtitles and DVD menus extracted
	      using this option can be displayed using the companion gtkspu utility.

	      To find SPU streams in a .VOB ripped from a DVD:

			      $ mpegcat -iDa VTS_01_0.VOB | grep SPU
				 131086: 0xBD:	DVD Audio 0x20 (SPU 0): 2028 bytes (next marker @ 133120)
				 133134: 0xBD:	DVD Audio 0x20 (SPU 0): 2028 bytes (next marker @ 135168)
				 137230: 0xBD:	DVD Audio 0x20 (SPU 0): 190 bytes (next marker @ 137426)
				 ...

	      To save a given stream:

			      $ mpegcat -iDaw dump.spu,0xBD,0x20 VTS_01_0.VOB > /dev/null

	      (And to view the stream)

			      $ gtkspu dump.spu 1
			      $ gtkspu dump.spu 2
			      $ gtkspu dump.spu 3
			      ...

   PROCESSING TOGGLES
       -V,--enter-video
	      Process video packets (forced by -t option)

   GENERAL DISPLAY TOGGLES
       -p,--pack
	      Toggle Pack packet start display

       -v,--video
	      Toggle video ES packet start display

       -a,--audio
	      Toggle audio ES packet start display

       -o,--other
	      Toggle other stream display (only show video & audio)

       -y,--system
	      Toggle system header display

       -e,--errors
	      Toggle packet errors

       -i,--invert
	      Invert all display toggles

   VIDEO DISPLAY TOGGLES
       -s,--slices
	      Toggle slice starts (default off)

       -q,--sequence
	      Toggle sequence header display

       -g,--GOPs
	      Toggle GOP header display

       -f,--frames
	      Toggle Picture header display

   SHORT CUTS
       -F,--just-frames
	      Show only video frames (same as '-Vepvaoyq')

   FILE OFFSET OPTIONS
       -b,--begin=NUM
	      Start reading at offset NUM

       -n,--num=NUM
	      Stop after reading NUM bytes

       -t,--scan-stream
	      Scan every byte of the stream instead of using PES offsets (this can show erroneous 'start code emulation' codes)

AUTHOR

       Kees Cook, <kees@outflux.net>

SEE ALSO

       gopchop(1), gtkspu(1)

								  28 October 2006							MPEGCAT(1)