FreeBSD Manual Pages
MPG321(1) General Commands Manual MPG321(1) NAME mpg321 -- Free clone of mpg123, a command-line mp3 player SYNOPSIS mpg321 [options] file(s) | URL(s) | - DESCRIPTION mpg321 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 mpg123 player. Some functions remain unimplemented, but mpg321 should function as a basic drop-in replacement for mpg123 front-ends such as gqm- peg, and those programs which use mpg123 to decode mp3 files (like gtoaster, and other CD-recording software). mpg321 differs from mpg123 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). (mpg321 also allows configuring a default output device at compile-time, but run-time switching is always allowed). OPTIONS -o devicetype Set the output device type to devicetype. devicetype can be one of: oss - the Linux Open Sound System; sun - the Sun audio system; alsa - the Advanced Linux Sound Architecture; alsa09 - the Advanced Linux Sound Architecture, version 0.9; esd - the Enlightened Sound Daemon; arts - the analog real-time synthesiser See -a device, below. -a device, --audiodevice device Use device for audio-out instead of the default device, depending on the output device you've chosen (via -o devicetype). By de- fault this is the native sound device. Generally this is the de- vice for devicetype (or the default system device) to use for output (i.e. /dev/sound/dsp1). This option has no effect with -o arts. For -o esd, specify the host on which esd is running; defaults to localhost. For -o alsa, specify card:device; defaults to 0:0. -g N, --gain N Set gain (volume) to N (1-100). -k N, --skip N Skip N frames into the file being played. -n N, --frames N Decode only the first N frames of the stream. By default, the en- tire stream is decoded. -@ list, --list list Use the file list for a playlist. The list should be in a format of filenames followed by a line feed. Multiple -@ or --list spec- ifiers 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. -z, --shuffle Shuffle playlists and files specified on the command-line. Pro- duces a randomly-sorted playlist which is then played through once. -Z, --random 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. -v, --verbose Be more verbose. Show current byte, bytes remaining, time, and time remaining, as well as more information about the mp3 file. -s, --stdout Use standard output instead of an audio device for output. Output is in 16-bit PCM, little-endian. -w N, --wav N Write to wav file N instead of using the audio device. This op- tion will be preferred if --cdr or --au are specified too. Speci- fying '-' for N will cause the file to be written to standard output. --cdr N Write to cdr file N instead of using the audio device. Specifying '-' for N will cause the file to be written to standard output. --au N Write to au file N instead of using the audio device. Specifying '-' for N will cause the file to be written to standard output. -t, --testTest mode; do no output at all. -q, --quiet Quiet mode; suppress output of mpg123 boilerplate and file and song name. -R "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.) --stereo 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. --aggressive Aggressive mode; try to get higher priority on the system. Needs root permissions. --skip-printing-frames=N Skip N frames between printing a frame status update, in both Re- mote Control (-R) and verbose (-v) mode. Can help CPU utilisation on slower machines. This is an mpg321-specific option. --help, --longhelp Show summary of options. -V, --version Show version of program. AUTHOR This manual page was written by Joe Drew <drew@debian.org>. 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 /usr/share/common-licenses/BSD. MPG321(1)
NAME | SYNOPSIS | DESCRIPTION | OPTIONS | AUTHOR
Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=mpg321&sektion=1&manpath=FreeBSD+Ports+15.1.quarterly>