slackbuilds/audio/mac/mac.1

.\" 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.
.