Skip to content

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 10.

Latest release Downloads .NET 10 FluentGpu engine MIT License

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

The Microsoft Store listing is in certification — the badge goes live when it clears.

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

Artist pages with live lyrics The official video — docked, mini player, or its own window
Liked Songs with weekly stats and tempo curves Queue, autoplay and Spotify Connect
Playlists that show tempo, key and recommendations Home on Windows 11 — Mica, dynamic accent, tabs

Install

Two ways in, same app:

  • Microsoft Storeapps.microsoft.com/detail/9NJPVWTQPT9H: install and update through the Store (listing currently in certification).
  • 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.Tests xUnit tests (pure logic — never source-text tests)
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, built with .NET 10 and FluentGPU(soon)

Resources

Stars

49 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages