Skip to content
IoTSharpPublic

About

An open-source C#/.NET music client, starting with everyday iPhone listening and Bluetooth car audio. Currently in planning.

Resources

Contributing

Stars

0 stars

Watchers

0 watching

Forks

Repository files navigation

Lyrava

简体中文

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.

First delivery

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.

Technical direction

  • .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.MediaPlayer API; 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.

Documentation

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

Development status

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

The 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=false

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

License and provenance

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.

About

An open-source C#/.NET music client, starting with everyday iPhone listening and Bluetooth car audio. Currently in planning.

Resources

Contributing

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages