.\" This -*- nroff -*- file has been generated from .\" DocBook SGML with docbook-to-man on Debian GNU/Linux. ...\" ...\" transcript compatibility for postscript use. ...\" ...\" synopsis: .P! ...\" .de P! \\&. .fl \" force out current output buffer \\!%PB \\!/showpage{}def ...\" the following is from Ken Flowers -- it prevents dictionary overflows \\!/tempdict 200 dict def tempdict begin .fl \" prolog .sy cat \\$1\" bring in postscript file ...\" the following line matches the tempdict above \\!end % tempdict % \\!PE \\!. .sp \\$2u \" move below the image .. .de pF .ie \\*(f1 .ds f1 \\n(.f .el .ie \\*(f2 .ds f2 \\n(.f .el .ie \\*(f3 .ds f3 \\n(.f .el .ie \\*(f4 .ds f4 \\n(.f .el .tm ? font overflow .ft \\$1 .. .de fP .ie !\\*(f4 \{\ . ft \\*(f4 . ds f4\" ' br \} .el .ie !\\*(f3 \{\ . ft \\*(f3 . ds f3\" ' br \} .el .ie !\\*(f2 \{\ . ft \\*(f2 . ds f2\" ' br \} .el .ie !\\*(f1 \{\ . ft \\*(f1 . ds f1\" ' br \} .el .tm ? font underflow .. .ds f1\" .ds f2\" .ds f3\" .ds f4\" '\" t .ta 8n 16n 24n 32n 40n 48n 56n 64n 72n .TH "MPG321" "1" .SH "NAME" mpg321 \(em Free clone of mpg123, a command-line mp3 player .SH "SYNOPSIS" .PP \fBmpg321 [options] file(s) | URL(s) | -\fP .SH "DESCRIPTION" .PP \fBmpg321\fP is a free command-line mp3 player, which uses the mad audio decoding library. mpg321 is written to be a drop-in replacement for the non-free \fBmpg123\fP player. Some functions remain unimplemented, but mpg321 should function as a basic drop-in replacement for \fBmpg123\fP front-ends such as \fBgqmpeg\fP, and those programs which use mpg123 to decode mp3 files (like \fBgtoaster\fP, and other CD-recording software). .PP \fBmpg321\fP differs from \fBmpg123\fP in several ways. First and foremost, it is fully Free, under the GNU General Public License. Secondly, it allows run-time switching of output devices (via the -o switch). (\fBmpg321\fP also allows configuring a default output device at compile-time, but run-time switching is always allowed). .SH "OPTIONS" .IP "\fB-o devicetype\fP " 10 Set the output device type to \fBdevicetype\fP. \fBdevicetype\fP can be one of: .IP "" 10 oss - the Linux Open Sound System; .IP "" 10 sun - the Sun audio system; .IP "" 10 alsa - the Advanced Linux Sound Architecture; .IP "" 10 alsa09 - the Advanced Linux Sound Architecture, version 0.9; .IP "" 10 esd - the Enlightened Sound Daemon; .IP "" 10 arts - the analog real-time synthesiser .IP "" 10 See \fB-a device\fP, below. .IP "\fB-a device\fP, \fB--audiodevice device\fP" 10 Use \fBdevice\fP for audio-out instead of the default device, depending on the output device you've chosen (via \fB-o devicetype\fP). By default this is the native sound device. Generally this is the device for \fBdevicetype\fP (or the default system device) to use for output (i.e. \fB/dev/sound/dsp1\fP). .IP "" 10 This option has no effect with \fB-o arts\fP. .IP "" 10 For \fB-o esd\fP, specify the host on which esd is running; defaults to localhost. .IP "" 10 For \fB-o alsa\fP, specify card:device; defaults to 0:0. .IP "\fB-g N\fP, \fB--gain N\fP " 10 Set gain (volume) to N (1-100). .IP "\fB-k N\fP, \fB--skip N\fP " 10 Skip N frames into the file being played. .IP "\fB-n N\fP, \fB--frames N\fP " 10 Decode only the first N frames of the stream. By default, the entire stream is decoded. .IP "\fB-@ list\fP, \fB--list list\fP " 10 Use the file list for a playlist. The list should be in a format of filenames followed by a line feed. Multiple -@ or --list specifiers will be ignored; only the last -@ or --list option will be used. The playlist is concatenated with filenames specified on the command-line to produce one master playlist. A filename of '-' will cause standard input to be read as a playlist. .IP "\fB-z\fP, \fB--shuffle\fP" 10 Shuffle playlists and files specified on the command-line. Produces a randomly-sorted playlist which is then played through once. .IP "\fB-Z\fP, \fB--random\fP" 10 Randomise playlists and files specified on the command-line. Files are played through, choosing at random; this means that random files will be played for as long as mpg321 is running. .IP "\fB-v\fP, \fB--verbose\fP " 10 Be more verbose. Show current byte, bytes remaining, time, and time remaining, as well as more information about the mp3 file. .IP "\fB-s\fP, \fB--stdout\fP " 10 Use standard output instead of an audio device for output. Output is in 16-bit PCM, little-endian. .IP "\fB-w N\fP, \fB--wav N\fP " 10 Write to wav file N instead of using the audio device. This option will be preferred if --cdr or --au are specified too. Specifying '-' for N will cause the file to be written to standard output. .IP "\fB--cdr N\fP " 10 Write to cdr file N instead of using the audio device. Specifying '-' for N will cause the file to be written to standard output. .IP "\fB--au N\fP " 10 Write to au file N instead of using the audio device. Specifying '-' for N will cause the file to be written to standard output. .IP "\fB-t\fP, \fB--test\fP " 10 Test mode; do no output at all. .IP "\fB-q\fP, \fB--quiet\fP " 10 Quiet mode; suppress output of mpg123 boilerplate and file and song name. .IP "\fB-R\fP " 10 "Remote control" mode. Useful for front-ends. Allows seeking and pausing of mp3 files. See README.remote (in /usr/share/doc/mpg321 on Debian and some other systems.) .IP "\fB--stereo\fP " 10 Force stereo output: duplicates mono stream on second output channel. Useful for output for devices that don't understand mono, such as some CD players. .IP "\fB--aggressive\fP " 10 Aggressive mode; try to get higher priority on the system. Needs root permissions. .IP "\fB--skip-printing-frames=N\fP " 10 Skip N frames between printing a frame status update, in both Remote Control (-R) and verbose (-v) mode. Can help CPU utilisation on slower machines. This is an mpg321-specific option. .IP "\fB--help\fP, \fB--longhelp\fP " 10 Show summary of options. .IP "\fB-V\fP, \fB--version\fP " 10 Show version of program. .SH "AUTHOR" .PP This manual page was written by Joe Drew . .PP Permission is granted to copy, distribute and/or modify this document under the terms of the BSD license. On Debian systems, this can be found in \fB/usr/share/common-licenses/BSD\fP. ...\" created by instant / docbook-to-man, Sun 17 Feb 2002, 11:18