MPG321(1)

✨ NAME ✨

mpg321 — a Simple and lightweight command line MP3 player. that's her. that's the whole vibe. 💅🎧

---

🌸 SYNOPSIS 🌸

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

like bestie you literally just hand her files, or URLs, or a - and she goes. screaming. 🎀

---

🦋 DESCRIPTION 🦋

okay so. mpg321 is a free command-line mp3 player, and she runs on the mad audio decoding library. iconic foundation, no notes. ✨

here's the lore: she was written to be a drop-in replacement for the (by-then) non-free mpg123 player. some functions remain unimplemented, no cap — but mpg321 should function as a basic drop-in replacement for mpg123 front-ends such as gqmpeg, and also for those programs which use mpg123 to decode mp3 files (like gtoaster, and other CD-recording software). so if something's looking for mpg123, she's right there, ready, main character energy. 👑🫶

---

💖 OPTIONS 💖

• -o devicetype — set the output device type to devicetype. and devicetype can be one of these lil guys:
  • 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

also pls go look at -a device, right below. 👇

• -a device, --audiodevice device — use device for audio-out instead of the default device, and which default that is depends on the output device you've chosen (via -o devicetype). 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 -o arts. sad but true. 😭

for -o esd, specify the host on which esd is running; defaults to localhost.

for -o alsa, 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. consistency queen fr fr. 💅

• -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 entire 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 specifiers will be ignored; only the last -@ or --list option will be used. (iconic monogamy tbh.) 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. she does not stop. she will not stop. 🔥
• -v, --verbose — be more verbose. show current byte, bytes remaining, time, and time remaining, as well as more information about the mp3 file. nosy in the best way. 🙈
• -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 option will be preferred if --cdr or --au are specified too. specifying - 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, --test — test mode; do no output at all. she's rehearsing. silent run-through. 🎭
• -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. hand her a folder and she eats. 🍓
• -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. (see the keys section below bestie 💜)
• -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. giving them what they need. 🫶
• --aggressive — aggressive mode; try to get higher priority on the system. needs root permissions. (she gets pushy. permission slip required.) 💀
• --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. ✨
• -l N, --loop N — 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.

---

🔑 Basic keys (enabled with -K) 🔑

• * or / — increase or decrease volume.
• n — skip song.
• m — mute/unmute.

keyboard warrior era fr. ⌨️✨

---

👑 AUTHOR 👑

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.

---

and that's the whole page bestie, straight out of the General Commands Manual — mpg321(1), top to bottom, every last line accounted for. go play something. slay. 💖🎀🦋🌸⭐🌈🧚💜