AudioCopy to clipboard.
✖
Audio
Details and Options
- Audio is an object that can be input and output to functions, displayed as an audio player.
- The audio data can be stored in-memory or in a local or remote file, which can be streamed for playback and processing.
- Supported file formats include AIFF, FLAC, MP3, MP4, Ogg, QuickTime and WAV.
- Possible storage locations are:
-
File[…] data in a local file CloudObject[…] data in a public or private cloud object LocalObject[…] data in a local object URL[…] data in a URL - 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[Video[…]] creates an Audio object referring to the first audio track for file formats supported by Audio.
- 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:
-
Appearance Automatic appearance of the generated player AnnotationRules None a list of named annotations AudioChannelAssignment Automatic how to assign audio channels to outputs AudioOutputDevice $DefaultAudioOutputDevice audio output device to use for playback AudioLabel Automatic the label to show on the audio object MetaInformation metainformation associated with the audio SampleRate Automatic sampling rate SoundVolume 1 sound 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
Examples
open allclose allBasic Examples (2)Summary of the most common use cases
An audio object linking to a local file:
https://wolfram.com/xid/0y8h2a-hgtwnm
https://wolfram.com/xid/0y8h2a-p8d5e6
Attenuate an audio signal by simply multiplying it with a number:
https://wolfram.com/xid/0y8h2a-wqmdna
Scope (10)Survey of the scope of standard use cases
Basic Uses (5)
Import an Audio object from a file:
https://wolfram.com/xid/0y8h2a-jlm0t7
An audio object linking to a local file:
https://wolfram.com/xid/0y8h2a-6ki13r
An audio object linking to a URL:
https://wolfram.com/xid/0y8h2a-td0x8m
An audio object linking to a CloudObject:
https://wolfram.com/xid/0y8h2a-ctz2t3
An audio track of a video file:
https://wolfram.com/xid/0y8h2a-fgo1we
Audio Generation (5)
Create a mono audio signal from a list of data values:
https://wolfram.com/xid/0y8h2a-jtmgea
https://wolfram.com/xid/0y8h2a-rl64kc
https://wolfram.com/xid/0y8h2a-gea40k
https://wolfram.com/xid/0y8h2a-c06tx6
Convert a Sound object to Audio:
https://wolfram.com/xid/0y8h2a-dlk2wc
Convert a Sound object including notes:
https://wolfram.com/xid/0y8h2a-3gbaw
Create an audio signal of type "SignedInteger8":
https://wolfram.com/xid/0y8h2a-f5iaiv
https://wolfram.com/xid/0y8h2a-hzvh1c
Change the audio type from 8-bit signed integer to 32-bit real:
https://wolfram.com/xid/0y8h2a-i5667x
https://wolfram.com/xid/0y8h2a-5fsny
https://wolfram.com/xid/0y8h2a-mxd3zv
Options (5)Common values & functionality for each option
Appearance (1)
By default, a basic GUI is shown:
https://wolfram.com/xid/0y8h2a-0n4l3t
https://wolfram.com/xid/0y8h2a-kc6es4
https://wolfram.com/xid/0y8h2a-yfs28q
AudioLabel (1)
AudioOutputDevice (1)
By default, $DefaultAudioOutputDevice is used for playback:
https://wolfram.com/xid/0y8h2a-p6nm3e
https://wolfram.com/xid/0y8h2a-or49s0
https://wolfram.com/xid/0y8h2a-15bpzx
Check the list of available devices:
https://wolfram.com/xid/0y8h2a-7go2ea
Use the device specified as the default by the operating system:
https://wolfram.com/xid/0y8h2a-40fnwt
MetaInformation (1)
Add custom metainformation to an audio object:
https://wolfram.com/xid/0y8h2a-2t0qvf
Use Options to extract the metainformation:
https://wolfram.com/xid/0y8h2a-3u36u
SampleRate (1)
By default, a sample rate of 44.1 kHz is assumed:
https://wolfram.com/xid/0y8h2a-2eu3i7
https://wolfram.com/xid/0y8h2a-clekh9
Specify a different sample rate:
https://wolfram.com/xid/0y8h2a-emuo6n
Properties & Relations (7)Properties of the function, and connections to other functions
Use AudioQ to check for valid audio expressions:
https://wolfram.com/xid/0y8h2a-b2u0zy
https://wolfram.com/xid/0y8h2a-d1knca
Audio objects are atoms and cannot be subdivided:
https://wolfram.com/xid/0y8h2a-vp9jfa
Different audio types use different bit depths. Use smaller bit depth for compression:
https://wolfram.com/xid/0y8h2a-61fs64
https://wolfram.com/xid/0y8h2a-ld80ow
Audio[file] and Audio[url] are not importing the underlying data into the memory:
https://wolfram.com/xid/0y8h2a-0xzy3z
Extract ByteCount of the generated player:
https://wolfram.com/xid/0y8h2a-b97ic8
Compare with the byte count of the original file:
https://wolfram.com/xid/0y8h2a-08grzz
Use Normal to bring the data in out-of-core audio objects into memory:
https://wolfram.com/xid/0y8h2a-pw5oix
https://wolfram.com/xid/0y8h2a-3ljf8j
Use AudioGenerator to create various oscillators and noises:
https://wolfram.com/xid/0y8h2a-hvonvn
https://wolfram.com/xid/0y8h2a-9czjmg
https://wolfram.com/xid/0y8h2a-guvn4t
https://wolfram.com/xid/0y8h2a-5kdzx
Use AudioPlot to visualize the waveform of an audio object:
https://wolfram.com/xid/0y8h2a-fnmafd
Neat Examples (1)Surprising or curious use cases
Wolfram Research (2016), Audio, Wolfram Language function, https://reference.wolfram.com/language/ref/Audio.html (updated 2020).
Text
Wolfram Research (2016), Audio, Wolfram Language function, https://reference.wolfram.com/language/ref/Audio.html (updated 2020).
Wolfram Research (2016), Audio, Wolfram Language function, https://reference.wolfram.com/language/ref/Audio.html (updated 2020).
CMS
Wolfram Language. 2016. "Audio." Wolfram Language & System Documentation Center. Wolfram Research. Last Modified 2020. https://reference.wolfram.com/language/ref/Audio.html.
Wolfram Language. 2016. "Audio." Wolfram Language & System Documentation Center. Wolfram Research. Last Modified 2020. https://reference.wolfram.com/language/ref/Audio.html.
APA
Wolfram Language. (2016). Audio. Wolfram Language & System Documentation Center. Retrieved from https://reference.wolfram.com/language/ref/Audio.html
Wolfram Language. (2016). Audio. Wolfram Language & System Documentation Center. Retrieved from https://reference.wolfram.com/language/ref/Audio.html
BibTeX
@misc{reference.wolfram_2024_audio, author="Wolfram Research", title="{Audio}", year="2020", howpublished="\url{https://reference.wolfram.com/language/ref/Audio.html}", note=[Accessed: 07-January-2025
]}
BibLaTeX
@online{reference.wolfram_2024_audio, organization={Wolfram Research}, title={Audio}, year={2020}, url={https://reference.wolfram.com/language/ref/Audio.html}, note=[Accessed: 07-January-2025
]}