tcdemux(1)						      General Commands Manual							tcdemux(1)

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 synchro-
	      nized 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)

tcdemux(1)							 09th January 2003							tcdemux(1)