---
name: "tcextract"
section: "1"
platform: "linux"
package: "transcode"
version: "3:1.1.7-9+b4"
release: "Debian 8 (Jessie)"
platforms: ["linux"]
url: "https://new.carta.tech/tcextract"
---

# tcextract(1)

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

## 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)](/avifix/1.md), [**avisync**(1)](/avisync/1.md), [**avimerge**(1)](/avimerge/1.md), [**avisplit**(1)](/avisplit/1.md), [**tcprobe**(1)](/tcprobe/1.md), [**tcscan**(1)](/tcscan/1.md), [**tccat**(1)](/tccat/1.md), [**tcdemux**(1)](/tcdemux/1.md), [**tcextract**(1)](/tcextract/1.md), [**tcdecode**(1)](/tcdecode/1.md), [**transcode**(1)](/transcode/1.md)