Muzo — Premium Music Client

A powerful, privacy-focused YouTube Music client built with Flutter.
Ad-free · Offline · Lyrics · Gesture-driven · Beautiful

---

Muzo is a feature-rich, privacy-focused YouTube Music client built with Flutter. It offers a premium ad-free experience with background playback, offline downloads, synchronized & karaoke lyrics, and a modern, fully gesture-driven UI — no account required.

---

🚀 Key Features

🎧 Immersive Audio Experience

• Synced & Karaoke Lyrics — Real-time synchronized lyrics that auto-scroll. Karaoke mode highlights individual words/syllables as they're sung.
• Lyrics in Gesture Mode — Frosted-glass lyrics panel above controls in gesture player — double-tap and volume swipe still work through it.
• Lofi Mode — Instantly transform any track into a Lofi vibe with slowed speed (0.9×), pitch correction, and native reverb effects.
• Multi-Language Audio — Automatically detects and lets you switch between available audio languages.
• Background Playback — Keep music playing while using other apps or with screen off.
• Audio Quality Control — Choose between High, Medium, and Low quality.
• Native Audio Effects — Platform-specific audio effects for a rich sound experience.

🕹️ Gesture Player

• Full Gesture Control — Fully immersive gesture-based player where album art fills the entire screen.
• Double-Tap to Play/Pause — Toggle playback anywhere with an animated flash icon.
• Swipe Left/Right — Skip to next or previous track.
• Swipe Down to Close — Swipe down on the left half to dismiss the player.
• Volume Bar — Swipe up/down on the right half to control volume — frosted-glass vertical bar with fill indicator.
• Bottom Controls Popup — Glassmorphic popup with title, artist, progress bar, queue, lyrics, and favorite buttons.

📚 Library & Discovery

• Auto-Queue — Automatically queues recommended songs for endless playback.
• Smart Library — Organize music with Favorites, History, and custom Playlists.
• Channel Subscriptions — Subscribe to favorite artists and YouTube channels.
• Offline Downloads — Download songs and videos for offline listening.
• Smart Search — Quickly find songs, artists, albums, and playlists.
• Recently Played Grid — Compact 2-column grid of recently played tracks on the home screen.

🎨 Modern UI/UX

• Sleek Glassmorphism — Beautiful glassmorphic elements and smooth animations throughout.
• Immersive Player — Dynamic blurred album art background for a premium visual experience.
• Dynamic Theming — UI automatically adapts colors from the currently playing album art.
• Marquee Titles — Auto-scrolling text for long song and artist names.
• Smooth Transitions — Fluid zoom and slide animations between screens.
• Consistent Dark Theme — Optimized contrast and colors for a comfortable dark mode.

🛡️ Privacy & Reliability

• Zero-Wait Launch — App initializes instantly with parallel background loading.
• Ad-Free Streaming — Enjoy music without interruptions.
• Privacy Focused — No login required. All data (favorites, playlists, history) stored locally.
• RapidAPI Fallback — Robust fallback ensures playback reliability if the primary API fails.
• Share to Play — Share links from YouTube or YouTube Music directly into Muzo.

---

📸 Screenshots

---

🛠️ Tech Stack

Layer	Technology
Framework	Flutter + Dart
State Management	Riverpod
Audio Engine	Just Audio & Audio Service
YouTube Extraction	youtube_explode_dart (fork by anandnet)
Music Stream API	JioSaavn API — powered by n-ce/fast-saavn
Lyrics	flutter_lyric + custom karaoke engine
Local Storage	Hive
Networking	Dio & Http
UI Components	FluentUI System Icons, Google Fonts, Cached Network Image
API	Custom YouTube Internal API & RapidAPI (fallback)

---

⚙️ Setup & Installation

Prerequisites

• Flutter SDK (Latest Stable)
• Dart SDK
• Android Studio / VS Code
• Java JDK 17

Installation

1. Clone the repository:

   git clone https://github.com/Shashwat-CODING/Muzo.git
   cd Muzo

2. Install dependencies:

   flutter pub get

3. Run the app:

   flutter run

4. Build release APK (split by ABI for smaller size):

   flutter build apk --split-per-abi

---

🤝 Contributing

Contributions are welcome! Whether it's reporting a bug, suggesting a feature, or writing code, your help is appreciated.

How to Contribute

1. Fork the Project
2. Create your Feature Branch (git checkout -b feature/AmazingFeature)
3. Commit your Changes (git commit -m 'Add some AmazingFeature')
4. Push to the Branch (git push origin feature/AmazingFeature)
5. Open a Pull Request

Development Guidelines

• Follow the existing code style.
• Use flutter analyze to check for linting errors.
• Ensure new features are tested before submitting a PR.

---

🙏 Acknowledgements

Muzo wouldn't exist without the incredible work of these developers and projects. Huge thanks to:

🎬 youtube_explode_dart

A massive thank you to Hexer10, the original author of youtube_explode_dart — the backbone of Muzo's YouTube streaming and metadata extraction. Also special thanks to anandnet for maintaining an up-to-date fork that keeps Muzo working with the latest YouTube changes.

🎵 Animesh (n-ce) — fast-saavn & ytify

An enormous shoutout to Animesh (n-ce) — creator of:

• fast-saavn — the blazing-fast, open JioSaavn API that powers Muzo's music streaming to make app even faster and more reliable.
• ytify — a beautifully minimal YouTube audio streaming web app that was a huge source of inspiration during Muzo's development. Animesh's approach to UI, UX, and YouTube audio handling influenced many of Muzo's design decisions. Thank you for the open-source spirit and for being so helpful throughout the development journey! 🙌

📦 Open-Source Libraries

Muzo stands on the shoulders of these amazing Flutter/Dart packages:

Package	Author / Maintainers
just_audio	Ryan Heise
audio_service	Ryan Heise
riverpod	Remi Rousselet
hive	Hive Authors
flutter_lyric	lyric contributors
palette_generator	Flutter Team
cached_network_image	Baseflow
dio	cfug
flutter_animate	gskinner

---

📝 License

Distributed under the MIT License. See LICENSE for more information.

---

Built with
By Shashwat