# 使用 Homebrew, dnf, MacPorts, apt, zypper 安装 adplug

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

## 安装

```sh
sudo av install brew:adplug
```

其他安装命令:

### macOS

- Homebrew (100%):

```sh
brew install adplug
```

  证据: local Homebrew formula metadata

- MacPorts (94%):

```sh
sudo port install adplug
```

  证据: MacPorts ports tree: audio/adplug/Portfile from https://api.github.com/repos/macports/macports-ports/git/trees/master?recursive=1

### Linux

- dnf (92%):

```sh
sudo dnf install adplug
```

  证据: Fedora Rawhide package metadata: adplug from https://dl.fedoraproject.org/pub/fedora/linux/development/rawhide/Everything/x86_64/os/repodata/07190dc5ae9f35ae73866675fed6d95fe6e8d9fe22c9d7cdf85862cb2ed24a4c-primary.xml.zst

- Debian apt (92%):

```sh
sudo apt install adplug-utils
```

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

- zypper (92%):

```sh
sudo zypper install adplugdb
```

  证据: openSUSE Tumbleweed package metadata: adplugdb from https://download.opensuse.org/tumbleweed/repo/oss/repodata/50b07339cb64c8ed4091bdbabddadc1ff5737b090e478818a195b40d8a3292861a879139b4a3987c31109699fde9fbf4a716367ddf4eef77da75f96e3193d6ed-primary.xml.zst

## 软件包事实

- **软件包键:** brew:adplug
- **软件包管理器:** Homebrew
- **版本:** 2.4
- **来源摘要:** Free, hardware independent AdLib sound player library
- **主页:** <https://adplug.github.io>
- **仓库:** <https://github.com/adplug/adplug>
- **最后更新:** 2026-05-26T23:37:49-04:00
- **已生成:** 2026-08-03T19:37:03+00:00

## 可执行文件

- adplugdb (别名)

## 安装行为

- Bottle: 不可用

## 版本和新鲜度

- 页面生成时间: 2026-08-03
- 管理器版本: 2.4
## 项目历史与用法

AdPlug is a hardware-independent AdLib/OPL2 and OPL3 playback library for old PC music formats. It is packaged both as a library and with utilities because it preserves a wide set of DOS game, tracker, and AdLib-era music formats behind one C++ playback API.

### 项目历史

The AdPlug README dates the project to Simon Peter's 1999 codebase and describes it as a multi-platform C++ library for playing data originally created for AdLib OPL2/3 boards on top of an emulator or real hardware. The project site emphasizes that AdPlug is the backend for multiple frontends, including standalone players and plugins.

AdPlug grew by adding replayers for individual formats instead of flattening everything into one generic parser. Its official site lists a broad catalog of supported formats, including AdLib Tracker, Westwood ADL, Creative CMF, DOSBox DRO, Apogee IMF, LucasArts LAA, Sierra SCI, Softstar RIX, Reality AdLib Tracker, VGM, and many others.

The release history shows a steady maintenance story: early versions made AdPlug a real library, added libbinio and a database framework, and expanded Unix portability; later versions added OPL3 support, safer emulators, test coverage, more game formats, CI, fuzzing-driven fixes, and modern build support.

### 采用历史

AdPlug started in the SourceForge era and moved active development to GitHub in 2015. At that point the project split AdPlay, the Winamp plugin, and other modules into separate repositories under the AdPlug organization, a packaging-friendly layout that distinguishes the core library from frontends.

The provided package facts show AdPlug in Homebrew, Debian/Ubuntu as `adplug-utils`, Fedora, MacPorts, and openSUSE-style packaging. That spread is typical for a small preservation library: it is not a mainstream end-user app, but it is valuable enough that Unix distributions keep it available for media players, testing tools, and retro collections.

The 2020 and 2025 releases show continued attention to security and correctness. The project recorded multiple CVE fixes in 2.3.3 and a large fuzzing, cleanup, and new-format pass in 2.4.

### 使用方式

Developers use AdPlug as a library when they need to decode or play original OPL music data without depending on an AdLib card. Users more often meet it indirectly through `adplugdb`, AdPlay/UNIX, player plugins, or other tools linked against the library.

For package maintainers, AdPlug is a classic multimedia library package: it has a stable public purpose, a long source history, optional frontends, platform-specific build concerns, and a supported-format matrix that grows as obscure file formats are identified and reimplemented.

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

AdPlug is significant because it turns a pile of game-specific and tracker-specific AdLib formats into a reusable Unix library. That matters for preservation workflows, regression testing old music files, and package ecosystems that prefer small CLI/library components over monolithic emulators.

Its emulator-license notes are also package-nerd bait: the README documents a move away from problematic MAME-derived emulator code toward LGPL-compatible emulation, which affects redistribution and whether distributions can ship the library cleanly.

### 时间线

- 1999: AdPlug project copyright begins.
- 2001: AdPlay/UNIX frontend copyright begins.
- 2010: AdPlug 2.2 released with new format support and AdPlay/UNIX 1.7.
- 2015: Development moved to GitHub and related modules were split into separate repositories.
- 2017: AdPlug 2.3 added many formats, CI support, and NukedOPL/WoodyOPL emulators.
- 2020: AdPlug 2.3.3 fixed multiple parser CVEs.
- 2025: AdPlug 2.4 added new formats, fuzzing-driven fixes, and updated NukedOPL.

### Related projects

- AdPlay/UNIX is the console frontend for AdPlug.
- libbinio is an AdPlug dependency for platform-independent binary I/O.
- DOSBox, NukedOPL, WoodyOPL, and older MAME-derived OPL code are relevant because AdPlug can play through emulated OPL implementations.

### 来源

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


## 安全说明

library-like package without higher-risk signals.

- **Geiger 风险:** 绿色 / 低
- library-like package without higher-risk signals

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

- Debian apt - adplug-utils - 2.3.3+dfsg-2: normalized package name match | Debian stable package indexes: adplug-utils from https://deb.debian.org/debian/dists/stable/main/binary-amd64/Packages.xz | free AdLib sound library (utils) | https://adplug.github.io/
- Debian apt - libadplug-2.3.3-0 - 2.3.3+dfsg-2: normalized package name match | Debian stable package indexes: libadplug-2.3.3-0 from https://deb.debian.org/debian/dists/stable/main/binary-amd64/Packages.xz | free AdLib sound library | https://adplug.github.io/
- Debian apt - libadplug-dev - 2.3.3+dfsg-2: normalized package name match | Debian stable package indexes: libadplug-dev from https://deb.debian.org/debian/dists/stable/main/binary-amd64/Packages.xz | free AdLib sound library (development) | https://adplug.github.io/
- Ubuntu apt - adplug-utils - 2.3.3+dfsg-2build1: normalized package name match | Ubuntu 24.04 LTS package indexes: adplug-utils from https://archive.ubuntu.com/ubuntu/dists/noble/universe/binary-amd64/Packages.gz | free AdLib sound library (utils) | https://adplug.github.io/
- Ubuntu apt - libadplug-2.3.3-0 - 2.3.3+dfsg-2build1: normalized package name match | Ubuntu 24.04 LTS package indexes: libadplug-2.3.3-0 from https://archive.ubuntu.com/ubuntu/dists/noble/universe/binary-amd64/Packages.gz | free AdLib sound library | https://adplug.github.io/
- Ubuntu apt - libadplug-dev - 2.3.3+dfsg-2build1: normalized package name match | Ubuntu 24.04 LTS package indexes: libadplug-dev from https://archive.ubuntu.com/ubuntu/dists/noble/universe/binary-amd64/Packages.gz | free AdLib sound library (development) | https://adplug.github.io/
- dnf - adplug - 2.3.3-16.fc45: normalized package name match | Fedora Rawhide package metadata: adplug from https://dl.fedoraproject.org/pub/fedora/linux/development/rawhide/Everything/x86_64/os/repodata/07190dc5ae9f35ae73866675fed6d95fe6e8d9fe22c9d7cdf85862cb2ed24a4c-primary.xml.zst | Software library for AdLib (OPL2/3) emulation | https://adplug.github.io/
- dnf - adplug-devel - 2.3.3-16.fc45: normalized package name match | Fedora Rawhide package metadata: adplug-devel from https://dl.fedoraproject.org/pub/fedora/linux/development/rawhide/Everything/x86_64/os/repodata/07190dc5ae9f35ae73866675fed6d95fe6e8d9fe22c9d7cdf85862cb2ed24a4c-primary.xml.zst | Development files for AdPlug | https://adplug.github.io/
- MacPorts - adplug: normalized package name match | MacPorts ports tree: audio/adplug/Portfile from https://api.github.com/repos/macports/macports-ports/git/trees/master?recursive=1
- zypper - adplugdb - 2.4-1.6: installed executable or alias match | openSUSE Tumbleweed package metadata: adplugdb from https://download.opensuse.org/tumbleweed/repo/oss/repodata/50b07339cb64c8ed4091bdbabddadc1ff5737b090e478818a195b40d8a3292861a879139b4a3987c31109699fde9fbf4a716367ddf4eef77da75f96e3193d6ed-primary.xml.zst | AdPlug Database Maintenance Utility | https://adplug.github.io/


## Combined YAML source

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


## 来源

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