An open-source music client built with C# and .NET, starting with reliable everyday listening on Windows desktop. The iPhone and Bluetooth car experience follows as a later platform track.
Status: Windows-only M0 baseline complete. The repository contains a shared C# playback-state core, a bounded music-source probe, and a Windows MAUI playback slice. The current M0 boundary is the Windows implementation and engineering baseline; Android and iPhone are later platform tracks. There is no packaged Windows release or signed IPA, and the remaining source, package, runtime and daily-use gates stay attached to M1/OPS.
The first usable release, planned as v0.1, targets Windows desktop: music discovery, local playlists and favorites, a persistent playback queue, background/window-lifecycle playback, Windows system media controls, interruption handling, and recovery from network changes. The initial desktop slice is unpackaged; MSIX packaging and daily-use acceptance remain separate gates.
The full roadmap retains the later iPhone and Bluetooth car experience, account synchronization, offline downloads, synchronized lyrics, Android, macOS, advanced audio, recognition, social listening, and external integrations. CarPlay and platform-specific widgets have separate feasibility gates.
- .NET 10 and .NET MAUI; application UI, business logic, and platform adapters authored in C#.
- Shared playback state and queue; platform-owned audio engines and media sessions.
- Windows playback through the C#
Windows.Media.Playback.MediaPlayerAPI; iOS playback remains a later C# binding target for AVFoundation and MediaPlayer. - A replaceable music-source adapter; YouTube/InnerTube compatibility is a separate technical risk.
- Local SQLite metadata, bounded media caching, and operating-system secure storage for credentials.
- No mandatory server in the initial architecture. A resolver service or non-C# runtime requires an explicit architecture decision before adoption.
MAUI's support lifecycle is separate from .NET's lifecycle. The current .NET MAUI 10 support deadline is 2027-05-11; SDK maintenance is included in the roadmap.
| Document | Purpose |
|---|---|
| Roadmap | Milestones, delivery IDs, dependencies, acceptance and status |
| Feature coverage | Mapping from the assessed Metrolist scope to planned deliveries |
| Architecture | Shared C# code, native platform boundaries, source and storage design |
| Quality gates | Source, build, signing, device, car and daily-use evidence |
| M0 evidence and readiness | Current results, environment gaps, dependency inventory and the M1 gate |
| Windows validation | Windows MAUI build, media probe and package/runtime boundaries |
| iOS validation | Later iOS media probe, Mac build instructions and device/car scenarios |
| Source feasibility | Anonymous C# source experiments and unresolved playback requirements |
| Architecture decision | Language, platform, distribution and license decisions |
| Contribution guide | How to propose and deliver changes |
| Handoff | Current state and the next implementation steps |
| Changelog | Actual changes only |
The exact SDK is pinned in global.json. Lyrava.slnx contains the portable core, source adapter, command-line source probe and contract tests. Lyrava.App.slnx contains the Windows MAUI slice and the later iOS probe; platform builds are separate from portable checks.
Run the same bounded checks as the portable CI with PowerShell 7 or later:
pwsh -NoProfile -File ./eng/verify.ps1The script runs restore, a Release build, format verification and tests. Each step has a deadline, and the script stops on failure. See quality gates for the exact commands and the separate platform checks.
The source probe reads public source data and reports counts, supported format and failure categories. It keeps temporary media addresses out of console output. A successful fixture or search request does not establish playable music, native seek or background playback; see source feasibility.
Build the first Windows slice with the installed MAUI Windows workload:
dotnet restore ./Lyrava.App.slnx --disable-parallel --disable-build-servers
dotnet build ./src/Lyrava.App/Lyrava.App.csproj -f net10.0-windows10.0.19041.0 -c Release --no-restore --disable-build-servers -m:1 -nodeReuse:false -p:UseSharedCompilation=falseThis produces an unpackaged Windows build. Windows-only M0 treats this implementation baseline as complete; MSIX packaging, system media-control behavior, long-running playback, source-site availability and daily-use acceptance remain M1/OPS evidence. Later iOS builds and signing still require a compatible Mac/Xcode environment, registered devices and valid signing assets.
Lyrava is licensed under GPL-3.0-only; see LICENSE. Metrolist and InnerTubeX are technical references. The M0 code is newly authored and does not import their implementation code. Any later code reuse must preserve its original notices and compatible license terms; see NOTICE and the dependency inventory.
Lyrava is an independent project and is not affiliated with YouTube or Google.