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
  • 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)
    "Real"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".


open allclose 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)

See Also

ListPlay  Sound  SampledSoundList  Import  AudioQ  AudioData  AudioGenerator  AudioType  AudioTrim  AudioDelay  AudioIntervals

Related Workflows

Introduced in 2016
| Updated in 2017