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
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
|
.\" Man page generated from reStructuredText.
.
.
.nr rst2man-indent-level 0
.
.de1 rstReportMargin
\\$1 \\n[an-margin]
level \\n[rst2man-indent-level]
level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
-
\\n[rst2man-indent0]
\\n[rst2man-indent1]
\\n[rst2man-indent2]
..
.de1 INDENT
.\" .rstReportMargin pre:
. RS \\$1
. nr rst2man-indent\\n[rst2man-indent-level] \\n[an-margin]
. nr rst2man-indent-level +1
.\" .rstReportMargin post:
..
.de UNINDENT
. RE
.\" indent \\n[an-margin]
.\" old: \\n[rst2man-indent\\n[rst2man-indent-level]]
.nr rst2man-indent-level -1
.\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
.in \\n[rst2man-indent\\n[rst2man-indent-level]]u
..
.TH "MAC" 1 "2021-11-25" "3.99_u4_b5_s7" "SlackBuilds.org"
.SH NAME
mac \- decode/encode Monkey's Audio codec files
.\" RST source for mac(1) man page. Convert with:
.
.\" rst2man.py mac.rst > mac.1
.
.\" rst2man.py comes from the SBo development/docutils package.
.
.SH SYNOPSIS
.sp
\fBmac\fP [\fIinput\-file\fP] [\fIoutput\-file\fP] [ [\fB\-c\fP | \fB\-n\fP ] \fIlevel\fP ]
.sp
\fBmac\fP [\fIinput\-file\fP] [ \fB\-d\fP | \fB\-v\fP | \fB\-q\fP ]
.SH DESCRIPTION
.sp
Monkey\(aqs Audio (aka APE) is a lossless audio compression format,
similar to FLAC. mac is a console frontend to Monkey\(aqs Audio, able to
encode and decode APE audio files.
.sp
If you encode a WAV file to APE, then decode it back to WAV, the
audio in the decoded WAV file will be byte\-for\-byte identical to the
original (although any extra data such as tags/comments in the RIFF
header will not be preserved).
.SH OPTIONS
.sp
Note: Only one of the options below can be given, and it must occur
last on the command line (after the filename(s)). Spaces are not
allowed between the \fB\-c\fP or \fB\-n\fP option and its \fIlevel\fP argument.
.INDENT 0.0
.TP
.B \fB\-c[level]\fP
Compress (encode). \fIinput\-file\fP must be a WAV file with 16\-bit samples.
\fIoutput\-file\fP will be an APE audio file. Higher \fIlevel\fPs result
in better compression, at the expense of longer encoding time. The
supported levels are:
.INDENT 7.0
.INDENT 3.5
.INDENT 0.0
.TP
.B 1000
\fI(fast)\fP, usually around 45%\-50% compression ratio.
.TP
.B 2000
\fI(normal)\fP, usually around 40%\-45% compression ratio.
.TP
.B 3000
\fI(high)\fP, only slightly better than 2000 (usually by 1% or so).
.TP
.B 4000
\fI(very high)\fP, probably the point of diminishing returns.
.TP
.B 5000
\fI(insane)\fP, takes around 3x as long as 4000, may not compress any better.
.UNINDENT
.UNINDENT
.UNINDENT
.TP
.B \fB\-n[level]\fP
Convert (recompress). As \fB\-c\fP, but \fBinput\-file\fP must be an APE audio
file.
.TP
.B \fB\-d\fP
Decompress (decode). \fIinput\-file\fP must be an APE audio file.
\fIoutput\-file\fP will be a WAV file.
.TP
.B \fB\-v\fP
Verify. \fIinput\-file\fP must be an APE audio file. It will be decoded, and
any errors will be displayed, but the decoded audio won\(aqt be saved.
.TP
.B \fB\-q\fP
Quick verify. Just checks that \fIinput\-file\fP has a valid APE header.
.TP
.B \fB\-\-help\fP
Show built\-in usage message (same as running \fBmac\fP with no arguments).
.UNINDENT
.SH EXAMPLES
.INDENT 0.0
.TP
.B Compress
mac "Metallica \- One.wav" "Metallica \- One.ape" \-c2000
.TP
.B Decompress
mac "Metallica \- One.ape" "Metallica \- One.wav" \-d
.TP
.B Verify
mac "Metallica \- One.ape" \-v
.TP
.B Quick verify
mac "Metallica \- One.ape" \-q
.UNINDENT
.sp
Note that filenames with spaces and punctuation should be put inside
quote, as usual.
.SH NOTES
.sp
\fBmac\fP can only handle WAV files with 8\- or 16\-bit samples, not
e.g. 24\-bit or floating point. If needed, you can convert to 16\-bit
with a command like:
.INDENT 0.0
.INDENT 3.5
$ sox \-G input.wav \-b16 output.wav
.UNINDENT
.UNINDENT
.sp
WAV files must have 1 or 2 channels (mono or stereo;
quad/surround/5.1/etc are not supported). Any sampling rate is
supported.
.sp
\fBffmpeg\fP(1) can decode and convert APE files, though it cannot encode
to APE.
.sp
\fBmplayer\fP(1) and \fBaudacious\fP(1) can play APE files.
.sp
\fBfile\fP(1) knows about APE files. Example:
.INDENT 0.0
.INDENT 3.5
$ file test.ape
.sp
test.ape: Monkey\(aqs Audio compressed format version 3990 with normal compression, stereo, sample rate 48000
.UNINDENT
.UNINDENT
.SH COPYRIGHT
.sp
See the file /usr/doc/mac\-3.99_u4_b5_s7/License.htm for license information.
.SH AUTHORS
.sp
The original Monkey\(aqs Audio Codec was written by Matthew
T. Ashland. It was ported to Linux by Frank Klemm and SuperMMX, then
enhanced and bugfixed by Jason Jordan.
.sp
This man page written for the SlackBuilds.org project
by B. Watson, and is licensed under the WTFPL.
.SH SEE ALSO
.sp
\fBffmpeg\fP(1), \fBmplayer\fP(1), \fBaudacious\fP(1), \fBflac\fP(1), \fBshorten\fP(1), \fBsox\fP(1)
.sp
The Monkey\(aqs Audio Codec homepage: \fI\%http://www.monkeysaudio.com/\fP
.\" Generated by docutils manpage writer.
.
|
