NAME

tcextract - read multimedia file from medium, extract or demultiplex requested stream and print to standard output

SYNOPSIS

tcextract

-i name [ -x codec ] [ -t magic ] [ -a track ] [ -C s-e ] [ -d verbosity ] [ -v ]

COPYRIGHT

tcextract is Copyright (C) by Thomas Oestreich.

DESCRIPTION

tcextract is part of and usually called by transcode.
However, it can also be used independently.
tcextract 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. tcextract reads streams from file or from stdin.

-C s-e

extract and print out only this frame interval (video) or bytes (audio) [all]. This option is only supported if the source contains proper information to perform a selective extraction.

-t magic

source file magic. This option is used to identify the source file format if reading is performed from stdin or tcextract fails to identify the source file format. Supported formats are labeled with magic:

avi RIFF AVI-file

vob MPEG program streams

m2v MPEG elementary video stream

vdr MPEG digital video recording

raw raw bitstream

wav RIFF WAVE audio

yuv4mpeg mjpeg-tools stream header format

-x codec

source pdeudo-codec, if not detected when reading from stdin. Currently, supported parameter for codec are

mp3 MPEG audio

ac3 AC3 audio

a52 A52 audio

dv Digital Video DV

mpeg2 MPEG video

yv12 Y'CbCr YUV

rgb RGB 24-bit

ps1 MPEG private stream (subtitles)

pcm raw audio stream

-a track

extract selected audio or video track from source.

-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

tcextract is a front end for extracting various raw or encoded audio/video tracks from a source and is used in transcode's import pipeline.

EXAMPLES

The command tcextract -i foo.avi -x mp3 -a 3 extracts MPEG audio track 3 from the AVI-file foo.avi and prints the bitstream to stdout.

AUTHORS

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

SEE ALSO

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