Skip to content

Match Core Audio channel layouts for FLAC#848

Merged
sbooth merged 7 commits intomainfrom
flac-channel-order
Feb 14, 2026
Merged

Match Core Audio channel layouts for FLAC#848
sbooth merged 7 commits intomainfrom
flac-channel-order

Conversation

@sbooth
Copy link
Owner

@sbooth sbooth commented Feb 7, 2026

The channel layouts for FLAC 4.0, 5.0, and 5.1 are possibly incorrect.

4 channels

ffmpeg uses the quad layout.

CoreAudio uses kAudioChannelLayoutTag_WAVE_4_0_B (L R Rls Rrs). This is the current behavior.

It might be more correct to use kAudioChannelLayoutTag_Quadraphonic (L R Ls Rs -- 90 degree speaker separation).

5 channels (5.0)

CoreAudio uses kAudioChannelLayoutTag_WAVE_5_0_A (L R C Ls Rs).

This differs from the current behavior which is kAudioChannelLayoutTag_WAVE_5_0_B (L R C Rls Rrs).

6 channels (5.1)

CoreAudio uses kAudioChannelLayoutTag_WAVE_5_1_A (L R C LFE Ls Rs).

This differs from the current behavior which is kAudioChannelLayoutTag_WAVE_5_1_B (L R C LFE Rls Rrs).

The Core Audio channel definitions are:

// Ls - left surround
// Rs - right surround
// Rls - rear left surround
// Rrs - rear right surround

@sbooth sbooth changed the title Match CoreAudio channel layouts for FLAC Match Core Audio channel layouts for FLAC Feb 7, 2026
@sbooth sbooth marked this pull request as ready for review February 14, 2026 19:13
Copilot AI review requested due to automatic review settings February 14, 2026 19:13
Copy link
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

This PR updates the channel layout mappings for FLAC files to better align with Core Audio's standard WAVE channel layout conventions. Specifically, it changes the decoder to use the "A" variants of WAVE layouts (which use standard surround positions Ls/Rs) instead of the "B" variants (which use rear surround positions Rls/Rrs), and switches from MPEG_3_0_A to WAVE_3_0 for 3-channel audio.

Changes:

  • Changed 3-channel layout from MPEG_3_0_A to WAVE_3_0 for better consistency with WAVE conventions
  • Changed 5-channel layout from WAVE_5_0_B (L R C Rls Rrs) to WAVE_5_0_A (L R C Ls Rs)
  • Changed 6-channel layout from WAVE_5_1_B (L R C LFE Rls Rrs) to WAVE_5_1_A (L R C LFE Ls Rs)

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

@sbooth sbooth merged commit e71ead7 into main Feb 14, 2026
2 checks passed
@sbooth sbooth deleted the flac-channel-order branch February 14, 2026 19:26
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant