mpg321 — Simple and lightweight command line MP3 player

       This manual page was written by Joe Drew <drew@debian.org>.

       Maintained by Nanakos Chrysostomos <nanakos@wired-net.gr>.

       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)

* or /   Increase or decrease volume.

        n        Skip song.

        m        Mute/unmute.

mpg321  is  a free command-line mp3 player, which uses the mad audio decoding library. mpg321 was written
       to  be  a  drop-in  replacement  for  the  (by-then)  non-free  mpg123  player.   Some  functions  remain
       unimplemented,  but  mpg321  should function as a basic drop-in replacement for mpg123 front-ends such as
       gqmpeg, and those programs which use mpg123 to decode mp3 files (like gtoaster,  and  other  CD-recording
       software).

       mpg321 — Simple and lightweight command line MP3 player

-odevicetype
                 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 -adevice, below.

       -adevice, --audiodevicedevice
                 Use  device  for audio-out instead of the default device, depending on the output device you've
                 chosen (via -odevicetype).  By default this is the native sound device.  Generally this is the
                 device for devicetype (or the default system device) to use for output (i.e. /dev/sound/dsp1).

                 This option has no effect with -oarts.

                 For -oesd, specify the host on which esd is running; defaults to localhost.

                 For -oalsa, specify audio device using the hw:x,y syntax, where x and y are  numbers,  default
                 is  hw:0,0.   For  example,  if  there  is only one device installed, in most cases, the device
                 should be named hw:0,0.  When there is only one device, the device should always have the  same
                 name and numbers.

       -gN, --gainN
                 Set gain (volume) to N (1-100).

       -kN, --skipN
                 Skip N frames into the file being played.

       -nN, --framesN
                 Decode only the first N frames of the stream. By default, the entire stream is decoded.

       -@list, --listlist
                 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.

       -z, --shuffle
                 Shuffle  playlists and files specified on the command-line. Produces 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.

       -wN, --wavN
                 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.

       --cdrN   Write to cdr file N instead of using the audio device. Specifying '-' for N will cause the file
                 to be written to standard output.

       --auN    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, --test
                 Test mode; do no output at all.

       -q, --quiet
                 Quiet mode; suppress output of mpg123 boilerplate and file and song name.

       -B        Read  recursively the given directories. Allows you to define only the directory or directories
                 and then mpg321 recursively plays all the songs.

       -F        Turn on FFT analysis on PCM data. Remote mode only

       -S        Report song to AudioScrobbler (last.fm).

       -x        Set xterm title setting

       -b        Number of decoded frames for the output buffer.

       -K        Enable Basic Keys.

       -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.)

       -3, --restart
                 Restart "remote shell". Used only when in "Remote control" mode.

       --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 Remote Control (-R)  and  verbose
                 (-v) mode. Can help CPU utilisation on slower machines. This is an mpg321-specific option.

       -lN, --loopN
                 Loop song or playlist N times.If N is 0 means infinite times.

       --help, --longhelp
                 Show summary of options.

       -V, --version
                 Show version of program.

mpg321[options]file(s)|URL(s)|-