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-2009 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
http://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),