170 lines
4.8 KiB
Groff
170 lines
4.8 KiB
Groff
.\" 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.
|
|
.
|