axiom-now-playing

Diagnose and fix Now Playing integration issues in iOS 18+ apps.

Updated Dec 23, 2025
One-click install
npx skills add https://github.com/pradeepmouli/swift-template --skill axiom-now-playing-pradeepmouli
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: axiom-now-playing
Source: https://github.com/pradeepmouli/swift-template/tree/main/.agents/skills/axiom-now-playing
Command: npx skills add https://github.com/pradeepmouli/swift-template --skill axiom-now-playing-pradeepmouli

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Diagnose and fix Now Playing integration issues on iOS 18+ apps, including missing metadata, unresponsive controls, faulty artwork, and out-of-sync playback state.

Core Features & Use Cases

  • Pattern-based diagnostic framework covering AVAudioSession activation, remote command registration, artwork handling, playback state synchronization, and MPNowPlayingSession usage.
  • Supports CarPlay integration and MusicKit scenarios, with end-to-end guidance for first-time and existing implementations.
  • Real-world use: a developer troubleshoots a stuck Now Playing control on lock screen during a backgrounded audio session.

Quick Start

Run the diagnostic workflow to identify misconfigurations and apply the recommended patterns described in this skill.

Frequently Asked Questions about axiom-now-playing

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

FAQPage Schema
Why is Now Playing metadata not showing on the iOS 18 lock screen?

Now Playing metadata fails to appear when the AVAudioSession is not activated with a non-mixable category. You must configure the audio session correctly and update metadata using elapsed time, duration, and playback rate.

How do I fix unresponsive remote commands during a backgrounded audio session?

Unresponsive remote commands occur when handlers are not registered and enabled before playback starts. Ensure your AVAudioSession is active and remote command center handlers are properly configured to resume playback state.

Does CarPlay require a different setup for MPNowPlayingInfoCenter integration?

CarPlay relies on the same MPNowPlayingInfoCenter and remote command patterns as iPhone and iPad. Properly synchronizing your playback state, metadata, and artwork ensures controls function correctly across all CarPlay contexts.

How do I resolve out-of-sync playback state in MusicKit apps?

Out-of-sync playback state in MusicKit apps is resolved by updating MPNowPlayingInfoCenter with accurate elapsed time, duration, and playback rate. Using MPNowPlayingSession helps manage automatic state publishing across devices.

What causes faulty artwork display in Now Playing controls?

Faulty artwork in Now Playing controls is caused by passing improperly formatted or missing image data to MPNowPlayingInfoCenter. Apply the diagnostic artwork handling patterns to ensure correct image rendering on lock screen and CarPlay.

Can I use MPNowPlayingSession to automatically publish Now Playing metadata?

Yes, you can use MPNowPlayingSession to automatically publish Now Playing metadata. It manages the connection between your app's audio session, remote commands, and metadata updates without manual synchronization for iOS 18+ apps.