Skip to content

About

A high-performance Spotify client for Windows — .NET 10 NativeAOT on the FluentGpu engine

Topics

Resources

Contributing

Security policy

Stars

81 stars

Watchers

0 watching

Forks

Repository files navigation

Wavee — Home, rendered by FluentGpu on Windows 11

Wavee

A Spotify desktop client for Windows 11, built on FluentGpu — a from-scratch, NativeAOT, GPU-rendered UI engine for .NET 11.

Latest release Downloads .NET 11 FluentGpu engine MIT License

Download Wavee for x64   Download Wavee for ARM64   Get Wavee from the Microsoft Store

One ~30 MB MSIX, no bundled runtime, Mica, dynamic accent, 10k-row virtualized lists, synced lyrics, video, out-of-process playback modules (YouTube / Twitch / radio).

Wavee is an independent client for your own Spotify Premium account. It is not made by, endorsed by, or affiliated with Spotify AB. Privacy statement: PRIVACY.md.

A quick look

Lyrics that follow every word, beside the player or full screen Three looks in one app: Classic, WinUI and a Zune-inspired theme
Zune album with credits, music videos and the lyrics pane The mini player, in any shape you drag it to
Nineteen visualizers, tinted from the album art Music videos beside the queue, in the mini player or full screen
Artist pages with their best songs, releases and videos Home on Windows 11, in the Classic theme

Install

Two ways in, same app:

  • Microsoft Store — apps.microsoft.com/detail/9NJPVWTQPT9H: install and update through the Store.
  • Direct download — the buttons above; signed MSIX from this repository's releases, silent auto-updates.

Click the button for your architecture (x64 for most PCs, ARM64 for Snapdragon / Surface Pro X-class devices) and open the downloaded .appinstaller — Windows App Installer installs the signed package. Updates are checked in the app (Settings › About) and applied silently by App Installer on launch; the rolling wavee-stable release is what every install polls. Prefer a manual install? Every version's .msix is on its own release, next to its symbols. Release notes: CHANGELOG.md and the What's new page inside the app.

Requires Windows 11 and a Spotify Premium account.

Build

The engine is a sibling checkout, not a package:

git clone https://github.com/christosk92/fluent-gpu C:\wavee\fluent-gpu
git clone https://github.com/christosk92/WaveeMusic C:\wavee\WaveeMusic
cd C:\wavee\WaveeMusic
git config core.hooksPath .githooks
dotnet build Wavee.slnx -c Release
dotnet run --project src/apps/Wavee              # or:  -- --fake  for the offline demo data

Requirements: .NET SDK 10+ (global.json rolls forward), Visual Studio Build Tools with MSVC (NativeAOT link), Windows 11. The Spotify playback derivation (src/apps/Wavee.PlayPlay) lives in a private repository and is junctioned in per checkout — a checkout without it builds the public-only variant.

Repository layout

Path What
src/apps/Wavee the app (composition root, features, backend, platform)
src/apps/Wavee.Core engine-free app logic (release notes, versioning, update policy, notifications)
src/apps/Wavee.Sdk, src/apps/modules/* the playback-module SDK and the first-party modules
src/apps/Wavee.ReleaseTool validates/renders release notes for a release
ops/build, ops/release MSIX packaging, signing, the local release runbook and its E2E harness
docs/guide, docs/plans app guides (releasing, playback modules, sidebar platform) and plans

Releasing: docs/guide/releasing-wavee.md. Agent guidance: CLAUDE.md, AGENTS.md.

License

MIT — see LICENSE. Third-party components: THIRD-PARTY-NOTICES.txt.

About

A high-performance Spotify client for Windows — .NET 10 NativeAOT on the FluentGpu engine

Topics

Resources

Contributing

Security policy

Stars

81 stars

Watchers

0 watching

Forks

Releases

Packages

Used by

Contributors

Languages