now-playing

Diagnose Now Playing metadata and playback-state issues in iOS 18+ media apps.

1.1k|81|Updated Nov 30, 2025
One-click install
npx skills add https://github.com/CharlesWiltgen/Axiom --skill now-playing
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: now-playing
Source: https://github.com/CharlesWiltgen/Axiom/tree/main/.claude-plugin/plugins/axiom/skills/now-playing
Command: npx skills add https://github.com/CharlesWiltgen/Axiom --skill now-playing

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Diagnoses Now Playing issues on iOS 18+: missing info, broken remote commands, artwork issues, and state-sync problems.

Core Features & Use Cases

  • Activation order checks for AVAudioSession, command handlers, and nowPlayingInfo publishing.
  • Patterns for ensuring compatibility with CarPlay and MusicKit content.
  • Push-back guidance for complex Now Playing integrations.

Quick Start

Run activation checks and verify Now Playing metadata is published correctly, with working remote commands.

Frequently Asked Questions about now-playing

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

FAQPage Schema
Why is Now Playing info missing from my iOS app's Lock Screen or Control Center?

Now Playing info fails to display when AVAudioSession isn't activated before publishing metadata to MPNowPlayingInfoCenter, or when remote command handlers aren't registered. Verify activation order: configure AVAudioSession first, set up command handlers, then publish nowPlayingInfo to ensure the system receives and displays your metadata correctly.

How do I fix broken remote commands in my iOS media app?

Remote commands fail when handlers aren't registered before MPNowPlayingInfoCenter publishes metadata, or when AVAudioSession activation is incomplete. Register command handlers and configure session settings before publishing now playing info; this ordering ensures the system recognizes and routes remote events to your app handlers.

What causes Now Playing artwork to display incorrectly or flicker on iOS?

Artwork issues stem from incomplete MPNowPlayingInfoCenter configuration or state drift during playback. Validate that artwork is included in your metadata dictionary, session is properly activated, and playback state updates stay synchronized; flickering often indicates repeated or conflicting metadata updates.

How do I ensure Now Playing works correctly with CarPlay on iOS 18+?

CarPlay Now Playing requires proper AVAudioSession activation, correctly configured remote command handlers, and consistent MPNowPlayingInfoCenter publishing. Follow the activation order: session setup, command registration, then metadata publication; this pattern satisfies CarPlay's functional requirements for displaying and controlling playback.

Can I use Now Playing with MusicKit content in my iOS app?

Yes, but MusicKit integration requires careful coordination of AVAudioSession, remote commands, and MPNowPlayingInfoCenter publishing. The Skill covers MusicKit compatibility patterns and validates that your configuration handles both standard and MusicKit playback scenarios reliably.

How do I diagnose why my app's playback state goes out of sync with Now Playing?

State-sync problems occur when metadata updates don't match actual playback or when the activation sequence is incorrect. Run the Skill's validation checks against your AVAudioSession configuration, command handler setup, and nowPlayingInfo publishing cadence to identify and resolve drift.