musickit

Search the Apple Music catalog and play tracks with MusicKit in iOS apps.

Updated May 10, 2026
One-click install
npx skills add https://github.com/FelixRauch/medat-figuren --skill musickit-felixrauch
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: musickit
Source: https://github.com/FelixRauch/medat-figuren/tree/main/.agents/skills/musickit
Command: npx skills add https://github.com/FelixRauch/medat-figuren --skill musickit-felixrauch

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

It solves the problem of integrating Apple Music catalog search, subscription-gated playback, and accurate playback metadata so your iOS app can control music and show correct track info on the Lock Screen and Control Center.

Core Features & Use Cases

  • MusicKit catalog search: Query Apple Music for songs and albums and display results inside your app.
  • Subscription checks and authorization: Request MusicKit access and verify Apple Music entitlement before enabling playback.
  • Playback and queue management: Play Apple Music content using ApplicationMusicPlayer, including next-item and queue insertion behaviors.
  • Now Playing metadata & remote controls: Publish track details via MPNowPlayingInfoCenter and handle play/pause/next/previous through MPRemoteCommandCenter.
  • Use Case: Build a SwiftUI mini-player that searches songs, plays them with an app-scoped player, updates Lock Screen metadata per track change, and supports AirPods/Control Center controls.

Quick Start

Integrate the MusicKit capability, add NSAppleMusicUsageDescription, and implement MusicAuthorization + MusicSubscription checks before starting ApplicationMusicPlayer playback.

Frequently Asked Questions about musickit

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I play Apple Music tracks inside my iOS app and update the Lock Screen metadata?

Use ApplicationMusicPlayer for app-scoped Apple Music playback and update MPNowPlayingInfoCenter with track metadata to publish correct Now Playing info on the Lock Screen and Control Center during track changes.

How do I handle Apple Music subscription checks and authorization before enabling playback?

Request MusicKit access via MusicAuthorization and verify Apple Music entitlement checks before starting playback to ensure the user has an active subscription required for ApplicationMusicPlayer functionality.

Why does my Now Playing info not update when the track changes in my SwiftUI app?

Now Playing info fails to update if MPNowPlayingInfoCenter is not republished with new track metadata during ApplicationMusicPlayer queue changes, requiring explicit metadata updates tied to track change events.

Do I need an Apple Music entitlement to search the Apple Music catalog in my app?

Yes, MusicKit catalog search requires adding the MusicKit capability and NSAppleMusicUsageDescription to your app configuration before querying songs and albums from the Apple Music catalog.

Can I use ApplicationMusicPlayer to insert tracks into the queue without stopping current playback?

Yes, ApplicationMusicPlayer supports queue insertion behaviors including next-item insertion, allowing you to add Apple Music content to the queue while maintaining deterministic in-app playback continuity.