From e8ac712a6ddc409376c01b36a550c39d688714da Mon Sep 17 00:00:00 2001 From: salo Date: Sat, 10 Apr 2004 12:58:08 +0000 Subject: PKGREVISION++ Add manual page, sort bl3 inclusions. --- audio/mad123/Makefile | 7 ++- audio/mad123/files/mad123.1 | 147 ++++++++++++++++++++++++++++++++++++++++++++ 2 files changed, 151 insertions(+), 3 deletions(-) create mode 100644 audio/mad123/files/mad123.1 (limited to 'audio/mad123') diff --git a/audio/mad123/Makefile b/audio/mad123/Makefile index 8912b28bc33..83bb5ee2ca6 100644 --- a/audio/mad123/Makefile +++ b/audio/mad123/Makefile @@ -1,8 +1,8 @@ -# $NetBSD: Makefile,v 1.5 2004/03/26 02:27:34 wiz Exp $ +# $NetBSD: Makefile,v 1.6 2004/04/10 12:58:08 salo Exp $ # DISTNAME= mad123-0.7.1 -PKGREVISION= 2 +PKGREVISION= 3 CATEGORIES= audio MASTER_SITES= http://www.mctavish.co.uk/mad123/ @@ -14,11 +14,12 @@ USE_BUILDLINK2= yes do-install: ${INSTALL_PROGRAM} ${WRKSRC}/mad123 ${PREFIX}/bin/mad123 + ${INSTALL_MAN} ${FILESDIR}/mad123.1 ${PREFIX}/man/man1/ .include "../../mk/bsd.prefs.mk" -.include "../../audio/libmad/buildlink2.mk" .include "../../audio/id3lib/buildlink2.mk" +.include "../../audio/libmad/buildlink2.mk" .include "../../www/curl/buildlink2.mk" .if defined(USE_OSS) diff --git a/audio/mad123/files/mad123.1 b/audio/mad123/files/mad123.1 new file mode 100644 index 00000000000..afd2cd5ca18 --- /dev/null +++ b/audio/mad123/files/mad123.1 @@ -0,0 +1,147 @@ +.\" $NetBSD: mad123.1,v 1.1 2004/04/10 12:58:08 salo Exp $ +.\" +.\" Copyright (c) 2003 Lubomir Sedlacik +.\" All rights reserved. +.\" +.\" Redistribution and use in source and binary forms, with or without +.\" modification, are permitted provided that the following conditions +.\" are met: +.\" 1. Redistributions of source code must retain the above copyright +.\" notice, this list of conditions and the following disclaimer. +.\" 2. Redistributions in binary form must reproduce the above copyright +.\" notice, this list of conditions and the following disclaimer in the +.\" documentation and/or other materials provided with the distribution. +.\" +.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR +.\" IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES +.\" OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. +.\" IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT, +.\" INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, +.\" BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; +.\" LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED +.\" AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, +.\" OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY +.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF +.\" SUCH DAMAGE. +.\" +.Dd October 7, 2003 +.Dt mad123 1 +.Os +.Sh NAME +.Nm mad123 +.Nd play MPEG audio files +.Sh SYNOPSIS +.Nm +.Op Fl cq +.Op Fl b Ar size +.Op Fl f Ar device +.Op Ar file ... +.Sh DESCRIPTION +.Nm +is a command line MPEG audio files player using Robert Leslie's +.Dq libmad +fixed-point MP3 decoder library. +.Nm +is not meant to be a serious replacement for the ubiquitous +.Xr mpg123 1 +program. +Instead, it is merely an experiment in using libmad. +.Pp +At the time +.Nm +was written, a couple of things set it apart from the command line player +supplied with libmad, +.Xr madplay 1 : +.Pp +.Bl -dash -offset indent +.It +Support for URL style pathnames. +.It +The audio output is double-buffered (currently about 10 seconds worth +at 44100Hz sample rate). +This means +.Nm +is much less susceptible to network/CPU loading compared to +.Xr madplay 1 . +.It +An intelligent `read-ahead' algorithm can be used to pre-buffer large +chunks of the input MPEG audio stream. +.It +Simple keyboard controls. +.It +Ctrl-C behaves like it does for +.Xr mpg123 1 . +.It +.Nm +can be installed setuid-root (don't worry, it drops privs very early on) so +that it can adjust the scheduling priorities of its two (sometimes three) +processes to be even less susceptible to jitter. +(The third process is used when the MP3 stream is being read from +an URL). +.El +.Sh OPTIONS +The following options are available: +.Bl -tag -offset indent +.It Fl b Ar size +Allocate a +.Ar size +bytes buffer which will be used to read-ahead large chunks of the +.Ar file +at a time. +The +.Ar file +will be played even when only a small amount of data has been read in, but +when the buffer fills, no more data will be read until the buffer has +drained to 'nearly' empty. +This behaviour is useful when playing files over a congested network or +when you'd like to spin down a laptop drive for as long as possible. +.It Fl c +Enable keyboard controls. Currently, the following keys are recognised: +.Pp +.Bl -tag -width 4n -offset indent -compact +.It Ic n +Skip to the next track. +.It Ic b +Skip to the previous track. +.It Ic r +Rewind to the start of the current track. +.It Ic p +Pause. +.It Ic q +Quit. +.El +.It Fl f Ar device +Set the audio device to be +.Ar device . +The default is +.Pa /dev/sound . +.It Fl q +Be quiet. +.El +.Sh EXAMPLES +Play all MP3 files from the current directory, enable keyboard controls and +set the read-ahead buffer to 2 MB: +.Pp +.Dl "mad123 -c -b 0x200000 *.mp3" +.Pp +Play an MP3 stream from an URL, set the read-ahead buffer to 512 kB, be quiet: +.Pp +.Dl "mad123 -q -b 0x80000 http://a.server/mp3s/thrash.mp3" +.Sh NOTES +A read-ahead buffer smaller than 100 kB is ineffective. +.Sh SEE ALSO +.Xr madplay 1 , +.Xr mpg123 1 +.Sh AUTHORS +The +.Nm +program was written by +.An Steve Woodford Aq mad123@mctavish.co.uk . +This manual page was written by +.An Lubomir Sedlacik Aq salo@NetBSD.org . +.Sh BUGS +There are very few command line options. +.br +Many more buffer parameters should be tweakable on the command line. +.br +Only the Artist and Title ID3 tags are shown, if available. -- cgit v1.2.3