A Kotlin Multiplatform audio recording library for Android and iOS.

• KMP-first — single API for Android and iOS
• Configurable — sample rate, channels, encoding (AAC/PCM/AMR/Opus), output format
• Reactive — StateFlow<RecorderState> with amplitude, duration, status
• Waveform-ready — amplitude normalized to 0.0–1.0 at ~20fps for visualization
• Optional UI — ready-made RecorderView + standalone WaveformView, or bring your own
• Lifecycle-safe — pause/resume/stop/release

KRecorder/
├── krecorder-core/   ← Recording engine. No UI dependency.
├── krecorder-ui/     ← Optional Compose Multiplatform UI.
└── sample/           ← Demo app showcasing all features.

The sample module demonstrates all library features:

• Config pickers — tap chips to change sample rate, channels, encoding, and format live
• Live recording — waveform visualization, timer with red recording indicator
• Pause/Resume/Stop — full lifecycle control
• Dark theme — Material3 dark color scheme

# Android
./gradlew :sample:installDebug

# iOS (via Xcode)
open iosApp/iosApp.xcodeproj

val recorder = KRecorder.create(
    config = RecorderConfig(
        sampleRate = SampleRate.RATE_44100,
        channels = Channels.MONO,
        encoding = AudioEncoding.AAC,
        format = OutputFormat.MP4,
    )
)

// Observe state reactively
recorder.state.collect { state ->
    println("${state.formattedDuration} | Amplitude: ${state.amplitude}")
}

recorder.start()
recorder.pause()
recorder.resume()
recorder.stop()     // file at state.value.outputPath
recorder.release()  // free resources

val recorder = remember { KRecorder.create() }

RecorderView(
    recorder = recorder,
    onRecordingSaved = { filePath -> },
)

WaveformView(
    amplitudes = amplitudes,   // List<Float> of 0.0–1.0 values
    barColor = Color.White,
    barWidth = 3.dp,
    barSpacing = 2.dp,
    height = 200.dp,
)

StateFlow<RecorderState> fields:

<uses-permission android:name="android.permission.RECORD_AUDIO" />

<key>NSMicrophoneUsageDescription</key>
<string>This app needs microphone access to record audio.</string>

┌─────────────────────────────────────────┐
│              Your App                    │
│  ┌────────────┐  ┌───────────────────┐  │
│  │krecorder-ui│  │ Your custom UI    │  │
│  │RecorderView│  │ WaveformView      │  │
│  └─────┬──────┘  └────────┬──────────┘  │
│        └────────┬─────────┘             │
│        ┌────────┴─────────┐             │
│        │  krecorder-core  │             │
│        │ KRecorder + Flow │             │
│        ├────────┬─────────┤             │
│        │Android │   iOS   │             │
│        │MediaRec│AVAudioRec             │
│        └────────┴─────────┘             │
└─────────────────────────────────────────┘

• Kotlin 2.3.20 / Compose Multiplatform 1.10.3
• Kotlinx Coroutines 1.10.2 / Gradle 8.14.3
• Android: MediaRecorder / iOS: AVAudioRecorder

Apache 2.0