vyon

Music, on your terms.

Discover more. Download more. Listen your way.

A music player powered by YouTube Music, built for Android, desktop, TV, and beyond.

🌐 vyon project  ·  ⬇️ Get vyon  ·  🌙 Nightly builds  ·  🎵 Features  ·  🧩 How it's built  ·  💬 Feedback

---

Download your music

Save individual songs for offline listening.

Choose an individual track and use its Download action. Available sources and controls vary by platform.

Downloads that you control

• Download manager — see what's queued, follow transfer progress, and cancel or retry downloads.
• Quality options — choose your preferred download quality, including lossless when a compatible source supplies it.
• Offline listening — play songs already saved on your device without fetching them again.
• Artwork and metadata — save track information and cover art where the source and file format support them.
• Network preferences — Android offers Wi-Fi-only downloading and optional export of supported downloaded files.

---

Discover, collect, play

Feature	Experience
🔎 Search & discovery	Find tracks, artists, albums, and playlists through the music catalog.
❤️ Your library	Keep favorite tracks and music collections within reach.
📝 Playlist controls	Create and manage playlists, queue songs, and reorder your own playlists where supported.
🔀 Queues & autoplay	Play next, shuffle, reorder listening, and keep music going with autoplay.
📺 Music & video	Switch between music listening and available video playback experiences.
📁 Local music	Play music stored on your device; Android also includes SMB and WebDAV music-source integrations.

Sound, your way

The player is as much about how music sounds as what you listen to.

• 🎚️ Equalizer & presets — tune playback to your preferences.
• 🌊 Crossfade — ease the transition between tracks.
• ✨ Automix — smart transition planning informed by track analysis.
• 🔊 Audio-quality controls — select streaming quality, with separate Wi-Fi and mobile-data preferences on Android.
• 💎 High-quality sources — support for compatible lossless formats and Dolby Atmos audio paths when the source, device, and decoder allow it.

These audio capabilities vary by platform, format, and connected music source. Lossless or Atmos playback is not guaranteed for every song.

Lyrics, artwork & atmosphere

• 🎤 Synced lyrics — follow lyrics while music plays, with line- and word-level timing when available.
• 🌍 Lyrics translation — read translations in supported languages when available.
• ⏱️ Lyrics timing controls — adjust synchronization offsets to match playback.
• 🖼️ Animated cover art — motion artwork and Canvas-style visuals for supported releases.
• 🎨 Reactive player — immersive playback screens with album art and Canvas visuals.
• 🫧 Distinct UI — monochrome app chrome, vector icons, and custom layouts across desktop, phone, and TV.

---

Better together

Listening doesn't have to be a solo experience.

Integration	What it brings
👥 Listen Together	Shared rooms with synchronized playback state, queue changes, and host/listener controls when connected to a compatible server.
🎮 Discord presence	Show what you're listening to with supported Discord Rich Presence integration.
📊 Listening statistics	Explore listening history and insights tracked by the app.
🎧 Last.fm / ListenBrainz	Scrobble listening activity through supported account integrations.

Listen Together coordinates playback; it does not host or redistribute audio. Each participant needs access to playable music through their own source.

Add-ons and companion services

vyon's opt-in Internet Archive FLAC source and the separate hostable services are documented in Add-ons and services. These components stay separate from the Android app unless the documentation says they are built in.

---

Repository map

The repository keeps platform applications, shared code, services, and the site in purpose-based top-level folders:

android/    Phone, Android TV, and Wear OS apps
core/       Shared Kotlin modules, VyonEx, assets, and Listen Together Worker
desktop/    Windows, Linux, and macOS app and packaging
services/   Discord bot, Listen Together server, library service, and add-ons
website/    Static vyon project site

• Android apps · Shared core · Desktop app
• Services and add-ons · Website · Architecture and development docs
• VyonEx JVM adapter · VyonEx multiplatform library · Cloudflare Listen Together Worker
• VyonBot · Go Listen Together server · Self-hosted library add-on
• Telegram music add-on · Browser extension
• Maintained contributor list

gradle/ and the root Gradle files define the build; scripts/ contains repository tooling; .github/ contains CI and release workflows. Required root legal and contributor files remain alongside them.

---

Made for every screen

Platform	Experience
Windows, macOS & Linux	Desktop music player with its own interface, downloads, audio controls, and integrations.
Android phones & tablets	Touch-first player with downloads, music library, customizable playback, and device integrations.
Android TV	Living-room interface designed for a bigger screen and remote-control navigation.
Wear OS	Companion experience paired with the Android app.

iOS and iPadOS are not supported. Some features and downloadable builds may be available on only certain platforms.

---

How vyon is built

One Kotlin Multiplatform codebase, with a native interface for each kind of screen.

Part	What it is	Where
Shared core	Kotlin Multiplatform logic and UI shared by every app: music sources, playback state, lyrics, updates	core/shared, core/ui
Android	Phone and tablet app, Android TV app, and Wear OS companion	android/app, android/tv, android/wearos
Desktop	Compose Multiplatform app packaged for Windows, macOS, and Linux	desktop/app, desktop/ui
Extraction	The VyonEx Kotlin Multiplatform library, included as source	core/vyonex-library

Toolchain: JDK 27 for the Gradle daemon and Java toolchains, Gradle 9.8.2, Kotlin 2.4.21, Android Gradle Plugin 9.4.1, Compose Multiplatform 1.12.2. Android apps compile against API 37.2 and target API 37.

Dependencies: main uses stable releases only. Prereleases (alpha, beta, RC) are used only by nightly builds, on a throwaway branch that never lands on main.

---

Get vyon

Ready to listen? Every official build is published on GitHub Releases.

FOSS or GMS?

Android builds come in two editions. Both are free and open source, and the music features are the same:

• FOSS uses no Google Play services at all. Choose it for de-Googled phones (for example GrapheneOS, LineageOS without GApps) or if you simply prefer it.
• GMS adds the features that need Google Play services: Google Cast on phone and TV, and Wear OS pairing on the phone.

Which file do I need?

Device	FOSS	GMS
Android phone or tablet (64-bit ARM)	vyon-android-foss-arm64-<version>.apk	vyon-android-gms-arm64-<version>.apk (Cast, Wear OS pairing)
Android phone or tablet (32-bit ARM)	vyon-android-foss-arm32-<version>.apk	vyon-android-gms-arm32-<version>.apk
Android x86_64 emulator/device	vyon-android-foss-x86_64-<version>.apk	vyon-android-gms-x86_64-<version>.apk
Universal fallback (ARM64 + x86_64)	vyon-android-foss-<version>.apk	vyon-android-gms-<version>.apk
Android TV	vyon-tv-foss-<version>.apk	vyon-tv-gms-<version>.apk (Cast)
Wear OS	—	vyon-wearos-<version>.apk, a companion that pairs with the GMS phone app
Windows	vyon-<version>-windows-x64-setup.exe or vyon-<version>-windows-x64.msi	—
macOS	vyon-<version>-macos-arm64.dmg (Apple silicon) or -macos-x64.dmg (Intel); .pkg too	—
Linux	vyon-<version>-linux-amd64.deb or vyon-<version>-linux-x86_64.rpm	—

Desktop builds never use Google services, so every Windows, macOS, and Linux build is FOSS. Wear OS has only a GMS edition: the watch app talks to your phone through Google's Wearable Data Layer, which needs Google Play services on both devices.

Nightly builds

Want the newest fixes first? Nightly builds are vyon's beta channel.

• What they are: built every day from main with the newest NewPipe Extractor and InnerTubeX releases (the YouTube parts that break most often) and the newest prerelease of every other library.
• When there is one: only when something changed since the last nightly, so there are no empty updates.
• Where to get them: GitHub prereleases tagged nightly, named like v1.0.1-nightly.57, with the same files as a stable release.
• Automatic updates: on your phone, open Settings → Software Update and turn on Beta Updates; on TV and desktop, open Settings → Software updates and turn on Nightly builds. With it off, which is the default, vyon only offers stable releases.

Nightly builds can be unstable. Use a stable release for everyday listening, and report problems in GitHub Issues with the nightly version number.

vyon's website only links directly to installers it can verify in published GitHub releases. If no build is published for your platform yet, check the Releases page for updates.

GitHub badges display live repository statistics. The download counter measures GitHub Release asset downloads, not active users, website visits, or installed copies. A repository without published release assets may show zero or an unavailable value.

---

Questions?

---

License & credits

vyon is open source under the GNU General Public License v3.0. Bundled third-party components retain their respective licenses.

Contributors

See CONTRIBUTORS.md for the manually maintained contributor list.

1. @bxane — project owner and lead contributor.

The reusable extraction library is maintained separately as VyonEx. vyon consumes its Kotlin Multiplatform source at 0118885cdf00a609b585f8fb5fd5110265c98c93; the earlier exported subtree revision remains in VyonEx history.

Build, architecture, installation, and release guidance is in the project documentation. See third-party notices for source-level attribution.

Disclaimer: vyon is an independent music player and is not affiliated with, endorsed by, or sponsored by Google or YouTube. YouTube and YouTube Music are trademarks of their respective owners.

Like vyon? A star helps more people discover it.

Made with ♥ by bxane · vyon on GitHub