NAME

       tcdemux - demultiplex a program stream

SYNOPSIS

       tcdemux
              -i  name  [ -t magic ] [ -x codec ] [ -S unit,[s1-s2] ] [ -a ach,[vch] ] [ -s 0xnn ] [ -M mode ] [
              -f fps ] [ -W ] [ -O ] [ -P name ] [ -A n[,m[,...]]  ] [ -d verbosity ] [ -v ]

COPYRIGHT

       tcdemux is Copyright (C) by Thomas Oestreich.

DESCRIPTION

       tcdemux is part of and usually called by transcode.
       However, it can also be used independently.
       tcdemux reads source (from stdin if not explicitely defined) and prints on the standard output.

OPTIONS

       -i name
              Specify input source.  If ommited, stdin is assumed.

       -x codec
              Process only packets containing given codec as payload.  Examples are "mpeg2" for  MPEG  video  or
              "ac3" for audio packets.

       -t magic
              Specify  the  input  file  type  magic.   Useful  for using tcdemux in pipelines. This is normally
              autodetected.

       -a ach[,vch]
              Process only packets containing given audio track ach and video track vch.   Most  program  stream
              feature multiple audio tracks but only a single video stream. Default is "-a 0,0".

       -s 0xnn
              Select  specific  multimedia  track  using  the  standard identifier 0xnn.  This useful to extract
              subtitle packets.

       -f fps Specify the frame rate fps for subtitle meta information used by external applications.

       -S unit[,s1-s2]
              Select a program unit unit and a selected GOP range s1-s2 for processing. A unit is usually a  set
              of  GOPs  that need to be synchronized at the very beginning. This option can be used to eleminate
              junk units at the beginning of the main presentation or to select certain episodes of a TV  series
              from  a  DVD. A GOP is a logical unit to be properly decoded, i.e., decoding can only start at the
              beginning of a GOP.

       -O     Do not skip initial sequence. Used internally by transcode.

       -A n[,m[,...]]
              Select packets using an identifier for extracting only selected streams without  processing.  This
              is useful for size reduction of your multimedia stream. Example:

              tcdemux -i big_dvd.vob -A 0xe0,0x81,0x20 > small_dvd.vob

              extracts all packets for the video stream, AC3 audio track (1) and the first subtitle stream (0).

       -M mode
              Select  synchronization strategy mode.  This is how transcode selects the beginning of a video and
              audio stream to assure both streams are sychronized for further processing:

              0    no synchronization. Packets are printed directly to stdout.

              1    synchronization based on PTS information found  in  the  packet  header.  Audio  packets  are
              delayed until a suitable starting point is found. Default for PAL videos.

              2    NTSC  adapted  synchronization mode. Detailed information for each GOP contained in the video
              stream are piped to a stdout to be processed by the certain import modules. This enables adjusting
              the frame rate or inverse telecine, if necessary.

              3        more  advanced synchronization mode 1 with msec granular adjustment. Details delegated to
              transcode.

              4       more advanced synchronization mode 2 with msec  granular  adjustment  for  NTSC  materail.
              Details delegated to transcode.

              5-7  undocumented debugging modes for internal use.

       -P file
              Write GOP meta information to file instead of tdout.

       -W     Print  a navigation log file for a given video stream to stdout. This is used for transcode's "psu
              mode" and "cluster mode".

       -d level
              With this option you can specify a bitmask to enable different levels of verbosity (if supported).
              You can combine several levels by adding the corresponding values:

              QUIET         0

              INFO          1

              DEBUG         2

              STATS         4

              WATCH         8

              FLIST        16

              VIDCORE      32

              SYNC         64

              COUNTER     128

              PRIVATE     256

       -v     Print version information and exit.

NOTES

       tcdemux is a front end for de-multiplexing program streams and is used in transcode's import modules.

EXAMPLES

       The command

       tcprobe -i movie.vob -x mpeg2

       extracts  only  MPEG  video  packets. Further processing, i.e., extracting the elementary video stream is
       done by tcextract.

AUTHORS

       tcdemux was written by Thomas Oestreich
       <ostreich@theorie.physik.uni-goettingen.de>  with  contributions  from  many  others.   See  AUTHORS  for
       details.

SEE ALSO

       avifix(1),   avimerge(1),   avisplit(1),  tcdecode(1),  tcdemux(1),  tcextract(1),  tccat(1),  tcscan(1),
       transcode(1)