ios-background-audio

Configure Dioxus iOS for background audio and Dynamic Island Live Activity.

161|2|Updated May 7, 2026
One-click install
npx skills add https://github.com/mirkobozzetto/flowflow --skill ios-background-audio
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: ios-background-audio
Source: https://github.com/mirkobozzetto/flowflow/tree/main/.claude/skills/ios-background-audio
Command: npx skills add https://github.com/mirkobozzetto/flowflow --skill ios-background-audio

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires grep, head, dx, and includes references (resource) and scripts (resource) components.

What problem does it solve?

Prevents iOS from stopping voice recording when the app goes to background, ensures recordings automatically pause and resume on phone calls and FaceTime interruptions, and surfaces the live recording timer in the Dynamic Island.

Core Features & Use Cases

  • Enable background audio recording: Adds the correct Dioxus iOS configuration so the audio session stays alive reliably in background.
  • Handle AVAudioSession interruptions: Observes interruption notifications and updates the recorder and UI state so playback/interruption events don’t silently lose recordings.
  • Upgrade Dioxus to unlock widget extensions: Moves FlowFlow to Dioxus 0.7.9 so the Widget Extension pipeline required for Live Activities works.
  • Implement Dynamic Island Live Activity: Starts/updates/ends an ActivityKit Live Activity so users can see a live recording timer in iOS.

Quick Start

Run ios-background-audio with argument 1 to enable background audio recording.

Frequently Asked Questions about ios-background-audio

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

FAQPage Schema
How do I keep iOS background audio recording running when the app is minimized?

iOS background audio recording requires configuring the correct Dioxus iOS background modes so the AVAudioSession stays alive reliably when the app moves to the background. This Skill applies that configuration to prevent iOS from stopping voice recording.

How do I handle AVAudioSession interruptions to auto-resume recording after a phone call?

AVAudioSession interruption handling involves observing interruption notifications to update the recorder and UI state so events like phone calls or FaceTime do not silently lose recordings. This Skill implements automatic pause and resume behavior for those interruptions.

Can I show a live recording timer in the Dynamic Island using Dioxus?

Showing a live recording timer in the Dynamic Island requires integrating ActivityKit Live Activities and a Widget Extension. This Skill starts, updates, and ends an ActivityKit Live Activity to surface the recording timer natively in iOS.

Do I need to upgrade Dioxus to enable Widget Extensions for Live Activities?

Yes, you need to upgrade to Dioxus 0.7.9 to unlock the Widget Extension pipeline required for ActivityKit Live Activities. This Skill handles the Dioxus CLI and library upgrade to ensure the Live Activity integration works correctly.

What's the best way to safely activate an audio session for background recording?

The best way to safely activate an audio session for background recording is to enforce prerequisites and run safety checks around audio session activation and build verification. This Skill routes execution via numbered arguments to manage these production steps safely.