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 general 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)