VIVI Music DE

More Than Just Music — Your Ultimate Audio Experience, on Desktop

Windows · Linux · macOS — the desktop edition of VIVI Music,
synced with your phone.

---

🎵 About VIVI Music DE

✨ VIVI Music DE is the native desktop edition of VIVI Music — a premium, modern music player built for Windows, Linux and macOS. It keeps the exact Material 3 design of the mobile app and adapts it to the desktop with a collapsible sidebar, a full player, synced lyrics, and an Apple Music–style mini-player. Platform testing note: the lead developer (@PiBOH) can currently test DE only on Windows. Therefore Windows has naturally received the most compatibility testing and platform-specific attention; Linux and macOS builds are produced by CI and may need additional community testing. Its defining feature is cross-device sync: pair it with the VIVI Music app on your phone and your playback, seek position, settings and library follow you from one device to the other — instantly, over the same Wi-Fi or a cloud relay. 🎵 Your music, your aesthetic — on every screen you own.

🛡️ 100% Privacy-First Completely local data. Zero trackers, analytics, or background telemetry. 🔄 Cross-Device Sync Instant playback & seek sync with the Android app, over LAN or relay. 🚀 Self-Contained Playback High-fidelity, ad-free streaming from YouTube Music with no external player.

---

💻 Platforms & Downloads

🪟 Windows 10+ Inno Setup installer (.exe) and .msi installs to C:\Program Files\VIVIMusic

🐧 Linux .deb (Debian/Ubuntu) and portable .AppImage

🍎 macOS 10.15+ .dmg and .pkg (Intel)

Grab the latest installer for your system from the Releases page.

---

✨ Features

🎨 Expressive UI & Design Dynamic Material 3: adaptive colors that match your album art, with light, dark and pure-black themes plus selectable accent colors. Pixel-perfect port: the same screens as the mobile app, re-laid-out for a resizable desktop window and a collapsible sidebar. 45+ languages: English-first, with a full language picker.	🔄 Cross-Device Sync Instant playback sync: start, pause or seek on one device and the other follows to the exact second. Settings & library sync: theme, language, accent, liked songs and bookmarks stay in sync. LAN or cloud: pair over the same Wi-Fi (QR + 6-digit code) or a relay server.
🎵 Advanced Streaming Full catalog: stream any song from YouTube and YT Music, completely ad-free. Self-contained playback: built-in AAC decoder — no external player or codec required. Animated canvas: Apple Music–style animated backdrops behind the artwork.	📝 Synced Lyrics & Player Karaoke syncing: line-by-line highlighted lyrics that follow the song. Full player + mini-player: seek, volume, shuffle, repeat, queue with drag-to-reorder, and a compact always-on mini-player.
📥 In-App Updates Automatic checks: on startup, on opening Updates, and at a configurable interval. Smart downloads: the right installer for your OS, with download progress % and speed. Pre-release opt-in: choose to receive beta / RC / nightly builds.	🛡️ 100% Privacy Zero data collection: no trackers, no telemetry, no analytics. Local everything: your library, preferences, cache and login cookie stay on your device.

---

🔗 Pairing with your phone

VIVI Music DE syncs with the VIVI Music Android app:

1. On the desktop, open Settings → Device sync and tap Start LAN server (same Wi-Fi), or connect to a relay server.
2. A 6-digit code is generated automatically, next to a QR code.
3. On your phone, open Settings → Devices, scan the QR code (or enter the relay address) and type the 6-digit code.
4. Done — playback, seek position, settings and library now sync both ways.

---

🛠️ Building from source

Requirements: JDK 21.

# Run the app
./gradlew :desktop:run

# Build the native installer for your current OS
./gradlew :desktop:createDistributable

# Platform-specific packages (Windows / Linux / macOS)
./gradlew :desktop:packageMsi
./gradlew :desktop:packageDeb
./gradlew :desktop:packageDmg
./gradlew :desktop:packagePkg

The desktop module reuses the same pure-JVM network modules as the Android app (innerTube, Spotify, Last.fm, Kizzy, ShazamKit, JioSaavn, lyrics) on top of Compose Multiplatform.

---

🤝 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

⚠️ Testing note: the lead developer (@PiBOH) can only test VIVI Music DE on Windows, as he does not own a Mac or a Linux machine. The Linux and macOS builds are produced by CI and rely on community testing — bug reports for those platforms are especially appreciated.

---

🛡️ Privacy & Data Collection

At VIVI Music DE, your privacy is our top priority. Your music and data belong exclusively to you.

• Zero data collection: we do not collect, store, or share your personal information, usage habits, or listening history.
• 100% local: all settings, cached audio, and the optional login cookie are stored on your device.
• No tracking: no hidden trackers, analytics, or background services monitor your activity.

---

📜 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 DE is an independent project created for educational and personal use purposes.

---

📄 License

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

---

💬 Community & Support Connect with other music lovers, suggest new features, report bugs, and stay updated with the latest releases! 🐞 Report Bugs  •  💬 Discussions  •  🚀 Releases

---

🙏 Special Thanks & Credits

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

💡 Special Thanks vivizzz007 – the original Android app that VIVI Music DE ports to the desktop. @PiBOH – for having created and maintaining VIVI Music DE. Mostafa Alagamy – inspiration and contributions to the open source community. @Zemer – for inventing the new playback method! 🎉

🎖️ Foundational Projects Better Lyrics – synced lyrics and YouTube Music integration. SimpMusic – lyrics functionality and integration logic. Monochrome – the premium Apple Music-style visualizer canvas.

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 DE!