audiowaveform

# Audiowaveform ## Overview Generate waveform visualizations from audio files using BBC's audiowaveform tool. Renders PNG/SVG waveform images and outputs peak data as JSON or binary for web-based audio players (wavesurfer.js, peaks.js). Ideal for podcast players, music platforms, social media audio previews, and any UI that shows audio waveforms. ## Instructions ### Step 1: Installation ```bash # Ubuntu/Debian apt install -y audiowaveform # macOS brew install audiowaveform # From source (if not in repos) apt install -y cmake g++ libmad0-dev libsndfile1-dev libgd-dev libboost-filesystem-dev libboost-program-options-dev libboost-regex-dev git clone https://github.com/bbc/audiowaveform.git cd audiowaveform && mkdir build && cd build cmake .. && make && make install # Verify audiowaveform --version ``` ### Step 2: Generate Waveform Images **Basic PNG waveform:** ```bash audiowaveform -i episode.wav -o waveform.png ``` **Customized waveform:** ```bash audiowaveform -i episode.mp3 -o waveform.png \ --width 1800 \ --height 200 \ --colors audacity \ --background-color ffffff \ --waveform-color 3b82f6 \ --axis-label-color 666666 \ --border-color ffffff \ --zoom auto ``` **Color schemes:** - `audacity` — classic Audacity look - Custom: use hex `--waveform-color`, `--background-color` **High-res for social media (1200x630 — OG image size):** ```bash audiowaveform -i episode.wav -o social-preview.png \ --width 1200 --height 630 \ --background-color 1a1a2e...