abdullah4ai/media
swiftship/internal/skills/data/ui/media/SKILL.md
Comprehensive media patterns: video playback, audio/music players, HLS streaming, remote images, AVAudioSession, memory management. Use when implementing any media-related features.
$ install --global
skillsauthnpx skillsauth add abdullah4ai/apple-dev-docs mediaInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
Security Scan Results
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
3
Scanners Passed
9
Scanners in report
Clean
TrivyContainer and dependency vulnerability scanner
95%
Clean
SemgrepStatic code analysis for vulnerabilities
95%
Clean
mcp-scan (Snyk)Model Context Protocol security validation
95%
Skipped
Snyk (dep)Open source security scanning
50%
Skipped
Socket.devSupply chain security analysis
50%
Skipped
VirusTotalMulti-engine malware detection
50%
Skipped
CrowdStrikeAdvanced threat intelligence
50%
Skipped
OSV-ScannerOpen Source Vulnerability database check
50%
Skipped
OWASP Dep-Check
50%
Last scanned: Mar 30, 2026, 5:12 AM36.7s7 files scanned
SKILL.md
- name:
- media
- description:
- Comprehensive media patterns: video playback, audio/music players, HLS streaming, remote images, AVAudioSession, memory management. Use when implementing any media-related features.
- tags:
- avplayer, avkit, video, audio, music, streaming, hls, asyncimage, kingfisher, media
Media
Networking Clarification
Media playback URLs are permitted. The forbidden-patterns networking ban targets REST API clients (URLSession data tasks, custom HTTP clients), not media playback. The following are allowed:
AVPlayerwith remote URLs (MP4, HLS.m3u8streams)AsyncImageloading remote image URLsKFImage(Kingfisher) loading and caching remote imagesURLSession.shared.download(from:)only for downloading media files to local storage
Do not use URLSession for REST API calls, JSON fetching, or custom networking — that ban still applies.
Decision Tree
Pick the right pattern based on what you're building:
| Building | Reference | Key API |
|----------|-----------|---------|
| Video player | video-playback | VideoPlayer, AVPlayer |
| HLS/live streaming | video-playback | AVPlayer + .m3u8 URL |
| Video feed (TikTok-style) | video-playback + media-memory-management | FeedPlayerCoordinator |
| Music/audio player | audio-playback + audio-session | AVAudioPlayer (local) or AVPlayer (streaming) |
| Podcast player | audio-playback + audio-session | AVPlayer + Now Playing + Remote Commands |
| Background audio | audio-session | .playback category + UIBackgroundModes |
| Image gallery/feed | remote-images | KFImage (Kingfisher) |
| Simple remote image | remote-images | AsyncImage |
| Sound effects | audio-playback | AVAudioPlayer with .ambient category |
| Sample content | sample-media-urls | Public URLs, local audio generation |
Platform Capabilities
| Feature | iOS | macOS | tvOS | watchOS | visionOS | |---------|-----|-------|------|---------|----------| | Video playback | VideoPlayer | AVPlayerView (NSViewRepresentable) | VideoPlayer | No | VideoPlayer | | Audio playback | AVAudioPlayer / AVPlayer | AVAudioPlayer / AVPlayer | AVAudioPlayer / AVPlayer | WKAudioFilePlayer | AVAudioPlayer / AVPlayer | | AVAudioSession | Yes | No (not needed) | Yes | Limited | Yes | | Background audio | Yes (UIBackgroundModes) | N/A | No | Limited | Yes | | Now Playing info | Yes | Yes | Limited | No | Yes | | Remote commands | Yes | Yes | Limited | No | Yes | | AsyncImage | Yes | Yes | Yes | Yes | Yes | | Kingfisher | Yes | Yes | Yes | No | Yes |
Recommended Packages
All already in the curated package registry — no new dependencies to add:
- Kingfisher — remote image loading with disk/memory caching, prefetch, placeholder, fade. Use for image feeds and galleries (20+ images).
- DSWaveformImage — audio waveform visualization. Use for voice memo or audio editing UIs.
- AudioKit — advanced audio synthesis and processing. Only use when the user specifically needs audio effects, synthesis, or real-time audio processing.
Required Info.plist Keys
For background audio playback, add to the target's info section in project.yml:
UIBackgroundModes: ["audio"]
No other Info.plist keys are needed for basic media playback.
Cross-References
- PhotosPicker — see the
cameraskill (not duplicated here) - Camera access — see the
cameraskill - MapKit / CoreLocation — see the
mapsskill (not duplicated here) - Image containment / clip patterns — see the
swiftuiskill - Haptic feedback on media controls — see the
hapticsskill
References
This skill includes the following reference documents (auto-loaded):
- video-playback — VideoPlayer, HLS streaming, custom controls, feed-style video, looping
- audio-playback — AVAudioPlayer (local), AVPlayer (streaming), Now Playing, remote commands, playlists
- audio-session — AVAudioSession categories, interruption handling, route changes, background audio
- remote-images — AsyncImage vs Kingfisher decision, image grids, feeds, prefetch, cache config
- sample-media-urls — Public video/HLS/image URLs and local audio generation with
say - media-memory-management — Player lifecycle, observer cleanup, KVO, feed coordinator, debug checklist
Related Skills
abdullah4ai/apple-developer-toolkit
tools
VerifiedTrustedCommunity
Apple platform skill for docs, WWDC lookup, App Store Connect work, and SwiftUI app generation. Use repo-local `node cli.js` for Apple docs and WWDC search, `appledev store` for App Store Connect workflows, and `appledev build` for app scaffolding or fix loops on macOS. USE WHEN: Apple APIs, WWDC sessions, TestFlight/App Store tasks, or building/fixing Apple-platform apps. DON'T USE WHEN: non-Apple platforms, generic backend work, or general web research. EDGE CASES: docs-only queries use `node cli.js` in this repo, not `appledev`; release workflows use `appledev store`; app scaffolding uses `appledev build`; rules-only requests can read `references/ios-rules/` or `references/swiftui-guides/` progressively without invoking binaries.
8SKILL.mdUpdated Mar 27, 2026
abdullah4ai/apple-developer-toolkit
tools
VerifiedTrustedCommunity
All-in-one Apple developer skill with three integrated tools shipped as a single unified binary. (1) Documentation search across Apple frameworks, symbols, and 1,267 WWDC sessions from 2014-2025. No credentials needed. (2) App Store Connect CLI with 120+ commands covering builds (find/wait/upload), TestFlight, pre-submission validate, submissions, signing, subscriptions (family-sharable), IAP, analytics, Xcode Cloud, metadata workflows, release pipeline dashboard, insights, win-back offers, promoted purchases, product pages, nominations, accessibility declarations, pre-orders, pricing filters, localizations update, diff, webhooks with local receiver, workflow automation, and more. Requires App Store Connect API key. (3) Multi-platform app builder (iOS/watchOS/tvOS/iPad/macOS/visionOS) that generates complete Swift/SwiftUI apps from natural language with auto-fix, simulator launch, interactive chat mode, and open-in-Xcode. Requires an LLM API key and Xcode. Includes 38 iOS development rules and 12 SwiftUI best practice guides for Liquid Glass, navigation, state management, and modern APIs. All three tools ship as one binary (appledev). USE WHEN: Apple API docs, App Store Connect management, WWDC lookup, or building iOS/watchOS/tvOS/macOS/visionOS apps from scratch. DON'T USE WHEN: non-Apple platforms or general coding.
7SKILL.mdUpdated Mar 27, 2026
abdullah4ai/widgets
testing
VerifiedTrustedCommunity
watchOS complications: WidgetKit complication families, accessory sizes, timeline providers for watch face. Use when implementing watchOS-specific patterns related to widgets.
5SKILL.mdUpdated Mar 27, 2026
abdullah4ai/haptics
development
VerifiedTrustedCommunity
watchOS haptic feedback: WKInterfaceDevice preset haptic types for wrist-based feedback. Use when implementing watchOS-specific patterns related to haptics.
5SKILL.mdUpdated Mar 27, 2026