forked from xiph/vorbis-tools
-
Notifications
You must be signed in to change notification settings - Fork 0
/
Copy pathREADME
102 lines (68 loc) · 2.79 KB
/
README
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
WHAT'S HERE:
This source distribution includes the vorbis-tools and nothing else.
The audio codec libraries for use with Ogg bitstreams are contained in
other modules: vorbis, speex and flac.
DIRECTORIES:
debian/ debian packaging stuff
include/ header files shared between the tools
intl/ GNU gettext library from gettext-0.10.40 (for i18n support)
ogg123/ an ogg vorbis command line audio player
oggenc/ the ogg vorbis encoder
oggdec/ a simple, portable command line decoder (to wav and raw)
ogginfo/ provides information (tags, bitrate, length, etc.) about
an ogg vorbis file
po/ translations for non-English languages
share/ code shared between the tools
vcut/ cuts an ogg vorbis file into two parts at a particular point
vorbiscomment/ edits the comments in an ogg vorbis file
win32/ Win32 build stuff
DEPENDENCIES:
All of the tools require libogg and libvorbis to be installed (along
with the header files). Additionally, ogg123 requires libao, libcurl,
and a POSIX-compatible thread library. Ogg123 can optionally compiled
to use libFLAC, and libspeex. Oggenc can be optionally compiled with
libFLAC, and libkate. The libraries libogg, libvorbis, and libao are
all available at
https://xiph.org/vorbis/
The libcurl library is packaged with most Linux distributions. The
source code can also be downloaded from:
http://curl.haxx.se/libcurl/
FLAC is available at:
https://xiph.org/flac/
Speex is available at:
https://www.speex.org/
libkate is available at:
http://libkate.googlecode.com/
CONTACT:
The Ogg Vorbis homepage is located at 'https://xiph.org/vorbis/'. Up to
date technical documents, contact information, source code and
pre-built utilities may be found there.
Developer information is available from http://www.xiph.org/. Check
there for bug reporting information, mailing lists and other resources.
BUILDING FROM SUBVERSION (see the file HACKING for details):
./autogen.sh
make
and as root if desired :
make install
This will install the tools into /usr/local/bin and manpages into
/usr/local/man.
BUILDING FROM TARBALL DISTRIBUTIONS:
./configure
make
and as root if desired :
make install
BUILDING RPMS:
RPMs may be built by:
after autogen.sh or configure
make dist
rpm -ta vorbis-tools-<version>.tar.gz
KNOWN BUGS:
#1321
First noticed in non-English versions of the application, ogg123 has a major
bug when it comes to status messages in the shell: any output bigger than
the console's width will break and start spamming that message infinitely
until the console is resized.
Different attempts to fix this bug have ended up causing bigger problems,
leading to the conclusion that it simply can't be fixed without a large
re-write of the application, which will not happen any time soon. If you
come across this issue, please augment your terminal window size.