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
|
.. RST source for mac(1) man page. Convert with:
.. rst2man.py mac.rst > mac.1
.. rst2man.py comes from the SBo development/docutils package.
.. |version| replace:: 3.99_u4_b5_s7
.. |date| date::
===
mac
===
----------------------------------------
decode/encode Monkey's Audio codec files
----------------------------------------
:Manual section: 1
:Manual group: SlackBuilds.org
:Date: |date|
:Version: |version|
SYNOPSIS
========
**mac** [*input-file*] [*output-file*] [ [**-c** | **-n** ] *level* ]
**mac** [*input-file*] [ **-d** | **-v** | **-q** ]
DESCRIPTION
===========
Monkey's Audio (aka APE) is a lossless audio compression format,
similar to FLAC. mac is a console frontend to Monkey's Audio, able to
encode and decode APE audio files.
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).
OPTIONS
=======
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 **-c** or **-n** option and its *level* argument.
**-c[level]**
Compress (encode). *input-file* must be a WAV file with 16-bit samples.
*output-file* will be an APE audio file. Higher *level*\s result
in better compression, at the expense of longer encoding time. The
supported levels are:
1000
*(fast)*, usually around 45%-50% compression ratio.
2000
*(normal)*, usually around 40%-45% compression ratio.
3000
*(high)*, only slightly better than 2000 (usually by 1% or so).
4000
*(very high)*, probably the point of diminishing returns.
5000
*(insane)*, takes around 3x as long as 4000, may not compress any better.
**-n[level]**
Convert (recompress). As **-c**, but **input-file** must be an APE audio
file.
**-d**
Decompress (decode). *input-file* must be an APE audio file.
*output-file* will be a WAV file.
**-v**
Verify. *input-file* must be an APE audio file. It will be decoded, and
any errors will be displayed, but the decoded audio won't be saved.
**-q**
Quick verify. Just checks that *input-file* has a valid APE header.
**--help**
Show built-in usage message (same as running **mac** with no arguments).
EXAMPLES
========
Compress
mac "Metallica - One.wav" "Metallica - One.ape" -c2000
Decompress
mac "Metallica - One.ape" "Metallica - One.wav" -d
Verify
mac "Metallica - One.ape" -v
Quick verify
mac "Metallica - One.ape" -q
Note that filenames with spaces and punctuation should be put inside
quote, as usual.
NOTES
=====
**mac** 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:
$ sox -G input.wav -b16 output.wav
WAV files must have 1 or 2 channels (mono or stereo;
quad/surround/5.1/etc are not supported). Any sampling rate is
supported.
**ffmpeg**\(1) can decode and convert APE files, though it cannot encode
to APE.
**mplayer**\(1) and **audacious**\(1) can play APE files.
**file**\(1) knows about APE files. Example:
$ file test.ape
test.ape: Monkey's Audio compressed format version 3990 with normal compression, stereo, sample rate 48000
COPYRIGHT
=========
See the file /usr/doc/mac-|version|/License.htm for license information.
AUTHORS
=======
The original Monkey's 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.
This man page written for the SlackBuilds.org project
by B. Watson, and is licensed under the WTFPL.
SEE ALSO
========
**ffmpeg**\(1), **mplayer**\(1), **audacious**\(1), **flac**\(1), **shorten**\(1), **sox**\(1)
The Monkey's Audio Codec homepage: http://www.monkeysaudio.com/
|
