# 使用 Homebrew, apt 安装 adplay

查看 adplay 的安装路径、可执行文件、元数据以及面向 AI 代理工作流的安全说明。

## 安装

```sh
sudo av install brew:adplay
```

其他安装命令:

### macOS

- Homebrew (100%):

```sh
brew install adplay
```

  证据: local Homebrew formula metadata

### Linux

- Debian apt (92%):

```sh
sudo apt install adplay
```

  证据: Debian stable package indexes: adplay from https://deb.debian.org/debian/dists/stable/main/binary-amd64/Packages.xz

## 软件包事实

- **软件包键:** brew:adplay
- **软件包管理器:** Homebrew
- **软件包管理器页面:** <https://formulae.brew.sh/formula/adplay>
- **版本:** 1.9
- **来源摘要:** Command-line player for OPL2 music
- **主页:** <https://adplug.github.io>
- **仓库:** <https://github.com/adplug/adplay-unix>
- **上游文档:** <https://adplug.github.io/>
- **许可证:** GPL-2.0-or-later
- **源码归档:** <https://github.com/adplug/adplay-unix/releases/download/v1.9/adplay-1.9.tar.bz2>
- **最后更新:** 2026-06-18T02:28:54-04:00
- **已生成:** 2026-07-26T07:20:29+00:00

## 可执行文件

- adplay (cli)
- adplay (别名)

## 依赖

- adplug
- libbinio
- sdl2-compat

## 构建依赖

- libtool
- pkgconf

## 安装行为

- post-install 钩子: 未定义
- Bottle: 可用 于 arm64_linux, arm64_sequoia, arm64_sonoma, arm64_tahoe, sonoma, x86_64_linux

## 版本和新鲜度

- 页面生成时间: 2026-07-26
- 管理器版本: 1.9
- 管理器更新时间: 2026-06-18
- 本地数据: OK
- 上游仓库: https://github.com/adplug/adplay-unix
- 信息: No cached GitHub release or tag data was available.
## 项目历史与用法

AdPlay/UNIX is the console player frontend for AdPlug, aimed at playing OPL2/AdLib music files on Unix-like systems without requiring vintage sound hardware. In package-manager terms it is the small CLI companion to the larger AdPlug decoding library: install the library for embedding or utilities, install AdPlay when you want an `adplay` command.

### 项目历史

The project dates itself to Simon Peter's 2001 AdPlay/UNIX codebase and has remained tied to AdPlug's library releases. Its README describes it as AdPlug's UNIX console frontend and notes that it supports the full range of AdPlug file playback features, while using emulated OPL2 output across available output devices.

AdPlay/UNIX evolved mostly by tracking AdPlug core capabilities and Unix audio backends. The NEWS file records early work such as GNU autotools conversion, a man page, FreeBSD fixes, modular output, OSS/null/disk outputs, SDL/ESD/QSA support, ALSA support, libao support, AdPlug database support, and later NukedOPL and surround-effect support.

### 采用历史

The AdPlug project split AdPlay and other frontends into separate GitHub repositories when development moved from SourceForge to GitHub in 2015. The package appears in Homebrew, Debian, and Ubuntu according to the provided package-manager metadata, which matches its niche as a command-line retro-audio player rather than a general desktop music application.

Recent AdPlug site news still publishes AdPlay/UNIX releases alongside the core library. The site lists AdPlay/UNIX 1.9 in December 2025 and ties it to AdPlug 2.4, SDL2 build support, subsong fixes, and a RAW file writer.

### 使用方式

Typical use is direct playback from a terminal: pass one or more supported AdPlug music files to `adplay`, then use `adplay --help` or the man page for options. Because it delegates format support to AdPlug, it is useful for collections of DOS game and tracker-era AdLib formats rather than ordinary compressed audio formats.

Packagers care about its dependency relationship: AdPlay/UNIX needs AdPlug, with the README specifying AdPlug 1.4 or newer and 2.2 or newer for full feature support. That makes it a thin frontend package whose usefulness follows the breadth and correctness of the AdPlug core.

### 为什么软件包爱好者会关心

AdPlay/UNIX is a good example of the Unix package split between a reusable media library and a tiny CLI frontend. It gives retro-audio users a scriptable player while letting distributions package the decoder library separately for other applications.

Its long tail matters because OPL playback sits at the intersection of game preservation, tracker music, and emulator-adjacent tooling. A small command like `adplay` is often the easiest way to verify obscure AdLib files without launching a full emulator or media player plugin.

### 时间线

- 2001: AdPlay/UNIX codebase copyright begins.
- 2010: AdPlay/UNIX 1.7 released with AdPlug 2.2.
- 2015: AdPlug development moved to GitHub and AdPlay became a separate repository.
- 2017: AdPlay/UNIX 1.8 released with AdPlug 2.3 and NukedOPL support.
- 2020: AdPlay/UNIX 1.8.1 released with AdPlug 2.3.2 integration.
- 2025: AdPlay/UNIX 1.9 released with AdPlug 2.4 integration and SDL2 build support.

### Related projects

- AdPlug is the decoding/playback library behind AdPlay/UNIX.
- Other AdPlug frontends include player plugins and standalone ports such as the Winamp, XMMS, and DOS-facing AdPlay variants.

### 来源

- <https://adplug.github.io/>
- <https://github.com/adplug/adplay-unix#readme>
- <https://raw.githubusercontent.com/adplug/adplay-unix/master/NEWS>
- source_facts.package-manager


## 安全说明

narrow executable package without higher-risk signals.

- **Geiger 风险:** 绿色 / 低
- narrow executable package without higher-risk signals

## 源数据库详情

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

## 其他软件包管理器记录

- Debian apt - adplay - 1.8.1-4: normalized package name match | Debian stable package indexes: adplay from https://deb.debian.org/debian/dists/stable/main/binary-amd64/Packages.xz | console-based OPL2 audio player | https://adplug.github.io/
- Ubuntu apt - adplay - 1.8.1-3build2: normalized package name match | Ubuntu 24.04 LTS package indexes: adplay from https://archive.ubuntu.com/ubuntu/dists/noble/universe/binary-amd64/Packages.gz | console-based OPL2 audio player | https://adplug.github.io/


## 相关链接

- [Source-control packages](https://www.automicvault.com/zh-hans/pkg/source-control-tools/) - Belongs to a source-control command family.
- [Terminal utility packages](https://www.automicvault.com/zh-hans/pkg/terminal-utilities/) - Matched terminal and command-line workflow metadata.
- [Networking and protocol packages](https://www.automicvault.com/zh-hans/pkg/networking-protocol-tools/) - Matched network, protocol, or remote-service metadata.
- [Media and graphics packages](https://www.automicvault.com/zh-hans/pkg/media-graphics-tools/) - Matched media, image, audio, video, or graphics metadata.
- [adplug](https://www.automicvault.com/zh-hans/pkg/brew/adplug/) - Runtime dependency declared by Homebrew.
- [sdl2-compat](https://www.automicvault.com/zh-hans/pkg/brew/sdl2-compat/) - Runtime dependency declared by Homebrew.
- [libtool](https://www.automicvault.com/zh-hans/pkg/brew/libtool/) - Build dependency declared by Homebrew.
- [pkgconf](https://www.automicvault.com/zh-hans/pkg/brew/pkgconf/) - Build dependency declared by Homebrew.
- [flac123](https://www.automicvault.com/zh-hans/pkg/brew/flac123/) - Shares av.db curated category or tags: audio-player, cli, media.
- [kew](https://www.automicvault.com/zh-hans/pkg/brew/kew/) - Shares av.db curated category or tags: audio-player, cli, media.
- [mp3blaster](https://www.automicvault.com/zh-hans/pkg/brew/mp3blaster/) - Shares av.db curated category or tags: audio-player, cli, media.
- [mpg321](https://www.automicvault.com/zh-hans/pkg/brew/mpg321/) - Shares av.db curated category or tags: audio-player, cli, media.
- [ocp](https://www.automicvault.com/zh-hans/pkg/brew/ocp/) - Shares av.db curated category or tags: audio-player, cli, media.
- [qmmp](https://www.automicvault.com/zh-hans/pkg/brew/qmmp/) - Shares av.db curated category or tags: audio-player, cli, media.
- [qobine-tui](https://www.automicvault.com/zh-hans/pkg/brew/qobine-tui/) - Shares av.db curated category or tags: audio-player, cli, media.
- [mdxmini](https://www.automicvault.com/zh-hans/pkg/brew/mdxmini/) - Both packages work with overlapping file formats or content types. Shared terms: audio, cli, compat, media, music.

## Combined YAML source

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


## 来源

- 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
