Skip to content

Conversation

@jasonhollis
Copy link

Summary

This PR adds comprehensive documentation explaining why spatial audio metadata is not currently available in Music Assistant through the Apple MusicKit API.

Motivation

Users frequently ask about spatial audio support. This documentation:

  1. Explains the MusicKit API limitation (not exposed by Apple)
  2. Documents why this is an Apple platform design decision
  3. Investigates attempted workarounds (all not viable)
  4. Provides recommendations for users
  5. Links to proper feedback channels

Changes

  • Added docs/apple_music_spatial_audio.md with:
    • Technical explanation of the limitation
    • Root cause analysis
    • Investigation of workarounds
    • Recommendations and references

Type of Change

  • Documentation
  • Bug fix
  • New feature
  • Breaking change

- Document MusicKit API limitation regarding spatial audio metadata
- Explain why spatial audio is not currently available in third-party apps
- Investigate and document attempted workarounds
- Provide recommendations for users and future approaches
- Link to official Apple documentation and feedback channels

This closes discussions about spatial audio support by providing a definitive technical explanation grounded in Apple's platform limitations.
@jasonhollis jasonhollis marked this pull request as draft November 12, 2025 23:31
@jasonhollis jasonhollis marked this pull request as ready for review November 12, 2025 23:33
@OzGav
Copy link
Contributor

OzGav commented Nov 13, 2025

Sorry what is this? You are trying to merge into a non existent docs folder?

This looks like it has been done with AI and the basic premise of

Users frequently ask about spatial audio support

is simply not true. I have never heard of anyone asking about this in relation to music assistant.

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.

2 participants