SuvMusic
SuvMusic
High-Fidelity Music Streaming for Android
SuvMusic is a premium, open-source music streaming application designed for high-resolution audio enthusiasts. Built with Jetpack Compose Multiplatform and a custom C++ Native Audio Engine, it provides an ad-free experience with advanced features bridging the gap between cloud streaming and professional local playback. Now featuring HQ Audio (320 kbps) as the default streaming source.
Comprehensive documentation is available in the docs/ directory:
| Document | Description |
|---|---|
| Project Overview | High-level project introduction and architecture overview |
| Getting Started | Setup and development environment configuration |
| Developer Guidelines | Coding standards and best practices |
Architecture & Design
| Document | Description |
|---|---|
| Application Architecture | Clean Architecture, MVVM, and modular design |
| Modular Architecture Design | Multi-module project structure |
| Dependency Injection with Hilt | DI patterns and module organization |
| Data Flow and State Management | Reactive state handling |
Core Systems
| Document | Description |
|---|---|
| Music Playback System | Media3 ExoPlayer integration and playback architecture |
| Audio Processing Engine | Native C++ audio engine and DSP features |
| Multi-Source Streaming | YouTube, Remote Audio, and local audio integration |
| Lyrics System | Multi-provider lyrics fetching and display |
| Download Management | Background downloads and file management |
Advanced Features
| Document | Description |
|---|---|
| Listen Together | Real-time synchronized listening rooms |
| Personalization & Recommendations | Smart queue and recommendation algorithms |
| Social Features | Discord integration and Last.fm scrobbling |
Technical References
| Document | Description |
|---|---|
| Native Integration | CMake, JNI bridge, and native audio processors |
| Data Management | Database schema, DAOs, and repositories |
| UI/UX System | Theming, navigation, and components |
| Testing Strategy | Unit, integration, and UI testing approaches |
| Performance Optimization | Optimization techniques and benchmarks |
| Security Considerations | Security best practices and data protection |
| Build and Deployment | Build configuration and release process |
Core Features
Audio Engineering & Performance
- Native Audio Engine: High-fidelity playback powered by a custom C++ JNI layer for low-latency digital signal processing.
- High-Quality (HQ) Audio by Default: Stream pristine 320 kbps audio instantly. YouTube Music remains available as a secondary source.
- Spotify-Style Volume Normalization: Intelligent loudness matching ensures consistent perceived volume across all tracks.
- WSOLA Time-Stretching: High-quality pitch and speed adjustments (up to 5x) without digital artifacts or distortion.
- Parametric EQ & Spatial Audio: 10-band ISO standard equalizer and real-time 3D sound positioning with adjustable spatial intensity.
UI & User Experience
- Material 3 Expressive: Dynamic, premium "liquid glass" UI with custom squircle shapes and silky-smooth animations.
- Dynamic Floating Player: Interactive, system-wide overlay for background playback control.
- Gesture Controls: Integrated video player gestures—Double tap to seek, Vertical swipes for volume/brightness, and Pinch-to-zoom for fill/fit modes.
- Synchronized Lyrics: Real-time, word-by-word lyrics integration from multiple providers with sticky headers and blur customization.
Advanced Functionality
- Listen Together 3.0: Real-time synchronized listening rooms powered by a custom ultra-low latency Protobuf-based in-house backend.
- Comprehensive Cloud Backup: Securely back up and restore your entire library, settings, and cache using the high-performance
.suvformat. - Spotify Pro Import: Direct playlist, album, and artist importing from Spotify accounts.
- Music Haptics: Beat-synchronized tactile feedback for immersive listening.
- Smart Asset Management: Batch download capabilities with background service support and persistent caching.
- Persistent Logging & Diagnostics: Integrated file-based logging system with startup log capture and ACRA automated crash reporting.
Showcase
 |
 |
 |
 |
 |
 |
F-Droid Anti-Features
As an open-source project committed to transparency, SuvMusic discloses the following "Anti-Features" for users and F-Droid reviewers:
- Non-Free Network Services: SuvMusic interacts with third-party, non-free network services (including YouTube, KuGou, LrcLib, and SimpMusic) to provide music streaming, metadata extraction (via NewPipe Extractor), and synchronized lyrics. These services are external to the app and governed by their respective terms of service.
- Tracking: The app utilizes ACRA (Application Crash Reports for Android) for automated crash reporting. While ACRA is open-source, it is technically categorized as tracking by F-Droid because it sends diagnostic data (device info, stack traces) to the developer-controlled endpoint to improve app stability.
Technical Specifications
SuvMusic is engineered using modern Android development standards.
- Frontend: 100% Jetpack Compose for a reactive and fluid user interface with optimized list rendering for large datasets (currently migrating to Compose Multiplatform).
- Architecture: Clean Architecture with MVVM, Koin / Hilt Dependency Injection, Room Database, and Kotlin Coroutines.
- Images & Caching: Powered by Coil 3 with aggressive disk/memory caching policies for offline-ready image loading.
- Audio Core: Custom C23 Native Engine via JNI for high-performance DSP (Limiter, Soft Clipping, EQ).
- Networking: Ktor and OkHttp with custom extractors for high-fidelity stream resolution.
- Error Reporting: ACRA (Application Crash Reports for Android) for automated diagnostic collection.
Installation
- Navigate to the Releases page.
- Download the latest stable APK file.
- Install the APK on an Android device (Android 8.0 or higher required).
Acknowledgments
SuvMusic is an independent project featuring original UI/UX and a custom audio engine. The project utilizes specific core logic from the following open-source resources to maintain compatibility:
- NewPipe Extractor: High-performance metadata extraction.
- SimpMusic: Lyrics provider implementation logic.
- kaif-00z: Original concept and architectural logic for the high-performance
.suvnative playlist format.
Developer
Suvojeet Sengupta Senior Android Engineer & Software Architect
View Full Developer Profile & Portfolio
Suvojeet is a specialized Android engineer with a passion for high-performance mobile systems and audio engineering. With extensive experience in Kotlin, Jetpack Compose, and C++ JNI, he focuses on building low-latency applications that push the boundaries of the Android platform.
Expertise & Focus
- Mobile Systems: Advanced Android architecture (Clean Architecture, Multi-module).
- Audio Engineering: Custom DSP, JNI bridges, and native audio processing.
- Open Source: Committed to building transparent, privacy-focused software for the global community.
Connect
License
Copyright © 2026 Suvojeet Sengupta. This project is licensed under the GNU General Public License v3.0. See the LICENSE file for details.
Disclaimer: This application is intended for educational and research purposes. It interacts with third-party services. Please respect intellectual property rights and applicable terms of service.
