Use this command to install Audio Waveform Image Generator:
winget install --id=BBC.audiowaveform -e
audiowaveform is a C++ command-line application that generates waveform data from either MP3, WAV, FLAC, Ogg Vorbis, or Opus format audio files. Waveform data can be used to produce a visual rendering of the audio, similar in appearance to audio editing applications.
Audiowaveform is a C++ command-line application designed to generate waveform data from MP3, WAV, FLAC, Ogg Vorbis, or Opus format audio files. This tool allows users to create visual representations of audio waveforms efficiently.
Key Features:
Support for multiple audio formats including MP3, WAV, FLAC, Ogg Vorbis, and Opus.
Cross-platform compatibility, enabling use on various operating systems.
Customizable output parameters such as resolution and color schemes for tailored visualizations.
Efficient processing to handle large audio files with ease.
Audience & Benefit:
Ideal for content creators, audio engineers, and developers who require waveform visualization tools. Audiowaveform enhances workflows by providing precise and customizable waveform data, facilitating better integration into projects.
Installation:
Audiowaveform can be easily installed using winget, ensuring a seamless setup process.
This tool is essential for anyone needing to generate or integrate waveform visualizations into their work, offering both flexibility and efficiency.
audiowaveform is a C++ command-line application that generates waveform data
from either MP3, WAV, FLAC, Ogg Vorbis, or Opus format audio files. Waveform data can
be used to produce a visual rendering of the audio, similar in appearance to
audio editing applications.
Waveform data files are saved in either binary format (.dat) or JSON (.json).
Given an input waveform data file, audiowaveform can also render the audio
waveform as a PNG image at a given time offset and zoom level.
The waveform data is produced from an input audio signal by first combining the
input channels to produce a mono signal. The next stage is to compute the
minimum and maximum sample values over groups of N input samples (where N is
controlled by the --zoom command-line option), such that each N input
samples produces one pair of minimum and maximum points in the output.
Binary packages are available on the Releases page.
Download the correct RPM for your CentOS version and use these commands to install the RPM package,
together with all required dependencies. Replace the version number with the latest release version.
A Docker image based on Alpine Linux is available here,
thanks to @realies.
Example usage:
docker pull realies/audiowaveform
alias awf='docker run --rm -v `pwd`:/tmp -w /tmp realies/audiowaveform'
awf -i input.wav -o output.png
Building from source
audiowaveform requires cmake 2.8.7 or later, g++
4.6.3 or later, and Boost 1.46.0 or later.
The software has been developed on Ubuntu 12.04 and Fedora 18. Due to compiler
and library version requirements, the software may not build on earlier
operating system releases.
Note: for a static build you will need to include the following dependencies
apk add zlib-static libpng-static boost-static
A statically linkable build of FLAC is also required. This is not available in
Alpine so you must compile it yourself.
apk add autoconf automake libtool gettext
wget https://github.com/xiph/flac/archive/1.3.3.tar.gz
tar xzf 1.3.3.tar.gz
cd flac-1.3.3
./autogen.sh
./configure --enable-shared=no
make
make install
Use the following command on Debian-based systems to build a Debian package:
cpack -G DEB
or this command on Red Hat-based systems to build an RPM package:
cpack -G RPM
The packages can be locally installed (e.g., rpm -ivh *.rpm,
dpkg -i *.deb) or installed on another system, as long as the runtime
dependencies of the package are present (libmad, libsndfile, libid3tag,
gd and boost).
Install
sudo make install
By default this installs the audiowaveform program in /usr/local/bin, and
man pages in /usr/local/share/man. To change these locations, add a -D CMAKE_INSTALL_PREFIX=... option when invoking cmake above.
Run
audiowaveform --help
Usage
Command line options
audiowaveform accepts the following command-line options:
--help
Show help message.
--version, -v
Show version information.
--quiet, -q
Disable status messages.
--input-filename, -i
Input filename, which should be a MP3, WAV, FLAC, Ogg Vorbis, or Opus audio file, or a
binary or JSON format waveform data file. By default, audiowaveform uses the file
extension to decide how to read the input file (either .mp3, .wav, .flac, .ogg,
.oga, .opus, .raw, .dat, or .json as appropriate), but this can be overridden by the
--input-format option. If the --input-filename option is - or
is omitted, audiowaveform reads from standard input, and the
--input-format option must be used to specify the data format.
Note that Opus support requires libsndfile 1.0.29 or later, so may not be
available on all systems.
--output-filename, -o
Output filename, which may be either a WAV audio file, a binary or JSON format
waveform data file, or a PNG image file. By default, audiowaveform
uses the file extension to decide the kind of output to generate
(either .wav, .dat, .json, or .png, as appropriate), but this can be overridden
by the --output-format option. If the --output-filename option is
- or is omitted, audiowaveform writes to standard output, and the
--output-format option must be used to specify the data format.
--input-format
Input data format, either wav, mp3, flac, ogg, opus, .raw, dat, or
json. This option must be used when reading from standard input. It may also be
used to set the input file format, instead of it being determined from the file
extension from the --input-filename option.
--output-format
Output data format, either wav, dat, json, or png. This
option must be used when writing to standard output. It may also be used to set
the output file format, instead of it being determined from the file extension
from the --output-filename option.
--zoom, -z (default: 256)
When creating a waveform data file or image, specifies the number of input
samples to use to generate each output waveform data point.
Note: this option cannot be used if either the --pixels-per-second or
--end option is specified. When creating a PNG image file, a value of
auto scales the waveform automatically to fit the image width.
--pixels-per-second (default: 100)
When creating a waveform data file or image, specifies the number of output
waveform data points to generate for each second of audio input.
Note: this option cannot be used if either the --zoom or --end
option is specified.
--bits, -b (default: 16)
When creating a waveform data file, specifies the number of data bits to use
for output waveform data points. Valid values are either 8 or 16.
--split-channels
Output files are multi-channel, not combined into a single waveform.
--start, -s (default: 0)
When creating a waveform image, specifies the start time, in seconds.
--end, -e (default: 0)
When creating a waveform image, specifies the end time, in seconds.
Note: this option cannot be used if the --zoom option is specified.
--width, -w (default: 800)
When creating a waveform image, specifies the image width.
--height, -h (default: 250)
When creating a waveform image, specifies the image height.
--colors, -c (default: audacity)
When creating a waveform image, specifies the color scheme to use. Valid values
are either audacity, which generates a blue waveform on a grey background,
similar to Audacity, or audition, which generates a green waveform on a
dark background, similar to Adobe Audition.
--border-color
When creating a waveform image, specifies the border color. If not given,
the default color used is controlled by the --colors option.
The color value should include two hexadecimal digits for each of red, green,
and blue (00 to FF), and optional alpha transparency (00 to FF).
--background-color
When creating a waveform image, specifies the background color. If not given,
the default color used is controlled by the --colors option.
--waveform-color [, , ...]
When creating a waveform image, specifies the waveform color. If not given,
the default color used is controlled by the --colors option. This option
accepts multiple comma-separated color values, which are used with the
--split-channels option to produce a waveform image with multiple channels.
--axis-label-color
When creating a waveform image, specifies the axis labels color. If not given,
the default color used is controlled by the --colors option.
When creating a waveform image, specifies whether to render axis labels and
image border.
--amplitude-scale (default: 1)
When creating a waveform image or waveform data file, specifies an amplitude
scaling (or vertical zoom) to apply to the waveform. Must be either a number
or auto, which scales the waveform to the maximum height.
