<!--
{
  "availability" : [

  ],
  "documentType" : "symbol",
  "framework" : "MediaSetup",
  "identifier" : "/documentation/MediaSetup",
  "metadataVersion" : "0.1.0",
  "role" : "Framework",
  "symbol" : {
    "kind" : "Framework",
    "modules" : [
      "Media Setup"
    ],
    "preciseIdentifier" : "MediaSetup"
  },
  "title" : "Media Setup"
}
-->

# Media Setup

Enable users to configure HomePod speakers to stream music directly from your media service.

## Overview

Use the Media Setup framework in your iOS app to help users transfer account credentials to their HomePod speakers. For example, if you have an iOS app that already supports Siri media intents to stream music, adopt this framework so the user can set up their HomePod to stream music directly from your media service. Provide endpoints the HomePod speaker can access by adopting <doc://com.apple.documentation/documentation/SiriKitCloudMedia> on your media service.

An [`MSSetupSession`](/documentation/MediaSetup/MSSetupSession) uses the window you provide in [`presentationAnchor()`](/documentation/MediaSetup/MSAuthenticationPresentationContext/presentationAnchor()) to present a configuration view to the user. After the user confirms the configuration, the session assembles a token request from its [`account`](/documentation/MediaSetup/MSSetupSession/account) and sends it to your OAuth service. When your OAuth service responds with a token, the session verifies the token and [`configurationURL`](/documentation/MediaSetup/MSServiceAccount/configurationURL). Then it sends that token to the HomePod speakers associated with the user’s Apple ID in the Home app.

For details about applying for the SiriKit Media Intents on HomePod program, see the HomePod section of [Siri for Developers](https://developer.apple.com/siri).

## Topics

### HomePod Configuration

[`MSSetupSession`](/documentation/MediaSetup/MSSetupSession)

An object that manages the transfer of configuration information between your app, the system, your media service, and HomePod speakers.

[`MSServiceAccount`](/documentation/MediaSetup/MSServiceAccount)

Account details for accessing a streaming media service.

### Version

[`MediaSetupVersionNumber`](/documentation/MediaSetup/MediaSetupVersionNumber)

The version number of the Media Setup framework.

[`MediaSetupVersionString`](/documentation/MediaSetup/MediaSetupVersionString)

The version of the Media Setup framework.


---

Copyright &copy; 2026 Apple Inc. All rights reserved. | [Terms of Use](https://www.apple.com/legal/internet-services/terms/site.html) | [Privacy Policy](https://www.apple.com/privacy/privacy-policy)