How suryanandanbabbar/scout works
Project type and purpose
• This is an on-device, real-time audio analysis iOS application (“Scout”) built in Swift/SwiftUI with a small DSP engine (YIN tracker, chromagram, chord templates) that listens on the microphone, estimates notes and chords, and renders a UI (keyboard animation, audio visualizer, labels).
File structure
• Top-level folders:
• Models (DetectedNote.swift, DetectedChord.swift)
• Services (AudioManager.swift, ChordDetector.swift)
• Utils (DSP.swift, Smoother.swift)
• Views (SplashScreenView.swift, ContentView.swift, PianoKeyboardView.swift)
• ScoutApp.swift (app entry point)
• Info.plist (iOS permissions + config)
• Patterns & Indicators:
• Clear MVC/MVVM-style separation: Services = “business logic,” Utils = DSP helpers, Models = data carriers, Views = SwiftUI.
• Uses AVFoundation/AudioEngine (in AudioManager), Apple Accelerate/vDSP (in DSP.swift).
• No external servers—fully on-device.
README
• Confirms architecture:
• Models for notes/chords
• Services for audio capture and DSP
• Utils for smoothing and DSP config
• Views for UI screens
• Mentions tech: SwiftUI, vDSP, simple YIN algorithm, chroma/template matching.
Detail
• Every class/file as its own component if it has non-trivial logic (e.g., Smoother, ChordDetector)
• Interactions (e.g., “AudioManager installs AVAudioEngine tap at 44.1 kHz”)