Skip to content

Latest commit

 

History

87 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Sumic Banner

🎧 The YouTube Music client you always wanted

🚫 No Ads • 💰 No Subscription • ⚡ Full Control

GitHub Release Stars License


🚀 Overview

Sumic is a fast, offline-first YouTube Music client built for Android. It is fully open-source, features a stunning Material You interface, and supports high-fidelity audio playback, custom theme creation, playlist tagging, and playlist imports from Spotify, YouTube Music, M3U, and CSV formats.


📸 Preview

Screenshot 1 Screenshot 2 Screenshot 3 Screenshot 4
Screenshot 5 Screenshot 6 Screenshot 7 Screenshot 8
Screenshot 9 Screenshot 10

✨ Features

🆕 What's New in v1.1.0

  • 120fps Compose Optimization – A systematic performance pass ensuring butter-smooth scrolling, navigation, and micro-interactions across the entire app.
  • Refined Synced Lyrics – Synced lyrics are now elegantly left-aligned and positioned perfectly between the album art and the progress bar.
  • Library UI Overhaul – "Import Playlist" has been relocated directly into the main Library grid stack (right below the Cached playlist) for much easier access.

🎵 Core Experience

  • Ad-Free Playback – Enjoy uninterrupted music.
  • Full Library Sync – Keep your playlists and library updated.
  • Encrypted Offline Caching – Save music securely for offline listening.
  • Background Playback – Listen while using other apps or with your screen off.

📥 Import & Playlist Management

  • Spotify Playlist Importer – Paste any public Spotify playlist share link to automatically search, match, and import songs into a new local playlist in the background.
  • M3U & CSV Playlist Support – Import playlists directly from standard .m3u and .csv files.
  • YouTube Music Import – Synchronize and import remote YouTube Music playlists to editable local playlists.
  • Playlist Tags & Organization – Group, filter, and organize your music library by tagging playlists with custom names and colors.

🔊 Audio Engine

  • Gapless Playback – Seamless transitions between tracks.
  • Crossfade Engine – Smooth fade-in/fade-out between songs.
  • Silence Skipping – Auto-skip silent segments.
  • Loudness Normalization – Consistent volume using EBU R128 standards.
  • Tempo & Pitch Control – Adjust audio speed and key.
  • System EQ Integration – Work with system equalizers.

🎨 Themes & Customization

  • Material You – Dynamic color themes matching your wallpaper.
  • Theme Creator – Design your own dynamic color palette using seed colors (Primary, Secondary, Tertiary, Neutral) and export/import your themes.
  • Curated Presets – Select from premium color palettes (like Spotify Green).
  • Multiple Player Layouts – Select from Classic, Modern, Minimal, Cinematic, and Metro interfaces.
  • Interactive Visuals – Enable the modern squiggly progress bar and swipe gestures to skip songs.

🎤 Lyrics & Sharing

  • Synced Lyrics V2 – Immersive, word-by-word real-time synced lyrics with translation support, Japanese/Korean romanization, and custom text sizes.
  • Lyrics Sharing – Share lyrics as text or generate premium image cards for social sharing.

🔌 Integrations

  • Discord Rich Presence – Show off what you're listening to on Discord in real-time.
  • Last.fm Scrobbling – Sync your listening history automatically to Last.fm.
  • Update Checker – Receive notifications when a new version of the app is available.

🧠 Architecture

Built using modern Android engineering principles:

  • MVVM + Clean Architecture for clear separation of concerns.
  • Unidirectional Data Flow (UDF) for predictable state management.
  • Modular Design to keep the codebase maintainable and scalable.

🛠 Tech Stack

Layer Stack
Language Kotlin
UI Jetpack Compose + Material 3
Audio Media3 / ExoPlayer
Dependency Injection Hilt
Database Room (Encrypted)
Networking Ktor + Retrofit
Concurrency Coroutines + Flow
Build Tool Gradle KTS


🛠 Getting Started

Requirements

  • IDE: Android Studio Ladybug+
  • JDK: JDK 17
  • SDK: Android SDK 34+

Run Locally

  1. Clone the repository:
    git clone https://github.com/saurabh222007/Sumic.git
    cd Sumic
  2. Open the project in Android Studio.
  3. Sync Gradle and build the project.
  4. Click Run ▶ to deploy to your device.

⚖️ License & Legal

  • Sumic is an independent client and is not affiliated with YouTube or Google.
  • Licensed under the GPL-3.0 License.

👤 Author

someone

Releases

Packages

Contributors

Languages