vivi-music README

The project's README from github.com/vivizzz007/vivi-music. As one markdown file: README.md.

VIVI Music Banner

VIVI Music

More Than Just Music — Your Ultimate Audio Experience

Download Latest Downloads License Support on Ko-fi

🎵 About VIVI

✨ VIVI isn't just another music player — it's a premium, modern audio ecosystem engineered for listeners who demand more. Powered by a responsive design engine that dynamically matches your album art's color palette, VIVI completely shifts to match your aesthetic on every single beat.

From stunning animated canvas visualizers to fluid physics-based micro-animations, every interaction is crafted to elevate your listening. Stream ad-free, sync karaoke lyrics, share your sound instantly, and enjoy an elegant interface designed with modern Material 3 guidelines.

🎵 Your music, your aesthetic — only with VIVI.

🛡️ 100% Privacy-First
Completely local database. Absolutely zero trackers, analytics, or background telemetry.

🎨 Material You Engine
Stunning adaptive interface that dynamically morphs colors based on what's playing.

🚀 Ad-Free Streaming
Seamless background playback with high-fidelity streams from YouTube Music.

📸 Screenshots

Player

Player Screen 1 		Player

Player Screen 2 		Artist Screen

Artist Screen
Album Page

Album Page 		Search Section

Search Section 		Home Page

Home Page
Built-in Updater

Built-in Updater 		Audio Control Section

Audio Control Section

✨ Features

🎨 Expressive UI & Design

  • Dynamic Material You: Beautiful adaptive colors that shift to match your playing album art.
  • Premium Animations: Silky-smooth micro-animations and seamless screen transitions.
  • Modern Architecture: Sleek, modern layouts engineered with Android's latest Material 3 guidelines.

🎵 Advanced Streaming

  • Full Catalog Integration: Stream any song from YouTube and YT Music, completely ad-free.
  • Animated Canvas: Stunning Apple Music-style animated backdrops that bring music to life.
  • Background Playback: High-quality continuous playback with full notification drawer controls.

📝 Synced Lyrics & Audio

  • Karaoke Syncing: Beautiful, precise word-by-word highlighted lyrics.
  • Integrated EQ: High-fidelity audio customization with an in-app Equalizer.

📥 Offline Experience

  • Local Downloads: Download and cache tracks onto your device for offline enjoyment.
  • Smart Storage: Intelligent cache management that optimizes space automatically.

🔄 OTA Updater

  • Seamless Updates: Instant Over-the-Air updates directly inside the app.
  • Direct Delivery: Always stay ahead with instant feature upgrades and patch fixes.

🛡️ 100% Privacy

  • Zero Data Collection: No trackers, no telemetry, and no telemetry analytics.
  • Local Security: All user libraries, preferences, and downloaded tracks are stored locally.

💖 Support the Project

If you love VIVI Music and want to support its maintenance and active development, please consider buying me a coffee! Your support helps keep this premium audio experience completely active, clean, and ad-free.


Support on Ko-fi

🚗 Android Auto Setup

If VIVI Music doesn't appear in Android Auto:

  1. Open Android Auto on your phone
  2. Tap the hamburger menu (three lines) and go to Settings
  3. Scroll to the bottom and tap the version number multiple times to enable Developer Settings
  4. Tap the three dots menu (⋮) at the top-right
  5. Select Developer settings
  6. Enable Unknown sources
  7. Restart Android Auto and connect to your car

🤝 Contributing

Contributions are welcome! Whether it's bug reports, feature requests, or code contributions:

  1. Fork the repository
  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

🛡️ Privacy & Data Collection

At VIVI Music, your privacy is our top priority. We believe that your music and data belong exclusively to you.

Enjoy your music with complete peace of mind, knowing that your privacy is fully protected.

📜 Disclaimer

This project and its contents are not affiliated with, funded, authorized, endorsed by, or in any way associated with YouTube, Google LLC, or any of their affiliates and subsidiaries.

Any trademark, service mark, trade name, or other intellectual property rights used in this project are owned by their respective owners.

VIVI Music is an independent project created for educational and personal use purposes.

📄 License & Guidelines

This project is licensed under the terms specified in the LICENSE (GPL-3.0) file.

If you copy, adapt, or reuse any part of the source code, you must adhere to the guidelines outlined in the rules.md file.

💬 Community & Support

Connect with other music lovers, suggest new features, report bugs, and stay updated with the latest releases!


Join Telegram

🐞 Report Bugs  •  💬 Discussions  •  🚀 Releases

🙏 Special Thanks & Credits

VIVI Music is built upon the foundation of amazing open-source projects and developers:


💡 Special Thanks
  • Mostafa Alagamy – For their inspiration and contributions to the open source community.
  • @Zemer – Huge congratulations and thanks for inventing the new playback method! 🎉
 🎖️ Foundational Projects
  • AM-Lyrics – For the powerful synced TTML lyrics integration from Binimum.
  • Better Lyrics – For beautiful synced lyrics and YouTube Music integration.
  • YouLyPlus – For smooth in-app lyrics styling.
  • Unison – For the premium Apple Music-style visualizer canvas.
  • SponsorBlock – For automatic skipping of sponsored and non-music segments.

The open-source community for tools, libraries, and APIs that make this project possible.

Thank you to all the amazing developers who made this project possible!

Made with ❤️ for music lovers everywhere

⭐ Star this repo if you enjoy VIVI Music!

vivi-music (vivizzz007/vivi-music)

Searching Database…

3.7K ·GitHub
Vivi-music
What is this?Vivi Music is an Android app that streams music from YouTube Music with a Material 3 'Material You' interface, offline downloads, synced lyrics, and a fully local, tracker-free design.
Is this a native Android app or some kind of web wrapper?It is a native Kotlin/Jetpack Compose Android app built around Material 3 design guidelines, not a browser-based client.
Does it show up automatically in Android Auto?Not always — if it doesn't appear, you need to manually enable Developer Settings in Android Auto and turn on 'Unknown sources' before restarting Android Auto.
Does the app track my listening habits or send data anywhere?No — it uses a completely local database with zero trackers, analytics, or background telemetry, and all libraries and downloads stay on your device.
Does it support synced lyrics?Yes, it has karaoke-style synced lyrics with precise word-by-word highlighting as the song plays.
Can I listen offline?Yes, you can download and cache tracks locally, and the app uses smart storage management to optimize space automatically.
How does the app stay updated without the Play Store?It includes a built-in OTA updater that delivers new features and patch fixes directly inside the app.
What makes the UI different from a typical music app?Its Material You engine dynamically shifts the interface's colors to match the currently playing album art, paired with animated canvas visualizers and physics-based micro-animations.
What are similar projects?Metrolist, LastWave-Native, Levyra-deepsound, YumaPlayer, Echo-Music, Shizuku-Next, ArchiveTune, BitChord
Which topics is it in?karaoke, ytmusic, lyrics, material-you, kotlin-android, material3, jetpack-compose, download, music-player, gpl, material-design, youtube
Creator
vivizzz007
Size
224 MB
Stars
3.7K
Updated
CommitOct 15Releasev6.0.8Sep 25
Age
1y
Commits · 90 Days