An offline-first music library management tool designed to help users clean, inspect, and organize local MP3/FLAC collections. This application prioritizes performance and features a professional, hardware-inspired aesthetic with a vibrant Walkman orange accent.
- Local Library Scanner: Efficiently indexes local audio files (MP3, FLAC, WAV, OGG, M4A) using the system MediaStore.
- Adaptive UI: Built with Material 3 and Compose Material Adaptive, providing optimized layouts for both phones and tablets.
- Metadata Inspector: Detailed view for inspecting and editing file tags (Title, Artist, Album, etc.) and managing artwork.
- Duplicate Finder: Identifies redundant audio files based on title, duration, and file size similarity.
- Organization Assistant: Suggests optimized folder structures (e.g.,
Artist/Album/Song.mp3) based on metadata. - Offline-First Persistence: Leverages a local Room database for near-instant browsing and searching.
- Language: Kotlin
- UI Framework: Jetpack Compose with Material 3
- Navigation: Jetpack Navigation 3 (State-driven architecture)
- Adaptive Strategy: Compose Material Adaptive (NavigationSuiteScaffold)
- Persistence: Room Database
- Image Loading: Coil (high-performance artwork rendering)
- Concurrency: Kotlin Coroutines & Flow
- Architecture: MVVM (Model-View-ViewModel)
The app features a vibrant, hardware-inspired Dark Theme with a signature Walkman Orange accent color. It strictly follows Material Design 3 guidelines and implements full Edge-to-Edge display for a modern, immersive experience.
- Grant Permissions: Upon first launch, navigate to the Scanner tab and grant storage permissions.
- Scan Library: Tap "Start Scan". The app will index all local music files and display them in the Dashboard and Library tabs.
- Browse: Use the Songs, Albums, and Artists tabs to explore your collection.
- Edit: Tap on any song to open the Metadata Inspector and update its tags.
- Clean Up: Use the Tools tab to find duplicates and see suggestions for organizing your folders.
Developed by SleepyTurtle91