# 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
- **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>
- **Last updated:** 2026-06-18T02:28:58-04:00
- **Generated:** 2026-08-03T19:37:03+00:00

## Executables

- mdxplay (alias)

## Install behavior

- Bottle: not available

## Freshness

- Page generated: 2026-08-03
- Package-manager version: 2.0.0
## 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


## Combined YAML source

View the package source record on GitHub. [combined/mdxmini.yml](https://github.com/mxcl/pkgdb/blob/main/combined/mdxmini.yml)


## Sources

- pkg.so package database
- Geiger risk classifier
- curated package history
- pkgdb category and tag curation
- cross-ecosystem install command graph