# Install mdxmini with Homebrew

Plays music in X68000 MDX chiptune format. Version 2.0.0 via Homebrew; verified 2026-06-18.

## Install

```sh
sudo av install brew:mdxmini
```

Additional install commands:

### macOS

- Homebrew (100%):

```sh
brew install mdxmini
```

  Evidence: local Homebrew formula metadata

## Package facts

- **Package key:** brew:mdxmini
- **Package manager:** Homebrew
- **Package manager page:** <https://formulae.brew.sh/formula/mdxmini>
- **Version:** 2.0.0
- **Source summary:** Plays music in X68000 MDX chiptune format
- **Homepage:** <https://github.com/mistydemeo/mdxmini/>
- **Repository:** <https://github.com/mistydemeo/mdxmini>
- **Upstream docs:** <https://github.com/mistydemeo/mdxmini#readme>
- **License:** GPL-2.0-or-later
- **Source archive:** <https://github.com/mistydemeo/mdxmini/archive/refs/tags/v2.0.0.tar.gz>
- **Last updated:** 2026-06-18T02:28:58-04:00
- **Generated:** 2026-07-08T18:08:21+00:00

## Executables

- mdxplay (cli)
- mdxplay (alias)

## Dependencies

- sdl2-compat

## Install behavior

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

## Freshness

- Page generated: 2026-07-08
- Package-manager version: 2.0.0
- Package-manager updated: 2026-06-18
- Local data: ok
- Upstream repository: https://github.com/mistydemeo/mdxmini
- Upstream latest detected: v2.0.0 (current)
## Project history and usage

mdxmini is a small C library and command-line playback package for MDX chiptunes from Sharp X68000 music culture. Its README frames the project around the X68000's YM2151 FM sound chip, PCM support, and the MDX archive ecosystem.

### Project history

The project sits in a lineage of MDX players rather than starting as a new file format. The official credits name the original X68000 MXDRV authors, Daisuke Nagano's Unix mdxplay, BouKiCHi's mdxmini library and Android player, and Misty De Meo as the current maintainer for bug fixes and improvements.

The public GitHub tags show a v1.0.0 tag in January 2016 and a v2.0.0 tag in July 2022 whose commit message notes SDL2 by default. That matches mdxmini's role as a preservation-oriented library that modern package managers can build as a conventional Unix command.

### Adoption history

Official README adoption evidence is niche but concrete: it lists MDXPLAYER for Android, ruby-mdxplay, Paula, and Modizer as programs using mdxmini. The Homebrew input facts package it as `mdxmini` with an `mdxplay` executable, making the library accessible to users who want quick playback rather than embedding the C API.

### How it is used

The README documents using `mdx_open`, `mdx_set_rate`, `mdx_get_length`, `mdx_get_title`, `mdx_get_tracks`, and `mdx_calc_sample` to decode an MDX file into PCM buffers. It also notes that song titles are usually Shift-JIS and that current-note data can support visualizers.

### Why package nerds care

For package collectors, mdxmini is the kind of tiny multimedia formula that preserves a specific historical computer-music format behind a normal Unix build. It matters less for breadth than for making X68000 MDX files playable and scriptable on modern machines.

### Timeline

- 2016: v1.0.0 tag appears in the official GitHub repository.
- 2022: v2.0.0 tag switches the build toward SDL2 by default.

### Related projects

- MXDRV, Unix mdxplay, MDXPLAYER for Android, ruby-mdxplay, Paula, Modizer, X68000 MDX archives.

### Sources

- <https://github.com/mistydemeo/mdxmini#readme>
- <https://github.com/mistydemeo/mdxmini/tags>
- source_facts.package-manager-url


## 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:** mdxmini
- **Version Scheme:** 0
- **Revision:** 0
- **Bottle Stable Root URL:** <https://ghcr.io/v2/homebrew/core>
- **Deprecated:** no
- **Disabled:** no
- **Keg Only:** no
- **URL Keys:** stable


## Related links

- [Source-control packages](https://www.automicvault.com/pkg/source-control-tools/) - Belongs to a source-control command family.
- [Terminal utility packages](https://www.automicvault.com/pkg/terminal-utilities/) - Matched terminal and command-line workflow metadata.
- [Text processing packages](https://www.automicvault.com/pkg/text-processing-tools/) - Matched text, document, or structured-data processing metadata.
- [Networking and protocol packages](https://www.automicvault.com/pkg/networking-protocol-tools/) - Matched network, protocol, or remote-service metadata.
- [sdl2-compat](https://www.automicvault.com/pkg/brew/sdl2-compat/) - Runtime dependency declared by Homebrew.
- [pmdmini](https://www.automicvault.com/pkg/brew/pmdmini/) - Shares av.db curated category or tags: audio, chiptune, cli, media.
- [abcde](https://www.automicvault.com/pkg/brew/abcde/) - Shares av.db curated category or tags: audio, cli, media.
- [adplay](https://www.automicvault.com/pkg/brew/adplay/) - Shares av.db curated category or tags: audio, cli, media.
- [adplug](https://www.automicvault.com/pkg/brew/adplug/) - Shares av.db curated category or tags: audio, cli, media.
- [aften](https://www.automicvault.com/pkg/brew/aften/) - Shares av.db curated category or tags: audio, cli, media.
- [alsa-lib](https://www.automicvault.com/pkg/brew/alsa-lib/) - Shares av.db curated category or tags: audio, cli, media.
- [bandcamp-dl](https://www.automicvault.com/pkg/brew/bandcamp-dl/) - Shares av.db curated category or tags: audio, cli, media.
- [carla](https://www.automicvault.com/pkg/brew/carla/) - Shares av.db curated category or tags: audio, cli, media.
- [projectm](https://www.automicvault.com/pkg/brew/projectm/) - Both packages work with overlapping file formats or content types. Shared terms: audio, cli, compat, media, music.
- [cmusfm](https://www.automicvault.com/pkg/brew/cmusfm/) - Both packages work with overlapping file formats or content types. Shared terms: audio, cli, media, music, player.

## Combined YAML source

View the package source record on GitHub. [combined/mdxmini.yml](https://github.com/automic-vault/db/blob/main/combined/mdxmini.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
- cross-ecosystem install command graph
