source: multimedia/audioutils/vorbistools.xml@ 33befb9

10.1 11.0 11.1 11.2 lazarus plabs/python-mods qt5new trunk upgradedb xry111/intltool xry111/soup3 xry111/test-20220226
Last change on this file since 33befb9 was 33befb9, checked in by Douglas R. Reno <renodr@…>, 23 months ago

Update to vorbis-tools-1.4.2
Update to seamonkey-2.53.6

git-svn-id: svn://svn.linuxfromscratch.org/BLFS/trunk/BOOK@24141 af4574ff-66df-0310-9fd7-8a98e5e911e0

  • Property mode set to 100644
File size: 8.5 KB
Line 
1<?xml version="1.0" encoding="ISO-8859-1"?>
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 vorbistools-download-http "https://downloads.xiph.org/releases/vorbis/vorbis-tools-&vorbistools-version;.tar.gz">
8 <!ENTITY vorbistools-download-ftp " ">
9 <!ENTITY vorbistools-md5sum "998fca293bd4e4bdc2b96fb70f952f4e">
10 <!ENTITY vorbistools-size "1.3 MB">
11 <!ENTITY vorbistools-buildsize "12 MB">
12 <!ENTITY vorbistools-time "0.1 SBU">
13]>
14
15<sect1 id="vorbistools" xreflabel="vorbis-tools-&vorbistools-version;">
16 <?dbhtml filename="vorbistools.html"?>
17
18 <sect1info>
19 <othername>$LastChangedBy$</othername>
20 <date>$Date$</date>
21 </sect1info>
22
23 <title>vorbis-tools-&vorbistools-version;</title>
24
25 <indexterm zone="vorbistools">
26 <primary sortas="a-Vorbis-Tools">Vorbis Tools</primary>
27 </indexterm>
28
29 <sect2 role="package">
30 <title>Introduction to Vorbis Tools</title>
31
32 <para>
33 The <application>Vorbis Tools</application> package contains
34 command-line tools useful for encoding, playing or editing
35 files using the Ogg CODEC.
36 </para>
37
38 &lfs10_checked;
39
40 <bridgehead renderas="sect3">Package Information</bridgehead>
41 <itemizedlist spacing="compact">
42 <listitem>
43 <para>
44 Download (HTTP): <ulink url="&vorbistools-download-http;"/>
45 </para>
46 </listitem>
47 <listitem>
48 <para>
49 Download (FTP): <ulink url="&vorbistools-download-ftp;"/>
50 </para>
51 </listitem>
52 <listitem>
53 <para>
54 Download MD5 sum: &vorbistools-md5sum;
55 </para>
56 </listitem>
57 <listitem>
58 <para>
59 Download size: &vorbistools-size;
60 </para>
61 </listitem>
62 <listitem>
63 <para>
64 Estimated disk space required: &vorbistools-buildsize;
65 </para>
66 </listitem>
67 <listitem>
68 <para>
69 Estimated build time: &vorbistools-time;
70 </para>
71 </listitem>
72 </itemizedlist>
73
74<!-- Applied in 1.4.2
75 <bridgehead renderas="sect3">Additional Downloads</bridgehead>
76 <itemizedlist spacing="compact">
77 <listitem>
78 <para>
79 Required patch:
80 <ulink url="&patch-root;/vorbis-tools-&vorbistools-version;-security_fix-1.patch"/>
81 </para>
82 </listitem>
83 </itemizedlist>
84-->
85 <bridgehead renderas="sect3">Vorbis Tools Dependencies</bridgehead>
86
87 <bridgehead renderas="sect4">Required</bridgehead>
88 <para role="required">
89 <xref linkend="libvorbis"/>
90 </para>
91
92 <bridgehead renderas="sect4">Optional (required to build the
93 <command>ogg123</command> program)</bridgehead>
94 <para role="optional">
95 <xref linkend="libao"/>
96 </para>
97
98 <bridgehead renderas="sect4">Optional</bridgehead>
99 <para role="optional">
100 <xref linkend="curl"/>,
101 <xref linkend="flac"/>,
102 <xref linkend="speex"/>, and
103 <ulink url="https://code.google.com/archive/p/libkate/">libkate</ulink>
104 </para>
105
106 <para condition="html" role="usernotes">User Notes:
107 <ulink url="&blfs-wiki;/vorbistools"/>
108 </para>
109 </sect2>
110
111 <sect2 role="installation">
112 <title>Installation of Vorbis Tools</title>
113
114<!-- Applied in 1.4.2
115 <para>
116 First, apply a patch to fix some security issues:
117 </para>
118
119<screen><userinput remap="pre">patch -Np1 -i ../vorbis-tools-&vorbistools-version;-security_fix-1.patch</userinput></screen>
120-->
121
122 <para>
123 Install <application>Vorbis Tools</application> by running the
124 following commands:
125 </para>
126
127<screen><userinput>./configure --prefix=/usr \
128 --enable-vcut \
129 --without-curl &amp;&amp;
130make</userinput></screen>
131
132 <para>
133 This package does not come with a test suite.
134 </para>
135
136 <para>
137 Now, as the <systemitem class="username">root</systemitem> user:
138 </para>
139
140<screen role="root"><userinput>make install</userinput></screen>
141
142 </sect2>
143
144 <sect2 role="commands">
145 <title>Command Explanations</title>
146
147 <para>
148 <parameter>--enable-vcut</parameter>: This parameter is used so that
149 the <command>vcut</command> program is built as it is not by default.
150 </para>
151
152 <para>
153 <parameter>--without-curl</parameter>: This parameter disables HTTP
154 streaming in <command>ogg123</command>. Remove this parameter if you have
155 <application>cURL</application> installed.
156 </para>
157
158 </sect2>
159
160 <sect2 role="configuration">
161 <title>Configuring Vorbis Tools</title>
162
163 <sect3 id="vorbistools-config">
164 <title>Config Files</title>
165
166 <para>
167 <filename>/etc/libao.conf</filename>,
168 <filename>~/.libao</filename> and
169 <filename>~/.ogg123rc</filename>
170 </para>
171
172 <indexterm zone="vorbistools vorbistools-config">
173 <primary sortas="e-AA.libao">~/.libao</primary>
174 </indexterm>
175
176 <indexterm zone="vorbistools vorbistools-config">
177 <primary sortas="e-AA.ogg123rc">~/.ogg123rc</primary>
178 </indexterm>
179
180 <indexterm zone="vorbistools vorbistools-config">
181 <primary sortas="e-etc-libao.conf">/etc/libao.conf</primary>
182 </indexterm>
183
184 </sect3>
185
186 <sect3>
187 <title>Configuration Information</title>
188
189 <para>
190 Issue <command>man libao.conf</command> for information
191 about setting the default output device. Also see
192 <filename>/usr/share/doc/vorbis-tools-&vorbistools-version;/ogg123rc-example
193 </filename>.
194 </para>
195
196 </sect3>
197
198 </sect2>
199
200 <sect2 role="content">
201 <title>Contents</title>
202
203 <segmentedlist>
204 <segtitle>Installed Programs</segtitle>
205 <segtitle>Installed Libraries</segtitle>
206 <segtitle>Installed Directory</segtitle>
207
208 <seglistitem>
209 <seg>
210 ogg123, oggdec, oggenc, ogginfo, vcut and vorbiscomment
211 </seg>
212 <seg>
213 None
214 </seg>
215 <seg>
216 /usr/share/doc/vorbis-tools-&vorbistools-version;
217 </seg>
218 </seglistitem>
219 </segmentedlist>
220
221 <variablelist>
222 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
223 <?dbfo list-presentation="list"?>
224 <?dbhtml list-presentation="table"?>
225
226 <varlistentry id="ogg123">
227 <term><command>ogg123</command></term>
228 <listitem>
229 <para>
230 is a command-line audio player for Ogg Vorbis streams.
231 </para>
232 <indexterm zone="vorbistools ogg123">
233 <primary sortas="b-ogg123">ogg123</primary>
234 </indexterm>
235 </listitem>
236 </varlistentry>
237
238 <varlistentry id="oggdec">
239 <term><command>oggdec</command></term>
240 <listitem>
241 <para>
242 is a simple decoder which converts Ogg Vorbis files into
243 PCM audio files (WAV or raw).
244 </para>
245 <indexterm zone="vorbistools oggdec">
246 <primary sortas="b-oggdec">oggdec</primary>
247 </indexterm>
248 </listitem>
249 </varlistentry>
250
251 <varlistentry id="oggenc">
252 <term><command>oggenc</command></term>
253 <listitem>
254 <para>
255 is an encoder that turns raw, WAV or
256 AIFF files into an Ogg Vorbis stream.
257 </para>
258 <indexterm zone="vorbistools oggenc">
259 <primary sortas="b-oggenc">oggenc</primary>
260 </indexterm>
261 </listitem>
262 </varlistentry>
263
264 <varlistentry id="ogginfo">
265 <term><command>ogginfo</command></term>
266 <listitem>
267 <para>
268 prints information stored in an audio file.
269 </para>
270 <indexterm zone="vorbistools ogginfo">
271 <primary sortas="b-ogginfo">ogginfo</primary>
272 </indexterm>
273 </listitem>
274 </varlistentry>
275
276 <varlistentry id="vcut">
277 <term><command>vcut</command></term>
278 <listitem>
279 <para>
280 splits a file into two files at a designated cut point.
281 </para>
282 <indexterm zone="vorbistools vcut">
283 <primary sortas="b-vcut">vcut</primary>
284 </indexterm>
285 </listitem>
286 </varlistentry>
287
288 <varlistentry id="vorbiscomment">
289 <term><command>vorbiscomment</command></term>
290 <listitem>
291 <para>
292 is an editor that changes information in the audio file
293 metadata tags.
294 </para>
295 <indexterm zone="vorbistools vorbiscomment">
296 <primary sortas="b-vorbiscomment">vorbiscomment</primary>
297 </indexterm>
298 </listitem>
299 </varlistentry>
300
301 </variablelist>
302
303 </sect2>
304
305</sect1>
Note: See TracBrowser for help on using the repository browser.