nealrame/nr-audiograph

A command line tool to create waveform images from audio files.

audiograph

Audiograph is a command line tool aimed at producing waveform images from audio input files. It is possible to customize the generated waveform using some program options. It takes as input a Wav/PCM, a MP3 or an Ogg/Vorbis and outputs a PNG image. It will run exclusively on a GNU/Linux platform.

Features

• runs on GNU/Linux platform,
• supports Wav/PCM, MP3 and Ogg/Vorbis audio files,
• customizable output using colors and gradients.

Installation

Ubuntu

> apt-get install build-essential git-core libboost-all-dev libcairo2-dev libogg-dev libmp3lame-dev libvorbis-dev 
> git clone https://github.com/NealRame/nr-audiograph.git
> cd nr-audiograph
> git submodule init
> git submodule update
> make depends
> make Release

Fedora

Usage

Synopsis

audiograph [OPTIONS] FILE

Options

Common options :

• -h,--help

  Print usage on standard input and exit.

• -o FILENAME,--output=FILENAME

  Set output filename. Default name of the output file will be determined as the base name of the input file with the extension replaced by .png.

• -v,--version

  Print the command version string and exit.

Audio options :

• -I FORMAT,--input-audio-format=FORMAT

  Set the input audio format. Format must be one of the following values : mp3, oggvorbis or pcm.

  When the option is not passed on the command line, the format of the input file is assumed to be :

  • WAV/PCM when input file name extension matches .wav,
  • MP3 when input file name extension matches .mp3,
  • Ogg/Vorbis when input file name extension matches .ogg.

Render options :

• -b COLOR,--background=COLOR

  Set the background brush. By default the background color will be rgba(0, 0, 0, 0).

  See below for COLOR syntax.

• -f BRUSH,--foreground=BRUSH

  Set the foreground brush. By default the foreground brush will be solid color #000.

  See below for BRUSH syntax.

• -s SIZE,--size=SIZE

  Define the size of the waveform. By default the size of the waveform will be 1024 pixels wide by 256 pixels high.

  See below for SIZE syntax.

Syntax

SIZE          ::= integerxinteger
COLOR         ::= #XXX | #XXXXXX | rgb(decimal,decimal,decimal) | rgba(decimal,decimal,decimal,decimal)
GRADIENT      ::= gradient({GRADIENT_STOP})
GRADIENT_STOP ::= COLOR decimal

decimal numbers (for colors component and GRADIENT_STOP) must belong to the interval [0,1].

Gradients are vertical gradients. The decimal value after the color determines the color of a relative position. The absolute position is obtained by the product of the given decimal value by the height of the wave form.

Examples

• > audiograph "Boards of Canada - Music Is Math.mp3"

  

• > audiograph -s 1024x128 "Boards of Canada - Music Is Math.mp3"

  

• > audiograph -f "#f03a11" "Skinny Puppy - Reclamation.ogg"

  

• > audiograph -s 1024x128 -f "gradient(#444 0, #333 0.25, #222 0.5, #333 0.75, #444 1)" "Tool - Schism.ogg"