source: multimedia/audioutils/vorbistools.xml@ 64218c2

10.0 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 64218c2 was 64218c2, checked in by Bruce Dubbs <bdubbs@…>, 2 years ago

Jist tags

git-svn-id: svn://svn.linuxfromscratch.org/BLFS/trunk/BOOK@23605 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 "567e0fb8d321b2cd7124f8208b8b90e6">
10 <!ENTITY vorbistools-size "1.3 MB">
11 <!ENTITY vorbistools-buildsize "11 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 <bridgehead renderas="sect3">Additional Downloads</bridgehead>
75 <itemizedlist spacing="compact">
76 <listitem>
77 <para>
78 Required patch:
79 <ulink url="&patch-root;/vorbis-tools-&vorbistools-version;-security_fix-1.patch"/>
80 </para>
81 </listitem>
82 </itemizedlist>
83
84 <bridgehead renderas="sect3">Vorbis Tools Dependencies</bridgehead>
85
86 <bridgehead renderas="sect4">Required</bridgehead>
87 <para role="required">
88 <xref linkend="libvorbis"/>
89 </para>
90
91 <bridgehead renderas="sect4">Optional (required to build the
92 <command>ogg123</command> program)</bridgehead>
93 <para role="optional">
94 <xref linkend="libao"/>
95 </para>
96
97 <bridgehead renderas="sect4">Optional</bridgehead>
98 <para role="optional">
99 <xref linkend="curl"/>,
100 <xref linkend="flac"/>,
101 <ulink url="https://code.google.com/archive/p/libkate/">libkate</ulink>, and
102 <xref linkend="speex"/>
103 </para>
104
105 <para condition="html" role="usernotes">User Notes:
106 <ulink url="&blfs-wiki;/vorbistools"/>
107 </para>
108 </sect2>
109
110 <sect2 role="installation">
111 <title>Installation of Vorbis Tools</title>
112
113 <para>
114 First, apply a patch to fix some security issues:
115 </para>
116
117<screen><userinput remap="pre">patch -Np1 -i ../vorbis-tools-&vorbistools-version;-security_fix-1.patch</userinput></screen>
118
119 <para>
120 Install <application>Vorbis Tools</application> by running the
121 following commands:
122 </para>
123
124<screen><userinput>./configure --prefix=/usr \
125 --enable-vcut \
126 --without-curl &amp;&amp;
127make</userinput></screen>
128
129 <para>
130 This package does not come with a test suite.
131 </para>
132
133 <para>
134 Now, as the <systemitem class="username">root</systemitem> user:
135 </para>
136
137<screen role="root"><userinput>make install</userinput></screen>
138
139 </sect2>
140
141 <sect2 role="commands">
142 <title>Command Explanations</title>
143
144 <para>
145 <parameter>--enable-vcut</parameter>: This parameter is used so that
146 the <command>vcut</command> program is built as it is not by default.
147 </para>
148
149 <para>
150 <parameter>--without-curl</parameter>: This parameter disables HTTP
151 streaming in <command>ogg123</command>. Remove this parameter if you have
152 <application>cURL</application> installed.
153 </para>
154
155 </sect2>
156
157 <sect2 role="configuration">
158 <title>Configuring Vorbis Tools</title>
159
160 <sect3 id="vorbistools-config">
161 <title>Config Files</title>
162
163 <para>
164 <filename>/etc/libao.conf</filename>,
165 <filename>~/.libao</filename> and
166 <filename>~/.ogg123rc</filename>
167 </para>
168
169 <indexterm zone="vorbistools vorbistools-config">
170 <primary sortas="e-AA.libao">~/.libao</primary>
171 </indexterm>
172
173 <indexterm zone="vorbistools vorbistools-config">
174 <primary sortas="e-AA.ogg123rc">~/.ogg123rc</primary>
175 </indexterm>
176
177 <indexterm zone="vorbistools vorbistools-config">
178 <primary sortas="e-etc-libao.conf">/etc/libao.conf</primary>
179 </indexterm>
180
181 </sect3>
182
183 <sect3>
184 <title>Configuration Information</title>
185
186 <para>
187 Issue <command>man libao.conf</command> for information
188 about setting the default output device. Also see
189 <filename>/usr/share/doc/vorbis-tools-&vorbistools-version;/ogg123rc-example
190 </filename>.
191 </para>
192
193 </sect3>
194
195 </sect2>
196
197 <sect2 role="content">
198 <title>Contents</title>
199
200 <segmentedlist>
201 <segtitle>Installed Programs</segtitle>
202 <segtitle>Installed Libraries</segtitle>
203 <segtitle>Installed Directory</segtitle>
204
205 <seglistitem>
206 <seg>
207 ogg123, oggdec, oggenc, ogginfo, vcut and vorbiscomment
208 </seg>
209 <seg>
210 None
211 </seg>
212 <seg>
213 /usr/share/doc/vorbis-tools-&vorbistools-version;
214 </seg>
215 </seglistitem>
216 </segmentedlist>
217
218 <variablelist>
219 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
220 <?dbfo list-presentation="list"?>
221 <?dbhtml list-presentation="table"?>
222
223 <varlistentry id="ogg123">
224 <term><command>ogg123</command></term>
225 <listitem>
226 <para>
227 is a command-line audio player for Ogg Vorbis streams.
228 </para>
229 <indexterm zone="vorbistools ogg123">
230 <primary sortas="b-ogg123">ogg123</primary>
231 </indexterm>
232 </listitem>
233 </varlistentry>
234
235 <varlistentry id="oggdec">
236 <term><command>oggdec</command></term>
237 <listitem>
238 <para>
239 is a simple decoder which converts Ogg Vorbis files into
240 PCM audio files (WAV or raw).
241 </para>
242 <indexterm zone="vorbistools oggdec">
243 <primary sortas="b-oggdec">oggdec</primary>
244 </indexterm>
245 </listitem>
246 </varlistentry>
247
248 <varlistentry id="oggenc">
249 <term><command>oggenc</command></term>
250 <listitem>
251 <para>
252 is an encoder that turns raw, WAV or
253 AIFF files into an Ogg Vorbis stream.
254 </para>
255 <indexterm zone="vorbistools oggenc">
256 <primary sortas="b-oggenc">oggenc</primary>
257 </indexterm>
258 </listitem>
259 </varlistentry>
260
261 <varlistentry id="ogginfo">
262 <term><command>ogginfo</command></term>
263 <listitem>
264 <para>
265 prints information stored in an audio file.
266 </para>
267 <indexterm zone="vorbistools ogginfo">
268 <primary sortas="b-ogginfo">ogginfo</primary>
269 </indexterm>
270 </listitem>
271 </varlistentry>
272
273 <varlistentry id="vcut">
274 <term><command>vcut</command></term>
275 <listitem>
276 <para>
277 splits a file into two files at a designated cut point.
278 </para>
279 <indexterm zone="vorbistools vcut">
280 <primary sortas="b-vcut">vcut</primary>
281 </indexterm>
282 </listitem>
283 </varlistentry>
284
285 <varlistentry id="vorbiscomment">
286 <term><command>vorbiscomment</command></term>
287 <listitem>
288 <para>
289 is an editor that changes information in the audio file
290 metadata tags.
291 </para>
292 <indexterm zone="vorbistools vorbiscomment">
293 <primary sortas="b-vorbiscomment">vorbiscomment</primary>
294 </indexterm>
295 </listitem>
296 </varlistentry>
297
298 </variablelist>
299
300 </sect2>
301
302</sect1>
Note: See TracBrowser for help on using the repository browser.