NAME

       mpegdemux - MPEG1/2 system stream demultiplexer

SYNOPSIS

       mpegdemux [options] [input [output]]

DESCRIPTION

       mpegdemux(1)  is  an  MPEG1/MPEG2  system stream demultiplexer. It can be used to list the
       contents of an MPEG system stream and to extract elementary streams.

       mpegdemux(1) has four primary modes of operation:

       scan   In this mode the MPEG system stream is scanned for elementary streams.

       list   In this mode the contents of an MPEG system stream are listed in  a  textual  form.
              This is useful to get an overview of what's in an MPEG file

       demux  In  this  mode  elementary  streams  are  extracted from an MPEG system stream. The
              system stream  packet  structure  is  dissolved  in  the  process.  Typically  each
              extracted stream is written to its own file.

       remux  This  is  like  demux, except that the MPEG system stream structure is left intact.
              This means that the output is again an MPEG system stream with all but the selected
              elementary streams removed.

OPTIONS

       -a, --ac3
              AC3 sound packets in DVD MPEG2 streams have a 3 byte header that is neither part of
              the MPEG specification nor of the AC3 specification.  When  this  option  is  used,
              these  3  bytes  are removed to produce a correct AC3 stream. Note that this option
              applies to all selected substreams without checking whether they  actually  contain
              an AC3 elementary stream.

       -b, --base-name name
              When  demultiplexing  more  than one stream, the output file names can be set using
              this option. To generate the output file name for a stream, every  #  character  in
              name is replaced by a hex digit of the stream id. For example, to extract all video
              streams in one go, use something like

              $ mpegdemux -d -b video_##.m1v -s 0xc0-0xcf src.mpg

              to get files video_c0.m1v, video_c1.m1v, ...

       -c --scan
              Scan a system stream for elementary streams. This is the default mode. All  streams
              and substreams are automatically selected when using this option.

       -d, --demux
              Demultiplex  an  MPEG  system  stream. The demultiplexed streams are written to the
              output file unless the --base-name option is used. If the --base-name option is not
              used,  only  one  stream  can be demultiplexed (if more streams are specified, they
              will be randomly interleaved in the output file).

       -D, --no-drop
              Don't drop incomplete packets in demuxing and remuxing mode.

       -e, --no-end
              Don't print end codes in listing mode. Additionally, in remuxing  mode,  make  sure
              that there is exactly one end code at the end of the stream.

       -E, --empty-packs
              When  streams  are removed during remuxing, packs can become empty. Including these
              empty packs in the output is pointless and therefore is not done  by  default.  Use
              this option to force inclusion of all packs.

       -F, --first-pts
              In  scan mode, in addition to each stream's first packet, also list the packet with
              the lowest presentation time stamp.

       -h, --no-system-headers
              Don't print system headers in listing mode. Additionally, in remuxing  mode,  don't
              repeat system headers.

       -i, --invalid spec
              Select  invalid  streams.  Packets of invalid streams are not recognized as packets
              and their contents are parsed as MPEG system stream data rather than being skipped.
              This  is  useful  for broken/incomplete streams. The syntax for spec is the same as
              for -s.  Additionally, if spec is "-" then all  streams  that  have  not  yet  been
              selected by -s are made invalid.

       -k, --no-packs
              Don't print packs in listing mode.

       -K, --remux-skipped
              Copy bytes that are skipped while looking for a start code.

       -l, --list
              List the system headers, packs and packets in an MPEG system stream.

       -m, --packet-max-size size
              Set  the  maximum  packet size to size. Packets in the input stream that are larger
              are considered invalid. As with the -i option, the packet is not simply skipped but
              parsed as MPEG system stream data.

       -p, --substream spec
              This  option  selects  private  substreams.  Whenever  Private  Stream  1 (0xbd) is
              selected using -s, the substreams within that private stream can be selected  using
              -p. The syntax for spec is the same as for -s.

       -P, --substream-map id1 id2
              Remap substream id1 to id2 when remuxing.

       -r, --remux
              Remultiplex  an MPEG system stream. The output MPEG system stream is written to the
              output file. Many options control what is copied from the input to the  output  and
              what is discarded.

       -s, --streams spec
              This option selects streams. spec specifies the stream IDs in the following form:

              [+|-]<id>[-<id>]{/[+|-]<id>[-<id>]}

              where  id is either a numeric stream ID or one of all or none. A "-" in front of an
              ID range means exclusion. For example the spec

              -s 0xc0-0xcf/-0xc2

              selects all video streams (0xc0 - 0xcf) except stream 0xc2.

       -S, --stream-map id1 id2
              Remap stream id1 to id2 when remuxing.

       -t, --no-packets
              Don't print packets in listing mode.

       -u, --spu
              This option is used to extract DVD subtitles. It is necessary because the  subtitle
              streams  on  DVD  don't  contain all the timing information (the time stamps in the
              packet headers are required). If this option is  used  during  demultiplexing,  the
              output files for all substreams are written in the following format:

              "SPU " (4 bytes)

              PTS (8 bytes, MSB first)
              SPU packet

              PTS (8 bytes)
              SPU packet

              and so on

       -x, --split
              Split  the remuxed stream at sequence boundaries. This option is only meaningful in
              remuxing mode. It can not be used together  with  the  -e  option.  The  individual
              sequences are written to files whose name was set with the -b option.

       --help Print usage information

       --version
              Print version information

EXAMPLES

       Scan a system stream for elementary streams:

       $ mpegdemux -c -v src.mpg

       List the contents of an MPEG system stream:

       $ mpegdemux -l -k -s all -p all src.mpg

       Extract the first video stream:

       $ mpegdemux -d -s 0xe0 src.mpg dst.m1v

       Extract all audio streams:

       $ mpegdemux -d -s 0xc0-0xdf -b audio_##.mpa src.mpg

       Remove the second video stream:

       $ mpegdemux -r -s all/-0xc1 -p all src.mpg dst.mpg

       Extract the first AC3 audio stream from a DVD MPEG2 system stream:

       $ mpegdemux -d -s 0xbd -p 0x80 --ac3 src.mpg dst.ac3

       Exchange the first and the second audio stream:

       $ mpegdemux -r -s all -p all -S 0xc0 0xc1 -S 0xc1 0xc0 src.mpg dst.mpg

SEE ALSO

       mplex(1)

AUTHOR

       Hampa Hug <hampa@hampa.ch>