WOLFRAM

Wolfram Language & System Documentation Center

AudioChannelAssignment

is an option for Audio and related functions that specifies a mapping from audio channels to available speakers of the output audio device.

Details
Details and Options Details and Options
Examples  
Basic Examples  
Scope  
See Also
Related Guides
History
Cite this Page

AudioChannelAssignment

AudioChannelAssignment

is an option for Audio and related functions that specifies a mapping from audio channels to available speakers of the output audio device.

Details

  • Channel assignment specifies a mapping from audio channels to available speakers.
  • Typical settings include:
  • Automaticautomatic channel assignment
    {out1,out2,…}play input channel i on output outi
    "Mean"mean of all input channels on all outputs
    "Partition"partition the input channels on outputs
    "Periodic"periodic assignment of input channels to outputs
    "Take"playing audio channel i on the i^(th) output
  • Explicit channels outi can be any of the following:
  • Nonenot played on any output
    nplay on the n^(th) output
    {n1,n2,…}play on several outputs n1, n2, …
  • For a 5-channel input and 2 outputs, the channel assignments are equivalent to:
  • "Mean"{{1,2},{1,2},{1,2},{1,2},{1,2}}
    "Partition"{1,1,1,2,2}
    "Periodic"{1,2,1,2,1}
    "Take"{1,2,None,None,None}
  • Channel assignments can be specified when constructing an Audio or AudioStream object.

Examples

open all close all

Basic Examples  (2)

By default, a mono signal is played on both output channels:

Wolfram Language code: a = Import["ExampleData/rule30.wav"]

Play it only on the right channel:

Wolfram Language code: Audio[a, AudioChannelAssignment -> {2}]

Invert the channels of a stereo recording:

Wolfram Language code: a = ExampleData[{"Audio", "MaleVoice"}, "Audio"];
Wolfram Language code: Audio[a, AudioChannelAssignment -> {2, 1}]

Scope  (1)

In a multichannel recording, the channels are automatically assigned:

Wolfram Language code: a = ExampleData[{"Audio", "Walking"}, "Audio"]

For a four-channel audio sample, default assignment is {1,2,1,2}. Switch the left and right channels:

Wolfram Language code: Audio[a, AudioChannelAssignment -> {2, 1, 2, 1}]

Only play the left channels:

Wolfram Language code: Audio[a, AudioChannelAssignment -> {1, None, 1, None}]
Wolfram Research (2017), AudioChannelAssignment, Wolfram Language function, https://reference.wolfram.com/language/ref/AudioChannelAssignment.html (updated 2018).

Text

Wolfram Research (2017), AudioChannelAssignment, Wolfram Language function, https://reference.wolfram.com/language/ref/AudioChannelAssignment.html (updated 2018).

CMS

Wolfram Language. 2017. "AudioChannelAssignment." Wolfram Language & System Documentation Center. Wolfram Research. Last Modified 2018. https://reference.wolfram.com/language/ref/AudioChannelAssignment.html.

APA

Wolfram Language. (2017). AudioChannelAssignment. Wolfram Language & System Documentation Center. Retrieved from https://reference.wolfram.com/language/ref/AudioChannelAssignment.html

BibTeX

@misc{reference.wolfram_2026_audiochannelassignment, author="Wolfram Research", title="{AudioChannelAssignment}", year="2018", howpublished="\url{https://reference.wolfram.com/language/ref/AudioChannelAssignment.html}", note=[Accessed: 13-June-2026]}

BibLaTeX

@online{reference.wolfram_2026_audiochannelassignment, organization={Wolfram Research}, title={AudioChannelAssignment}, year={2018}, url={https://reference.wolfram.com/language/ref/AudioChannelAssignment.html}, note=[Accessed: 13-June-2026]}