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 [AT] cvs.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 [AT] theorie.de> with
contributions from many others. See AUTHORS for details.
SEE ALSO
transcode(1), tcmodinfo(1), transcode_import(1), transcode_filter(1),