GNU Octave: Audio File Utilities

Next: Audio Device Information, Up: Audio Processing [Contents][Index]

### 33.1 Audio File Utilities

The following functions allow you to read, write and retrieve information about audio files. Various formats are supported including wav, flac and ogg vorbis.

Loadable Function: info = audioinfo (filename)

  Return information about an audio file specified by filename.

Loadable Function: [y, fs] = audioread (filename)
Loadable Function: [y, fs] = audioread (filename, samples)
Loadable Function: [y, fs] = audioread (filename, datatype)
Loadable Function: [y, fs] = audioread (filename, samples, datatype)

  Read the audio file filename and return the audio data and sampling rate. The audio data is stored as matrix with rows corresponding to audio frames and columns corresponding to channels.

  The optional two-element vector argument samples specifies starting and ending frames.

  The optional argument datatype specifies the datatype to return. If it is `"native"`, then the type of data depends on how the data is stored in the audio file.

  Read a file and return a specified range of frames in an array of specified type.

Loadable Function: audiowrite (filename, y, fs)
Loadable Function: audiowrite (filename, y, fs, name, value, …)

  Write audio data from the matrix y to filename with the file format determined by the file extension.

  Additional name and value argument pairs may be used to specify the following options:

  ‘`BitsPerSample`’

    Number of bits per sample, valid values are 8, 16, 24 and 32. Default is 16.

  ‘`BitRate`’

    Valid argument name, but ignored. Left for compatibility with MATLAB.

  ‘`Quality`’

    Quality setting for the Ogg Vorbis compressor. Values can range between 0 and 100 with 100 being the highest quality setting. Default is 75.

  ‘`Title`’

    Title for the audio file.

  ‘`Artist`’

    Artist name.

  ‘`Comment`’

    Comment.

Next: Audio Device Information, Up: Audio Processing [Contents][Index]