How farazkayan/soundmesh works
SoundMesh is a local-first Flutter/Android app that turns nearby Android phones into a synchronized speaker system. Its user workflow is to create a room and show a QR code, have participants join, then capture host audio, distribute PCM packets, buffer them on participants, and schedule local playback against a shared timeline. The graph preserves room discovery and timing calibration as distinct stages. Flutter orchestration and synchronization details are mostly unsampled, so those relationships are documented at a high level; dashed edges mark links not verified in the excerpts.
Main entry points: AudioCaptureEngine.kt Audio capture · AudioReceiveEngine.kt Receive buffer · AudioTransportEngine.kt Audio transport · AudioOutputEngine.kt Scheduled output
Components 19
App experience
- Room screens
app/lib/presentation/screens - Room flows
app/lib/application/providers - Flutter entry
app/lib/main.dart - Platform bridge
app/android/app/src/main/kotlin/com/soundmesh/soundmesh/MainActivity.kt
Room coordination
- Room discovery
app/android/app/src/main/kotlin/com/soundmesh/soundmesh/discovery/DiscoveryService.kt - Discovery manager
app/lib/infrastructure/discovery/discovery_manager.dart - Room protocol
app/lib/application/protocol/protocol_message.dart
Audio pipeline
- Audio capture
app/android/app/src/main/kotlin/com/soundmesh/soundmesh/capture/AudioCaptureEngine.kt - Capture service
app/android/app/src/main/kotlin/com/soundmesh/soundmesh/capture/AudioCaptureService.kt - Capture consent
app/android/app/src/main/kotlin/com/soundmesh/soundmesh/capture/MediaProjectionHelper.kt - Audio transport
app/android/app/src/main/kotlin/com/soundmesh/soundmesh/transport/AudioTransportEngine.kt - Audio packet
app/android/app/src/main/kotlin/com/soundmesh/soundmesh/transport/AudioPacket.kt - Receive buffer
app/android/app/src/main/kotlin/com/soundmesh/soundmesh/transport/AudioReceiveEngine.kt - Frame decoder
app/android/app/src/main/kotlin/com/soundmesh/soundmesh/FrameDecoder.kt
Timing and playback
- Clock synchronization
app/lib/application/synchronization - Shared timeline
app/lib/application/providers/timeline_provider.dart - Scheduled output
app/android/app/src/main/kotlin/com/soundmesh/soundmesh/output/AudioOutputEngine.kt
Other components
- Phone user
- Phone speakers
Connections 19
- Phone user → Room screens: uses
README.md - Room screens → Room flows: starts room flow
- Room flows → Discovery manager: joins room
- Discovery manager → Room discovery: discovers nearby
- Phone user → Room discovery: scans QR
README.md - Flutter entry → Platform bridge: bridges native audio
- Platform bridge → Audio capture: starts capture
app/android/app/src/main/kotlin/com/soundmesh/soundmesh/MainActivity.kt - Audio capture → Capture consent: requests consent
app/android/app/src/main/kotlin/com/soundmesh/soundmesh/capture/AudioCaptureEngine.kt - Audio capture → Capture service: starts foreground
app/android/app/src/main/kotlin/com/soundmesh/soundmesh/capture/AudioCaptureEngine.kt - Audio capture → Audio transport: sends PCM frames
README.md - Audio transport → Audio packet: serializes frames
app/android/app/src/main/kotlin/com/soundmesh/soundmesh/transport/AudioTransportEngine.kt - Audio transport → Receive buffer: transmits packets
README.md - Receive buffer → Audio packet: buffers packets
app/android/app/src/main/kotlin/com/soundmesh/soundmesh/transport/AudioReceiveEngine.kt - Receive buffer → Frame decoder: decodes frames
- Receive buffer → Scheduled output: feeds playback
README.md - Room protocol → Clock synchronization: carries timing messages
- Clock synchronization → Shared timeline: calibrates timeline
README.md - Shared timeline → Scheduled output: schedules playback
README.md - Scheduled output → Phone speakers: plays locally
README.md