How losses/rune works
Main System Components
a) Frontend Layer (Flutter UI)
• Main UI components from the /lib directory
• Features: Player Interface, Library Management, Analysis View
• Responsive design system that handles different platforms
b) Native Bridge Layer
• Native/hub component that bridges Flutter and Rust
• Message passing system (using the protocol definitions in /messages)
c) Core Backend Layer (Rust)
• Database Management (/database)
• Audio Analysis Engine (/analysis)
• Playback System (/playback)
• Metadata Management (/metadata)
• Scrobbling Service (/scrobbling)
Key Interactions to Highlight
• Audio file processing path: Metadata → Analysis → Database
• Playback path: Database → Playback Engine → UI
• Analysis flow: Audio Input → FFT Analysis → Feature Extraction
• Mix generation: Database → Analysis Engine → Recommendation System
Specific Component Details
Database Layer:
• Tables structure from /migration
• Relationships between media files, metadata, and analysis results
Analysis Engine:
• CPU/GPU analyzers from /analysis/src/analyzer
• FFT processing pipeline
• WGPU acceleration system
Playback System:
• Controller/player architecture
• Real-time FFT visualization pipeline
• Platform-specific output handlers
Cross-Platform Architecture
• Platform-specific implementations (Windows, macOS, Linux, iOS, Android)
• Shared core components
• Platform-specific bridges