# audiowaveform Audio Waveform Data Generator and Image Renderer

> audiowaveform is a BBC open-source C++ CLI tool that generates waveform data from MP3, WAV, FLAC, Ogg Vorbis, and Opus audio files. It outputs binary or JSON waveform data and renders PNG waveform images at configurable zoom levels.

- Skill: `agentskillexchange/audiowaveform-audio-waveform-data-generator-and-image-render` (Agent Skill)
- Install (CLI): `npx skillmds@latest add agentskillexchange/audiowaveform-audio-waveform-data-generator-and-image-render`
- Raw SKILL.md: https://api.skillmd.com/api/skills/agentskillexchange/audiowaveform-audio-waveform-data-generator-and-image-render/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: agentskillexchange (https://skillmd.com/u/agentskillexchange)
- Updated: 2026-09-08
- Page: https://skillmd.com/skills/agentskillexchange/audiowaveform-audio-waveform-data-generator-and-image-render

---


# audiowaveform Audio Waveform Data Generator and Image Renderer

audiowaveform is a BBC open-source C++ CLI tool that generates waveform data from MP3, WAV, FLAC, Ogg Vorbis, and Opus audio files. It outputs binary or JSON waveform data and renders PNG waveform images at configurable zoom levels.

## Installation

Use the upstream install or setup path that matches your environment:
- brew install audiowaveform
- docker pull realies/audiowaveform
- make
- make install

Requirements and caveats from upstream:
- ### Docker
- A Docker image based on Alpine Linux is available [here](https://hub.docker.com/r/realies/audiowaveform),
- alias awf='docker run --rm -v pwd:/tmp -w /tmp realies/audiowaveform'

Basic usage or getting-started notes:
- ![Example Waveform](/doc/example.png "Example Waveform")
- [Usage](#usage)
- ### Ubuntu

- Source: https://github.com/bbc/audiowaveform
- Extracted from upstream docs: https://raw.githubusercontent.com/bbc/audiowaveform/HEAD/README.md

## Source

- [Agent Skill Exchange](https://agentskillexchange.com/skills/audiowaveform-bbc-waveform-generator/)