represents audio stored in the given file.


represents audio stored in the given URL.


represents audio with samples given by the array data.

Details and Options

  • Audio[] displays an audio player.
  • In Audio[file], file can be specified as a string or as a File object, referring to an AIFF, FLAC, MP3, OggVorbis or WAV file.
  • In Audio[url], url can be specified as a string, URL object, or CloudObject.
  • Audio can represent an audio signal stored in memory or can link to a local or remote audio file that is accessed as a stream for playback and processing.
  • When constructing an audio object by just keeping a link, the byte count of the representative object and therefore the containing notebook will be smaller.
  • In Audio[data], data can be either of the following:
  • {v1,v2,}sample values of the single-channel audio
    {{v11,v12,},{v21,v22,},}sample values of the multichannel audio, with values vij corresponding to channel i
  • The input array data can be given as a List, NumericArray, SparseArray, etc.
  • In Audio[data], rows of data are assumed to be channels of the resulting audio.
  • By default, sampling rate of 44100 Hz is assumed. Other sampling rates can be specified using the SampleRate option.
  • Audio[Sound[]] converts the sound to an audio object, sampling SoundNote primitives as needed.
  • Audio[data,"type"] can be used to create an audio object of a different type. Values in data are coerced to the specified type by rounding or clipping. By default, "Real32" is assumed.
  • Possible settings for "type" include:
  • "SignedInteger8"signed 8-bit integers from through
    "SignedInteger16"signed 16-bit integers from through
    "SignedInteger32"signed 32-bit integers from through
    "Real32"single-precision real (32 bit)
    "Real64"double-precision real (64 bit)
  • Audio is treated as a raw object by functions like AtomQ and for purposes of pattern matching.
  • The following options can be specified:
  • AppearanceAutomaticappearance of the generated player
    AudioChannelAssignmentAutomatichow to assign audio channels to outputs
    AudioOutputDevice$DefaultAudioOutputDeviceaudio output device to use for playback
    AudioLabelAutomaticthe label to show on the audio object
    MetaInformationmetainformation associated with the audio
    SampleRateAutomaticsampling rate
    SoundVolume1sound volume
  • Possible settings for Appearance are "Minimal", "Basic", and "Detailed".
  • Information for Audio may include the following properties:
  • "Channels"number of audio channels
    "DataType"underlying data type
    "Duration"duration of the audio signal
    "Length"number of audio samples
    "ResourcePath"path to the audio file
    "SampleRate"sampling rate


open all close all

Basic Examples  (2)

An audio object linking to a local file:

Click for copyable input

Waveform plot of the audio:

Click for copyable input

Attenuate an audio signal by simply multiplying it with a number:

Click for copyable input

Scope  (9)

Options  (5)

Properties & Relations  (7)

Neat Examples  (1)

Introduced in 2016
Updated in 2019