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>