source: multimedia/videoutils/transcode.xml

trunk
Last change on this file was 181e069f, checked in by Bruce Dubbs <bdubbs@…>, 2 months ago

Tag all perl modules

  • Property mode set to 100644
File size: 14.5 KB
Line 
1<?xml version="1.0" encoding="UTF-8"?>
2<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
3 "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
4 <!ENTITY % general-entities SYSTEM "../../general.ent">
5 %general-entities;
6
7<!-- <!ENTITY transcode-download-http "https://bitbucket.org/france/transcode-tcforge/downloads/transcode-&transcode-version;.tar.bz2">-->
8 <!ENTITY transcode-download-http "&sources-anduin-http;/transcode/transcode-&transcode-version;.tar.bz2">
9 <!ENTITY transcode-download-ftp "">
10 <!ENTITY transcode-md5sum "9bb25a796a8591fb764de46ee87ce505">
11 <!ENTITY transcode-size "2.1 MB">
12 <!ENTITY transcode-buildsize "72 MB">
13 <!ENTITY transcode-time "0.5 SBU">
14]>
15
16<sect1 id="transcode" xreflabel="Transcode-&transcode-version;">
17 <?dbhtml filename="transcode.html"?>
18
19
20 <title>Transcode-&transcode-version;</title>
21
22 <indexterm zone="transcode">
23 <primary sortas="a-Transcode">Transcode</primary>
24 </indexterm>
25
26 <sect2 role="package">
27 <title>Introduction to Transcode</title>
28
29 <para>
30 <application>Transcode</application> was a fast, versatile and
31 command-line based audio/video everything to everything converter
32 primarily focused on producing AVI video files with MP3 audio,
33 but also including a program to read all the video and audio streams
34 from a DVD.
35 <!-- 403 Forbidden
36 For a rundown of the features and capabilities, along with usage
37 examples, visit the Transcode Wiki at
38 <ulink url="http://www.transcoding.org/"/>.-->
39 </para>
40
41 <para>
42 Although outdated and no longer maintained, it can still be used to
43 extract items from a DVD using only the required and recommended
44 dependencies, or to recode to AVI files.
45 </para>
46
47 <para>
48 Subjects to the comments below, this package is known to build and
49 minimally work using the current LFS platform.
50 </para>
51
52 &lfs121_checked;
53
54 <bridgehead renderas="sect3">Package Information</bridgehead>
55 <itemizedlist spacing="compact">
56 <listitem>
57 <para>
58 Download (HTTP): <ulink url="&transcode-download-http;"/>
59 </para>
60 </listitem>
61 <listitem>
62 <para>
63 Download (FTP): <ulink url="&transcode-download-ftp;"/>
64 </para>
65 </listitem>
66 <listitem>
67 <para>
68 Download MD5 sum: &transcode-md5sum;
69 </para>
70 </listitem>
71 <listitem>
72 <para>
73 Download size: &transcode-size;
74 </para>
75 </listitem>
76 <listitem>
77 <para>
78 Estimated disk space required: &transcode-buildsize;
79 </para>
80 </listitem>
81 <listitem>
82 <para>
83 Estimated build time: &transcode-time;
84 </para>
85 </listitem>
86 </itemizedlist>
87
88 <bridgehead renderas="sect3">Additional Downloads</bridgehead>
89 <itemizedlist spacing="compact">
90 <!--
91 <listitem>
92 <para>
93 Required patch to fix API changes in ffmpeg:
94 <ulink url="&patch-root;/transcode-&transcode-version;-ffmpeg4-1.patch"/>
95 </para>
96 </listitem>
97-->
98 <listitem>
99 <para>
100 Required patch to fix some issues exposed by GCC 10 and later:
101 <ulink url="&patch-root;/transcode-&transcode-version;-gcc10_fix-1.patch"/>
102 </para>
103 </listitem>
104 </itemizedlist>
105
106 <bridgehead renderas="sect3">Transcode Dependencies</bridgehead>
107
108<!-- ffmpeg does not carry libavresample anymore, so we'll work around it.
109 <bridgehead renderas="sect4">Required</bridgehead>
110 <para role="required">
111 <xref linkend="ffmpeg"/> (configured with - -enable-avresample)
112 </para>
113-->
114
115 <bridgehead renderas="sect4">Recommended</bridgehead>
116 <para role="recommended">
117 <xref linkend="alsa-lib"/>,
118 <xref linkend="lame"/>,
119 <xref linkend="libdvdread"/>,
120 <xref linkend="libmpeg2"/>, and
121 <xref linkend="xorg7-lib"/>
122 </para>
123
124 <bridgehead renderas="sect4">Optional</bridgehead>
125 <para role="optional">
126 <xref linkend="faac"/>,
127 <xref linkend="freetype2"/>,
128 <ulink url="https://legacy.imagemagick.org/script/download.php">ImageMagick-6</ulink>,
129 <xref linkend="liba52"/>,
130 <xref linkend="libdv"/>,
131 <xref linkend="libjpeg"/>,
132 <xref linkend="libogg"/>,
133 <xref linkend="libquicktime"/>,
134 <!--<xref linkend="libtheora"/>,-->
135 <xref linkend="libvorbis"/>,
136 <xref linkend="libxml2"/>,
137 <xref linkend="lzo"/>,
138 <xref linkend="sdl"/>,
139 <xref linkend="v4l-utils"/>,
140 <xref linkend="x264"/>,
141 <xref linkend="xvid"/>
142 <ulink url="https://www.theora.org">libtheora</ulink>,
143 <ulink url="https://sourceforge.net/projects/mjpeg/">MJPEG Tools</ulink>, and
144 <ulink url="https://netlib.org/pvm3/">PVM3</ulink>,
145 </para>
146
147 <bridgehead renderas="sect4">Optional (at runtime)</bridgehead>
148 <para role="optional">
149 <ulink url="https://sourceforge.net/projects/lsdvd/files/">lsdvd</ulink>
150 </para>
151
152 <para condition="html" role="usernotes">Editor Notes:
153 <ulink url="&blfs-wiki;/transcode"/>
154 </para>
155 </sect2>
156
157 <sect2 role="installation">
158 <title>Installation of Transcode</title>
159
160<!-- ffmpeg5 no longer carries libavresample.
161 <note>
162 <para>
163 The details of how the <application>FFmpeg</application> libraries
164 are used has changed since this version of
165 <application>Transcode</application> was released. The patch allows the
166 package to be compiled, but some or all of the internal calls to
167 <application>FFmpeg</application> may fail at run time (they report an error
168 and processing continues, but without any output).
169 </para>
170
171 <para>
172 For many packages, that would be a critical error. In this case,
173 the main reason to install <application>Transcode</application> is for
174 the <command>tccat</command> program, which works. Some of the
175 <command>transcode</command> options work - for the others, use
176 <command>ffmpeg</command> directly on the command line.
177 </para>
178 </note>
179-->
180
181 <note>
182 <para>
183 Support for most of the dependency packages requires using
184 options passed to the <command>configure</command> script. View the
185 <filename>INSTALL</filename> file and the output from
186 <command>./configure --help</command> for complete information about
187 enabling dependency packages.
188 </para>
189 </note>
190
191 <para>
192 Install <application>Transcode</application> by running the following
193 commands:
194 </para>
195
196<screen><userinput>sed -i 's|doc/transcode|&amp;-$(PACKAGE_VERSION)|' \
197 $(find . -name Makefile.in -exec grep -l 'docsdir =' {} \;) &amp;&amp;
198
199patch -Np1 -i ../transcode-&transcode-version;-gcc10_fix-1.patch &amp;&amp;
200
201./configure --prefix=/usr \
202 --enable-alsa \
203 --enable-libmpeg2 \
204 --disable-ffmpeg &amp;&amp;
205make</userinput></screen>
206
207 <para>
208 This package does not come with a test suite.
209 </para>
210
211 <para>
212 Now, as the <systemitem class="username">root</systemitem> user:
213 </para>
214
215<screen role="root"><userinput>make install</userinput></screen>
216
217 </sect2>
218
219 <sect2 role="commands">
220 <title>Command Explanations</title>
221
222 <para>
223 <command>sed -i ...</command>: Fixes install location for documentation.
224 </para>
225
226 <para>
227 <parameter>--disable-ffmpeg</parameter>: This switch disables support for
228 ffmpeg because libavresample was removed in ffmpeg-5.x.
229 </para>
230
231 </sect2>
232
233 <sect2 role="content">
234 <title>Contents</title>
235
236 <segmentedlist>
237 <segtitle>Installed Programs</segtitle>
238 <segtitle>Installed Libraries</segtitle>
239 <segtitle>Installed Directories</segtitle>
240
241 <seglistitem>
242 <seg>
243 avifix, aviindex, avimerge, avisplit, avisync, tccat, tcdecode,
244 tcdemux, tcextract, tcmodinfo, tcmp3cut, tcprobe, tcscan, tcxmlcheck,
245 tcxpm2rgb, tcyait, and transcode
246 </seg>
247 <seg>
248 None
249 </seg>
250 <seg>
251 /usr/lib/transcode and
252 /usr/share/doc/transcode-&transcode-version;
253 </seg>
254 </seglistitem>
255 </segmentedlist>
256
257 <variablelist>
258 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
259 <?dbfo list-presentation="list"?>
260 <?dbhtml list-presentation="table"?>
261
262 <varlistentry id="avifix">
263 <term><command>avifix</command></term>
264 <listitem>
265 <para>
266 fixes the header of an AVI file
267 </para>
268 <indexterm zone="transcode avifix">
269 <primary sortas="b-avifix">avifix</primary>
270 </indexterm>
271 </listitem>
272 </varlistentry>
273
274 <varlistentry id="aviindex">
275 <term><command>aviindex</command></term>
276 <listitem>
277 <para>
278 writes a text file describing the index of an AVI file
279 </para>
280 <indexterm zone="transcode aviindex">
281 <primary sortas="b-aviindex">aviindex</primary>
282 </indexterm>
283 </listitem>
284 </varlistentry>
285
286 <varlistentry id="avimerge">
287 <term><command>avimerge</command></term>
288 <listitem>
289 <para>
290 merges AVI files of the same format. Do not try to merge AVI
291 files of different formats, it will most likely result in errors
292 (and format means same bitrates, too!)
293 </para>
294 <indexterm zone="transcode avimerge">
295 <primary sortas="b-avimerge">avimerge</primary>
296 </indexterm>
297 </listitem>
298 </varlistentry>
299
300 <varlistentry id="avisplit">
301 <term><command>avisplit</command></term>
302 <listitem>
303 <para>
304 splits AVI files into multiple files
305 </para>
306 <indexterm zone="transcode avisplit">
307 <primary sortas="b-avisplit">avisplit</primary>
308 </indexterm>
309 </listitem>
310 </varlistentry>
311
312 <varlistentry id="avisync">
313 <term><command>avisync</command></term>
314 <listitem>
315 <para>
316 can shift audio in AVI files for better synchronizing
317 of the audio and video data signal
318 </para>
319 <indexterm zone="transcode avisync">
320 <primary sortas="b-avisync">avisync</primary>
321 </indexterm>
322 </listitem>
323 </varlistentry>
324
325 <varlistentry id="tccat">
326 <term><command>tccat</command></term>
327 <listitem>
328 <para>
329 concatenates input files using the input plugins of
330 <application>Transcode</application>. This is useful
331 for extracting VOB (Video OBject) files, either for
332 a whole DVD or for selected Titles or Chapters, which
333 can then be played or recoded
334 </para>
335 <indexterm zone="transcode tccat">
336 <primary sortas="b-tccat">tccat</primary>
337 </indexterm>
338 </listitem>
339 </varlistentry>
340
341 <varlistentry id="tcdecode">
342 <term><command>tcdecode</command></term>
343 <listitem>
344 <para>
345 is used to decode input files to raw video and PCM
346 audio streams
347 </para>
348 <indexterm zone="transcode tcdecode">
349 <primary sortas="b-tcdecode">tcdecode</primary>
350 </indexterm>
351 </listitem>
352 </varlistentry>
353
354 <varlistentry id="tcdemux">
355 <term><command>tcdemux</command></term>
356 <listitem>
357 <para>
358 demultiplexes (separates) audio/video input that contains
359 multiple streams, e.g., VOB files
360 </para>
361 <indexterm zone="transcode tcdemux">
362 <primary sortas="b-tcdemux">tcdemux</primary>
363 </indexterm>
364 </listitem>
365 </varlistentry>
366
367 <varlistentry id="tcextract">
368 <term><command>tcextract</command></term>
369 <listitem>
370 <para>
371 grabs single streams from a file containing multiple streams
372 </para>
373 <indexterm zone="transcode tcextract">
374 <primary sortas="b-tcextract">tcextract</primary>
375 </indexterm>
376 </listitem>
377 </varlistentry>
378
379 <varlistentry id="tcmodinfo">
380 <term><command>tcmodinfo</command></term>
381 <listitem>
382 <para>
383 loads a supplied <application>Transcode</application> filter
384 module and prints its parameters
385 </para>
386 <indexterm zone="transcode tcmodinfo">
387 <primary sortas="b-tcmodinfo">tcmodinfo</primary>
388 </indexterm>
389 </listitem>
390 </varlistentry>
391
392 <varlistentry id="tcmp3cut">
393 <term><command>tcmp3cut</command></term>
394 <listitem>
395 <para>
396 is a tool which can cut MP3 streams at milliseconds
397 positions
398 </para>
399 <indexterm zone="transcode tcmp3cut">
400 <primary sortas="b-tcmp3cut">tcmp3cut</primary>
401 </indexterm>
402 </listitem>
403 </varlistentry>
404
405 <varlistentry id="tcprobe">
406 <term><command>tcprobe</command></term>
407 <listitem>
408 <para>
409 prints information about the input file format
410 </para>
411 <indexterm zone="transcode tcprobe">
412 <primary sortas="b-tcprobe">tcprobe</primary>
413 </indexterm>
414 </listitem>
415 </varlistentry>
416
417 <varlistentry id="tcscan">
418 <term><command>tcscan</command></term>
419 <listitem>
420 <para>
421 performs several measurements on the given input data
422 </para>
423 <indexterm zone="transcode tcscan">
424 <primary sortas="b-tcscan">tcscan</primary>
425 </indexterm>
426 </listitem>
427 </varlistentry>
428
429 <varlistentry id="tcxmlcheck">
430 <term><command>tcxmlcheck</command></term>
431 <listitem>
432 <para>
433 checks information in a SMIL input file
434 </para>
435 <indexterm zone="transcode tcxmlcheck">
436 <primary sortas="b-tcxmlcheck">tcxmlcheck</primary>
437 </indexterm>
438 </listitem>
439 </varlistentry>
440
441 <varlistentry id="transcode-prog">
442 <term><command>transcode</command></term>
443 <listitem>
444 <para>
445 is the encoder's user interface that handles the plugins and other
446 programs, being the glue between the modules. There are several
447 well documented usage examples on both the homepage and the
448 documentation included in the package
449 </para>
450 <indexterm zone="transcode transcode-prog">
451 <primary sortas="b-transcode">transcode</primary>
452 </indexterm>
453 </listitem>
454 </varlistentry>
455
456 </variablelist>
457
458 </sect2>
459
460</sect1>
Note: See TracBrowser for help on using the repository browser.