madplay.1

mp3 plyer linux version

.B P
Pause; press any key to resume.
.TP 3
.B S
Stop; press any key to replay the current file from the beginning.
.TP 3
.B F
Forward; advance to the next file.
.TP 3
.B B
Back; replay the current file, unless it has been playing for less than 4
seconds, in which case replay the previous file.
.TP 3
.B T
Time display; change the time display mode. This only works with
.B \-v
.RB ( \-\-verbose ).
The display mode alternates among overall playing time, current time
remaining, and current playing time.
.TP 3
.B +
Increase gain; increase the audio output gain by 0.5\ dB.
.TP 3
.B \-
Decrease gain; decrease the audio output gain by 0.5\ dB.
.TP 3
.B Q
Quit; stop decoding and exit.
.RE
.TP
.B \-\-no\-tty\-control
Disable keyboard controls during playback. This is the default when standard
input is not a terminal, output is redirected with
.B \-o
.RB ( \-\-output ),
or either of
.B \-q
.RB ( \-\-quiet )
or
.B \-Q
.RB ( \-\-very\-quiet )
is given.
.SS Miscellaneous
.TP
.BR \-T " or " \-\-show\-tags\-only
Show ID3 and/or encoder tags from the input
.IR file s
but do not otherwise decode or play any audio. By default only ID3 tags are
shown (if any). With
.B \-v
.RB ( \-\-verbose ),
all tags are shown. Encoder tags recognized by
.B madplay
include the Xing VBR header tag and the header tag format written by
.BR lame (1).
.TP
.BR \-V " or " \-\-version
Display the effective version and build options for
.B madplay
and exit.
.TP
.B \-\-license
Display copyright, license, and warranty information and exit.
.TP
.BR \-h " or " \-\-help
Display usage information and exit.
.SH Output Formats
Other than playing on the native audio device, the following output formats
are supported:
.TP
.B cdda
CD audio, 16-bit big-endian 44100\ Hz stereo PCM, padded to 2352-byte block
boundary
.RB ( *.cdr ,
.BR *.cda )
.TP
.B aiff
Audio IFF, [16-bit] PCM
.RB ( *.aif ,
.BR *.aiff )
.TP
.B wave
Microsoft RIFF/WAVE, [16-bit] PCM
.RB ( *.wav )
.TP
.B snd
Sun/NeXT audio, 8-bit ISDN \(*m-law
.RB ( *.au ,
.BR *.snd )
.TP
.B raw
binary [16-bit] host-endian linear PCM, stereo interleaved
.TP
.B hex
ASCII hexadecimal [24-bit] linear PCM, stereo interleaved, one sample per
output line
.TP
.B esd
Enlightened Sound Daemon (EsounD) [16-bit] (give speaker host as
.IR path )
.TP
.B null
no output (usually for testing or timing the decoder)
.PP
Default bit depths shown in square brackets can be changed with the
.B \-b
.RB ( \-\-bit\-depth )
option.
.PP
Note that EsounD support requires the
.I libesd
library.
.SH Time Specifications
For options which accept a time or duration argument, the following time
specifications are recognized:
.TP
.IB hh : mm : ss . ddd
Hours, minutes, seconds, and decimal fractions of a second. This specification
is flexible;
.IB hh : mm : ss\c
,
.IB mmm : ss\c
,
.BI : ss\c
,
.IB sss . ddd\c
,
.BI . ddd\c
, and
.I ssss
are all acceptable. The component values are not constrained to any particular
range or number of digits.
.TP
.IB frac / unit
A length of time specified as a rational number, in seconds. This can be used
for sample-granularity, for example
.B 32/44100
for 32 samples, assuming a 44100\ Hz sample frequency.
.TP
.IB time1 + time2
A composite time made by adding two time values together. This permits mixing
the above specification forms.
.PP
The resolution of any time value cannot exceed 1/352800000 seconds.
.SH DIAGNOSTICS
.TP
.B error: frame #: lost synchronization
If encountered at the beginning of a file, this means the file contains
something other than an ID3v2 tag before the MPEG audio data. If encountered
in the middle of a file, it may mean the file is corrupt. This message is most
commonly encountered, however, at the end of a file if the file contains an
ID3v1 tag that is not aligned to an MPEG audio frame boundary. In this case,
the message is harmless and may be ignored.
.PP
.TP
.B error: frame #: bad main_data_begin pointer
This message can occur while decoding a Layer\ III stream that has been cut or
spliced without preserving its bit reservoir. The affected frame cannot be
properly decoded, but will be used to help restore the bit reservoir for
following frames.
.PP
Most other messages indicate a deficiency in the input stream.
.PP
When a frame cannot be properly decoded, a concealment strategy is used as
follows:
.TP 2
\(bu
If the previous frame was properly decoded, it is repeated in place of the
current frame.
.TP 2
\(bu
If the previous frame was
.I not
properly decoded, the current frame is muted.
.SH NOTES
.SS Output Precision
Because MAD produces samples with a precision greater than 24 bits, by default
.B madplay
will dither the samples to the precision of the output format. This produces
high quality audio that generally sounds superior to the output of a simple
rounding algorithm. However, dithering may unfavorably affect an analytic
examination of the output, and therefore it may be disabled by using the
.B \-d
.RB ( \-\-no\-dither )
option.
.PP
The actual precision of output samples can be requested with the
.B \-b
.RB ( \-\-bit\-depth )
option. Whether the request can be honored depends on the capabilities of the
audio device or output format. If this option is not specified, a typical
default depth will be used (often 16) or in the case of output to an audio
device, the highest bit depth determined to work reliably with the device will
be used.
.PP
Note that bit depths greater than 24 are effectively the same as 24-bit
precision samples padded to the requested depth.
.SS Ancillary Data
MPEG audio streams contain an ancillary data stream in addition to audio data.
Most often this does not contain any useful information and may simply consist
of padding bits. The MPEG-2 extension to multichannel audio uses part of this
ancillary stream to convey multichannel information; presently MAD does not
interpret such data.
.PP
For applications which have uses for the stream, ancillary data can be
extracted with the
.B \-\-ancillary\-output
option.
.SS Replay Gain
.B madplay
optionally supports the Replay Gain proposed standard with the
.B \-G
.RB ( \-\-replay\-gain )
option to make compensating volume adjustments when playing decoded audio from
different sources. There are two Replay Gain profiles:
.B radio
strives to make gain adjustments that give all tracks equal loudness, while
.B audiophile
attempts to give ideal listening loudness. These adjustments are relative to a
reference of 83\ dB SPL.
.PP
A pre-amp gain is also used in conjunction with Replay Gain to achieve the
overall desired loudness. When Replay Gain is enabled, this pre-amp gain
defaults to +6\ dB, however it can be changed with the
.B \-a
.RB ( \-\-attenuate ,
.BR \-\-amplify )
option or keyboard controls.
.PP
Note that when enabled, Replay Gain overrides any relative volume adjustments
specified by ID3 tags (RVA2). Replay Gain is also incompatible with the
.B \-A
.RB ( \-\-adjust\-volume )
option; any attempt to use it will be ignored.
.PP
Replay Gain information is read either from an ID3 tag (RGAD) or from an
encoder tag written by
.BR lame (1).
If both are present, the information in the ID3 tag takes precedence. In
accordance with the proposed standard, if the requested Replay Gain profile is
not available but the alternate is, the alternate is used instead.
.PP
Due to an unfortunate heresy, versions of
.BR lame (1)
since 3.95.1 write Replay Gain information using a reference of 89\ dB SPL
instead of the 83\ dB specified in the Replay Gain proposed standard. To
compensate,
.B madplay
automatically subtracts 6\ dB from the Replay Gain values read from such tags.
.PP
Note that
.B madplay
does not yet support hard limiting as suggested by the Replay Gain proposed
standard; nor does it automatically reduce the pre-amp gain to avoid clipping.
.SH CONFORMING TO
MAD conforms to Part\ 3 of the ISO/IEC\ 11172 (MPEG-1) international standard
for decoding MPEG audio. In addition, MAD supports the extension to Lower
Sampling Frequencies (LSF) as defined in Part\ 3 of ISO/IEC\ 13818 (MPEG-2).
.PP
The output from MAD has been tested and found to satisfy the ISO/IEC\ 11172-4
computational accuracy requirements for compliance. In most configurations,
MAD is a
.I Full Layer\ III ISO/IEC\ 11172-3 audio decoder
as defined by the standard.
.PP
The ID3 tag parsing library used by
.B madplay
conforms to the ID3v2.4.0 informal standard.
.PP
With the exception of the clipping prevention provisions, Replay Gain support
provided by
.B madplay
is in accordance with the Replay Gain proposed standard published on July\ 10,
2001 by David Robinson.
.SH BUGS
The resampling algorithm used by
.B madplay
is one of a linear interpolation, and does not produce optimum quality
sound.
.PP
The granularity of start and stop times
.RB ( \-\-start
and
.BR \-\-time )
is not yet as fine as this document suggests.
.SH AUTHOR
Robert Leslie <[e-mail]>
.SH SEE ALSO
.BR lame (1),
.BR normalize (1),
.BR sox (1),
.BR wget (1)
.\" .BR id3tag (1)
.\" .BR libmad (3)
.\" .BR libid3tag (3)