# Install mpg321 with Homebrew, apt

Command-line MP3 player. Version 0.3.2 via Homebrew; verified 2026-06-19.

## Install

```sh
sudo av install brew:mpg321
```

Additional install commands:

### macOS

- Homebrew (100%):

```sh
brew install mpg321
```

  Evidence: local Homebrew formula metadata

### Linux

- Debian apt (92%):

```sh
sudo apt install mpg321
```

  Evidence: Debian stable package indexes: mpg321 from https://deb.debian.org/debian/dists/stable/main/binary-amd64/Packages.xz

## Package facts

- **Package key:** brew:mpg321
- **Package manager:** Homebrew
- **Package manager page:** <https://formulae.brew.sh/formula/mpg321>
- **Version:** 0.3.2
- **Source summary:** Command-line MP3 player
- **Homepage:** <https://mpg321.sourceforge.net/>
- **Repository:** <https://sourceforge.net/p/mpg321/code>
- **Upstream docs:** <https://mpg321.sourceforge.net/>
- **License:** GPL-2.0-or-later
- **Source archive:** <https://downloads.sourceforge.net/project/mpg321/mpg321/0.3.2/mpg321_0.3.2.orig.tar.gz>
- **Last updated:** 2026-06-19T12:32:40-07:00
- **Generated:** 2026-07-08T18:08:21+00:00

## Executables

- mpg321 (cli)
- mpg321 (alias)

## Dependencies

- libao
- libid3tag
- mad

## Install behavior

- Post-install hook: not defined
- Bottle: available on arm64_linux, arm64_monterey, arm64_sequoia, arm64_sonoma, arm64_tahoe, arm64_ventura, monterey, sonoma, ventura, x86_64_linux

## Freshness

- Page generated: 2026-07-08
- Package-manager version: 0.3.2
- Package-manager updated: 2026-06-19
- Local data: ok
- Upstream repository: https://mpg321.sourceforge.net/
- info: Release/tag comparison is only available for GitHub repositories.
## Project history and usage

mpg321 is a GPL command-line MP3 player created as a free replacement for mpg123. Its homepage credits Joe Drew as the person who conceived and wrote the project, notes that it uses code from Rob Leslie's MAD distribution, XMMS, and plaympeg from SMPEG, and lists Nanakos Chrysostomos as maintainer for the later SourceForge-hosted releases.

### Project history

The tool was designed to behave like mpg123 for front ends, scripts, and software that shell out to an MP3 decoder. That compatibility goal made it especially useful for package distributions and desktop front ends during the era when mpg123's licensing caused friction: mpg321 could play MP3 files, serve as a backend for other applications, and decode MP3 to WAV for CD-recording workflows while relying on the integer-only MAD decoder.

### How it is used

Its package-manager niche is narrow but clear: a small mpg123-compatible player rather than a general multimedia framework. Debian and Homebrew package it under its own name, and Debian describes it as a clone intended to function as a drop-in replacement in many cases, with some mpg123 functionality left unimplemented.

### Sources

- <https://formulae.brew.sh/formula/mpg321>
- <https://linux.die.net/man/1/mpg321>
- <https://mpg321.sourceforge.net/>
- <https://packages.debian.org/sid/mpg321>


## Security Notes

narrow executable package without higher-risk signals.

- **Geiger risk:** green / low
- narrow executable package without higher-risk signals

## Source Database Details

- **Source Database:** Homebrew formula API
- **Tap:** homebrew/core
- **Full Name:** mpg321
- **Version Scheme:** 0
- **Revision:** 3
- **Bottle Stable Root URL:** <https://ghcr.io/v2/homebrew/core>
- **Deprecated:** no
- **Disabled:** no
- **Keg Only:** no
- **URL Keys:** stable

## Other Package-Manager Records

- Debian apt - mpg321 - 0.3.2-4: normalized package name match | Debian stable package indexes: mpg321 from https://deb.debian.org/debian/dists/stable/main/binary-amd64/Packages.xz | Simple and lightweight command line MP3 player | https://mpg321.sourceforge.net
- Ubuntu apt - mpg321 - 0.3.2-3.3build1: normalized package name match | Ubuntu 24.04 LTS package indexes: mpg321 from https://archive.ubuntu.com/ubuntu/dists/noble/universe/binary-amd64/Packages.gz | Simple and lightweight command line MP3 player | http://mpg321.sourceforge.net


## Related links

- [Terminal utility packages](https://www.automicvault.com/pkg/terminal-utilities/) - Matched terminal and command-line workflow metadata.
- [Networking and protocol packages](https://www.automicvault.com/pkg/networking-protocol-tools/) - Matched network, protocol, or remote-service metadata.
- [Media and graphics packages](https://www.automicvault.com/pkg/media-graphics-tools/) - Matched media, image, audio, video, or graphics metadata.
- [Homebrew utility packages](https://www.automicvault.com/pkg/brew-utility-packages/) - Matched Homebrew package provider.
- [mpg123](https://www.automicvault.com/pkg/brew/mpg123/) - Package name indicates the same formula family.
- [mp3blaster](https://www.automicvault.com/pkg/brew/mp3blaster/) - Shares av.db curated category or tags: audio, audio-player, cli, media, mp3.
- [abcde](https://www.automicvault.com/pkg/brew/abcde/) - Shares av.db curated category or tags: audio, cli, media, mp3.
- [clamz](https://www.automicvault.com/pkg/brew/clamz/) - Shares av.db curated category or tags: audio, cli, media, mp3.
- [easy-tag](https://www.automicvault.com/pkg/brew/easy-tag/) - Shares av.db curated category or tags: audio, cli, media, mp3.
- [ebook2cw](https://www.automicvault.com/pkg/brew/ebook2cw/) - Shares av.db curated category or tags: audio, cli, media, mp3.
- [flac123](https://www.automicvault.com/pkg/brew/flac123/) - Shares av.db curated category or tags: audio, audio-player, cli, media.
- [id3lib](https://www.automicvault.com/pkg/brew/id3lib/) - Shares av.db curated category or tags: audio, cli, media, mp3.
- [id3v2](https://www.automicvault.com/pkg/brew/id3v2/) - Shares av.db curated category or tags: audio, cli, media, mp3.
- [streamripper](https://www.automicvault.com/pkg/brew/streamripper/) - Both packages work with overlapping file formats or content types. Shared terms: audio, cli, mad, media, mp3.
- [sc68](https://www.automicvault.com/pkg/brew/sc68/) - Both packages work with overlapping file formats or content types. Shared terms: audio, audio-player, cli, media, player.

## Combined YAML source

View the package source record on GitHub. [combined/mpg321.yml](https://github.com/automic-vault/db/blob/main/combined/mpg321.yml)


## Sources

- Nucleus package database
- Geiger risk classifier
- package-page enrichment
- curated package history
- package version freshness
- av.db category and tag curation
- package relationship graph
- external package-manager database matches
- cross-ecosystem install command graph
