snippetbashTip

mpg321 — High Performance MPEG 1.0/2.0/2.5 Audio Player for Layer 1, 2, and 3. Mpg321 was written (sometime i

Submitted by: @import:tldr-pages·Mar 2, 2026·

Viewed 0 times

commandplayermpg321cliaudiompeghighperformance

Problem

How to use the mpg321 command: High Performance MPEG 1.0/2.0/2.5 Audio Player for Layer 1, 2, and 3. Mpg321 was written (sometime in 1999) to be a drop-in replacement for the (previously) non-free mpg123 player. More information: <https://manned.org/mpg321>.

Solution

mpg321 — High Performance MPEG 1.0/2.0/2.5 Audio Player for Layer 1, 2, and 3. Mpg321 was written (sometime in 1999) to be a drop-in replacement for the (previously) non-free mpg123 player. More information: <https://manned.org/mpg321>.

Play an audio source exactly n times (0 means forever):

mpg321 {{[-l|--loop]}} {{n}} {{path/to/file1|URL1 path/to/file2|URL2 ...}}

Play a directory recursively:

mpg321 -B {{path/to/directory}}

Enable Basic Keys ( * or / - Increase or decrease volume, n - Skip song, m - Mute/unmute.) while playing:

mpg321 -K {{path/to/file1|URL1 path/to/file2|URL2 ...}}

Play files randomly until interrupted:

mpg321 {{[-Z|--random]}} {{path/to/file1|URL1 path/to/file2|URL2 ...}}

Shuffle the files before playing them once:

mpg321 {{[-z|--shuffle]}} {{path/to/file1|URL1 path/to/file2|URL2 ...}}

Play all files in the current directory and subdirectories, randomly (until interrupted), with Basic Keys enabled:

mpg321 -B {{[-Z|--random]}} -K .

Code Snippets

Play an audio source exactly `n` times (0 means forever)

mpg321 {{[-l|--loop]}} {{n}} {{path/to/file1|URL1 path/to/file2|URL2 ...}}

Play a directory recursively

mpg321 -B {{path/to/directory}}

Enable Basic Keys ( `*` or `/` - Increase or decrease volume, `n` - Skip song, `m` - Mute/unmute.) while playing

mpg321 -K {{path/to/file1|URL1 path/to/file2|URL2 ...}}

Play files randomly until interrupted

mpg321 {{[-Z|--random]}} {{path/to/file1|URL1 path/to/file2|URL2 ...}}

Shuffle the files before playing them once

mpg321 {{[-z|--shuffle]}} {{path/to/file1|URL1 path/to/file2|URL2 ...}}

Context

tldr-pages: common/mpg321

Revisions (0)

No revisions yet.