# Install audiowaveform with Homebrew, Nix, scoop

Generate waveform data and render waveform images from audio files. Version 1.11.1 via Homebrew; verified 2026-07-16. Also installable with nix: nix profile install nixpkgs#audiowaveform.

## Install

```sh
sudo av install brew:audiowaveform
```

Additional install commands:

### macOS

- Homebrew (100%):

```sh
brew install audiowaveform
```

  Evidence: local Homebrew formula metadata

### Linux

- Nix (92%):

```sh
nix profile install nixpkgs#audiowaveform
```

  Evidence: nixpkgs package indexes: pkgs/by-name/au/audiowaveform/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1

### Windows

- Scoop (92%):

```sh
scoop install main/audiowaveform
```

  Evidence: Scoop official bucket manifest trees: bucket/audiowaveform.json from https://api.github.com/repos/ScoopInstaller/Main/git/trees/master?recursive=1

## Package facts

- **Package key:** brew:audiowaveform
- **Package manager:** Homebrew
- **Version:** 1.11.1
- **Source summary:** Generate waveform data and render waveform images from audio files
- **Homepage:** <https://codeberg.org/chrisn/audiowaveform>
- **Last updated:** 2026-07-16T12:50:32Z
- **Generated:** 2026-08-03T19:37:03+00:00

## Executables

- audiowaveform (alias)

## Install behavior

- Bottle: not available

## Freshness

- Page generated: 2026-08-03
- Package-manager version: 1.11.1
## Project history and usage

audiowaveform is a C++ command-line utility for turning audio into compact waveform data and rendered waveform images. Its package-manager niche is the Unix-style batch tool for web audio, podcast tooling, archival previews, and any pipeline that needs waveform JSON, binary .dat data, or PNG output without opening a GUI editor.

### Project history

The project began as a public source release on 2013-10-14 in the BBC GitHub repository, with Chris Needham as the author. The current official Codeberg repository records the BBC GitHub repository as its original URL, and the README now identifies Chris Needham and contributors as the authors.

The official changelog shows steady growth from the 1.0 series into a more general media conversion and rendering tool: direct PNG output arrived in 2013, JSON waveform output and configurable image colors in 2014, FLAC support in 2014, Ogg Vorbis and automatic zoom-to-width behavior in 2018, Opus input in 2022, bar-style rendering in 2023, raw audio input in 2024, and Windows UTF-8 filename support in 2025.

### Adoption history

The README documents installation paths across Ubuntu PPA packages, Debian and RPM release assets, Arch AUR, Homebrew, Windows binaries, Docker, and Nix. The supplied package-manager facts also show Homebrew, Nix, and Scoop coverage, which matches its role as a small binary tool that packagers can expose as a single executable.

### How it is used

The core command reads MP3, WAV, FLAC, Ogg Vorbis, Opus, raw, .dat, or JSON waveform data and writes WAV, .dat, JSON, or PNG. It computes min/max sample pairs over a zoom window, can read or write standard streams with explicit formats, and can split channels or render fixed-width waveform images.

### Why package nerds care

audiowaveform is interesting to package maintainers because it sits at the intersection of C++, image output, and codec libraries while still behaving like a classic filter-style CLI. Its release assets and package notes cover several Linux families, macOS/Homebrew, Windows, Docker, and Nix, making it a good example of a multimedia utility that is useful only when the binary and its codec dependencies are packaged cleanly.

### Timeline

- 2013: Initial public release.
- 2014: JSON waveform output, image color options, and FLAC support were added.
- 2018: Ogg Vorbis input and automatic zoom-to-width rendering were added.
- 2022: Opus input support was added.
- 2023: Bar-style waveform rendering and JSON input support were added.
- 2025: The current Codeberg repository was created with the BBC GitHub repository listed as the original URL.
- 2026: Version 1.11.1 fixed Ubuntu packaging scripts.

### Related projects

- The README credits Audacity, madlld, and pdjson code, and links a separate compile-static-audiowaveform project for Windows binaries.

### Sources

- <https://api.github.com/repos/bbc/audiowaveform>
- <https://codeberg.org/api/v1/repos/chrisn/audiowaveform>
- <https://codeberg.org/chrisn/audiowaveform/src/branch/master/CHANGELOG.md>
- <https://codeberg.org/chrisn/audiowaveform/src/branch/master/README.md>


## Security Notes

No matching local secret-handling manifest was found for audiowaveform. Nucleus package metadata is still published here so future coverage has a stable package URL.


## Other Package-Manager Records

- Nix - audiowaveform: normalized package name match | nixpkgs package indexes: pkgs/by-name/au/audiowaveform/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1
- Scoop - main/audiowaveform: normalized package name match | Scoop official bucket manifest trees: bucket/audiowaveform.json from https://api.github.com/repos/ScoopInstaller/Main/git/trees/master?recursive=1


## Combined YAML source

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


## Sources

- 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
