transcode_export (1)

NAME

transcode - export modules collection

SYNOPSIS

transcode -y module[,module[,module]] [other options]

COPYRIGHT

transcode is Copyright (C) 2001-2003 by Thomas Oestreich, 2003-2004 Tilmann Bitterberg, 2004-2010 Transcode Team

ENCODER PARAMETERS STRING

Module-dependent parameters can be passed to encoder using the -F transcode(1) option:

transcode -F codec_string

Those parameters tune the general behaviour of the export module. More specific settings can fine-tune the export settings. Those settings are passed to export modules through module options or through the module configuration file; both configuration file and options can be present at same time: in that case, the options overrides the configuration file. Passing option strings to export modules is done like to pass options to filter modules: The syntax is:

transcode -y vmod=options,amod=options

see transcode_filter(1) for full reference and examples.
The -F parameter has different meanings for different export modules, as documented on section below.

ENCODER MODULES PARAMETERS

ffmpeg:

  The codec String for the codec you want to encode. Example values are -F mpeg4 or -F mpeg1video or -F huffyuv. To get a list of valid codecs, use -F list

im:

  The name of the image format you want to export. Example values are '-F jpg' (default) or '-F png' or -F 'gif'. With -F jpg, -w gives quality in percent. With -F png, the first digit of -w gives compression level, the second one gives quality, so -w 95 selects best compression level (9) and 5 means PNG adaptive filtering.

jpg:

  The quality of the JPEG encode in percent. Example values are '-F 75' (default) or '-F 100'

mov:

  Syntax: -F "<vcodec>,<acodec>[,<parameters>]"
    <vcodec> = Videocodec to encode with. Default: "mjpa"
    <acodec> = Audiocodec to encode with. Default: "ima4"
    <parameters> = A comma seperated list of parameters
                   to be passed to the codec.
Note: You can use "list" instead of a video/audiocodec or parameter to get a list of supported options.

mpeg:

  Syntax: -F "<base-profile>[,<resizer-mode>[,user-profile]]"
    <base-profile> can be one of
      '1' = MPEG 1 (default)
      'b' = big MPEG 1 (experimental)
      'v' = VCD
      's' = SVCD
      '2' = MPEG2
      'd' = DVD compliant
    <resizer-mode> can be one of
       0 = disable resizer (default)
       1 = 352x288
       2 = 480x480
       3 = 480x576
       4 = 352x240
    <user-profile> is a filename of the profile file. You can either specify the absolute path to the file or if you transcode will look for it in the directory where you started transcode.

mpeg2enc:

  Syntax: -F "<base-profile>[,<options_string>]"
    <base-profile> can be one of
      '0' = Generic MPEG1 (default)
      '1' = Standard VCD
      '2' = User VCD
      '3' = Generic MPEG2
      '4' = Standard SVCD
      '5' = User SVCD
      '6' = Manual parameter mode
      '8' = DVD
    <options_string> will be passed down to mpeg2enc untouched by transcode. Have a look at the manpage for mpeg2enc.

raw:

  The name of the image format to use for uncompressed video. Examples are I420 (YUV 4:2:0 planar), YV12 (the same thing with U and V reversed), or UYVY (YUV 4:2:2 packed). Use "-F help" to get a list of formats.

EXPORT MODULES

If no module is specified through the -y option, transcode will use the null module for both audio and video export. If a multiplex module is given, by giving three export module names instead the usual two, transcode will use the new-style encode/multiplex modules (still under development, see the encode and multiplex directories); if no multiplex module is given, the traditional export modules will be used.
To see what export modules are avalaible for your transcode installation, do a

ls -1 $( tcmodinfo -p )/export*.so

A complete transcode installation has the following export modules:

ac3 - (video) null | (audio) ac3

This module has no compile-time dependencies. At run-time ffmpeg must be present. Support for this module is good.

Encodes audio (raw PCM) to AC3 via the ffmpeg binary.
Supported processing formats: audio - PCM, video - none

af6 - (video) Win32 dll | (audio) MPEG/AC3/PCM

At compile-time libavifile must be available. At run-time libavifile and win32codecs must be present. Support for this module is good.

Interface to the avifile library which allows the use of win32codec on the linux-x86 platform.
Supported processing formats: audio - RAW (pass-through) PCM AC3, video - RGB YUV

divx5 - (video) DivX 5.xx | (audio) MPEG/AC3/PCM

At compile-time libmp3lame (only for MPEG audio layer III) must be available. At run-time divx4linux (new) and libdivxencore.so must be present. Support for this module is good.

Encodes MPEG4 video using the closed-source binaries from divx.com to an AVI container.
Supported processing formats: audio - RAW (pass-through) PCM AC3, video - RGB YUV

dv - (video) Digital Video | (audio) MPEG/AC3/PCM

At compile-time libdv and libmp3lame (only for MPEG audio layer III) must be available. At run-time libdv must be present. Support for this module is good.

Encodes DV into an AVI container. DV is a codec developed by Sony and is often used in digital camcorders.
Supported processing formats: audio - PCM AC3, video - RGB YUV

dvraw - (video) Digital Video | (audio) PCM

At compile-time libdv must be available. At run-time libdv must be present. Support for this module is good.

Encodes DV into a DV file. DV is a codec developed by Sony and is often used in digital camcorders. A raw DV file can be played back into the camcorder.
Supported processing formats: audio - PCM, video - RAW (pass-through) RGB YUV YUV422

ffmpeg - (video) * | (audio) MPEG/AC3/PCM

At compile-time libmp3lame (only for MPEG audio layer III) must be available. This module has no run-time dependencies. Support for this module is good.

Encodes many different formats to both AVI and raw. Supported are mpeg1video, mpeg2video, mpeg4, mjpeg, h263, h263p, wmv1, wmv2, rv10, msmpeg4, msmpeg4v2, huffyuv and dvvideo.
Supported processing formats: audio RAW (pass-through) PCM AC3, video - RGB YUV YUV422

im - (video) * | (audio) MPEG/AC3/PCM

At compile-time libImageMagick must be available. This module has no run-time dependencies. Support for this module is good.

Encodes image sequences by using the ImageMagick library. ImageMagick is able to handle a lot of different image formats such as png, jpg, miff, tiff, etc. Use -F to select the desired format.
Supported processing formats: audio - RAW (pass-through) PCM, video - RGB YUV

jpg - (video) * | (audio) MPEG/AC3/PCM

At compile-time libjpeg must be available. This module has no run-time dependencies. Support for this module is good.

Encodes jpg image sequences using libjpeg. Faster than ImageMagick. Use -F to select the compression quality.
Supported processing formats: audio - RAW (pass-through) PCM, video - RGB YUV

lame - (audio) MPEG 1/2

At compile-time libmp3lame (only for MPEG audio layer III) must be available. At run-time lame and sox must be present. Support for this module is good.

An audio-only encoder which drives the lame binary. The tool sox is used to do resampling if required. Encodes to a MP3 file.
Supported processing formats: audio - PCM, video - none

lzo - (video) LZO real-time compression | (audio) MPEG/AC3/PCM

At compile-time liblzo and libmp3lame (only for MPEG audio layer III) must be available. This module has no run-time dependencies. Support for this module is good.

Encodes video using a loss-less real-time LZO codec. This codec is a homegrown invention of transcode and is intended as an intermediate storage format. MPlayer can playback LZO-based AVI files as well.
Supported processing formats: audio - RAW (pass-through) PCM AC3, video - RAW (pass-through) RGB YUV DV

mov - (video) * | (audio) *

At compile-time libquicktime must be available. At run-time libquicktime must be present. Support for this module is fair.

Interface to the quicktime library.
Supported processing formats: audio - PCM, video - RAW (pass-through) RGB YUV YUV422 YUY2

mp2 - (video) null | (audio) MPEG 1/2

This module has no compile-time dependencies. At run-time ffmpeg and sox must be present. Support for this module is good.

Encodes audio (raw PCM) to MPEG 1 Layer 2 audio aka mp2. Additionaly it can change the speed of the audio stream by a factor you can specify. See docs/export_mp2.txt.
Supported processing formats: audio - PCM, video - none

mp2enc - (audio) MPEG 1/2

At compile-time mjpegtools must be available. At run-time mp2enc must be present. Support for this module is good.

Drives the mp2enc binary and writes an MP2 (MPEG1-Layer2) file. Useful for when encoding to SVCD to be multiplexed with mplex after encoding.
Supported processing formats: audio - PCM, video - none

mpeg2enc - (video) MPEG 1/2

At compile-time mjpegtools must be available. At run-time mpeg2enc must be present. Support for this module is good.

Drives the mpeg2enc binary. mpeg2enc is a very feature rich MPEG encoder, have a look at its manpage. Encodes generic mpeg1, VCD, SVCD, MPEG2 and DVD type video.
Supported processing formats: audio - none, video - RGB YUV

null - (video) null | (audio) null

This module has no compile-time dependencies. This module has no run-time dependencies. Support for this module is good.

Data sink. Does nothing else than discarding data.
Supported processing formats: audio - none, video - none

ogg - (video) null | (audio) ogg

This module has no compile-time dependencies. At run-time oggenc must be present. Support for this module is good.

Drives the oggenc binary. Encodes an Ogg/Vorbis file. Resamples.
Supported processing formats: audio - PCM, video - none

ppm - (video) PPM/PGM | (audio) MPEG/AC3/PCM

This module has no compile-time dependencies. This module has no run-time dependencies. Support for this module is good.

Writes an image sequence of PGM or PPM files. PPM is an old format and there are several tools around to manipulate such files.
Supported processing formats: audio - RAW (pass-through) PCM AC3, video - RGB YUV

pvm - (video) * | (audio) *

At compile-time libpvm3 must be available. At run-time pvm must be present. Support for this module is good.

Meta module. It allows transcode to be used in a PVM cluster. See docs/export_pvm.txt
Supported processing formats: audio - RAW (pass-through) PCM AC3, video - RAW (pass-through) RGB YUV DV YUV422 YUY2

raw - (video) * | (audio) MPEG/AC3/PCM

This module has no compile-time dependencies. This module has no run-time dependencies. Support for this module is good.

Can write uncompressed streams to an AVI file as well as raw mpeg2 files in pass-through mode. The image format for uncompressed streams can be selected with -F (use -F help to see available formats).
Supported processing formats: audio - RAW (pass-through) PCM AC3, video - RAW (pass-through) RGB YUV DV YUV422

toolame - (audio) MPEG 1/2

This module has no compile-time dependencies. At run-time toolame and sox must be present. Support for this module is good.

Drives the toolame binary to create MP2 audio tracks. Sox is used for resampling if requested.
Supported processing formats: audio - PCM, video - none

wav - (audio) WAVE PCM

This module has no compile-time dependencies. This module has no run-time dependencies. Support for this module is good.

Creates WAVE PCM files with interleaved audio for stereo.
Supported processing formats: audio - PCM, video - RAW (pass-through) RGB YUV

xvid4 - (video) XviD 1.0.x series (aka API 4.0) | (audio) MPEG/AC3/PCM

At compile-time libmp3lame (only for MPEG audio layer III) must be available. At run-time libxvidcore.so.4 must be present. Support for this module is good.

Encodes MPEG4 video using the library available from xvid.org. Check out the library from xvidcvs using cvs -d :pserver:anonymous@cvs.xvid.org:/xvid co -rdev-api-4 xvidcore. There is also a tool available to create configuration files for this xvid version at zebra.fh-weingarten.de/transcode/xvid4conf The output can either be an AVI file or a MPEG4 elementary stream (with -F raw).
Supported processing formats: audio - RAW (pass-through) PCM AC3, video - RGB YUV YUV422

yuv4mpeg - (video) YUV4MPEG2 | (audio) MPEG/AC3/PCM

At compile-time mjpegtools must be available. This module has no run-time dependencies. Support for this module is good.

Writes the uncompressed raw YUV data in a YUV4MPEG format as used by the lav* and mjpeg* tools.
Supported processing formats: audio - RAW (pass-through) PCM AC3, video - RGB YUV

AUTHORS

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

SEE ALSO

transcode(1), tcmodinfo(1), transcode_import(1), transcode_filter(1),