A lightweight, audiophile-grade Windows desktop client for Deezer HiFi built with C#, .NET 10 WPF, and WebView2.
C#, .NET 10 WPF ve WebView2 ile geliştirilmiş; odyofil odaklı, hafif ve modern Deezer masaüstü istemcisi.
- Triple Audio Engine Architecture:
- WebView2 Direct: Standard output with per-app audio device routing via
setSinkId. - WASAPI Shared: Low-latency audio bridge powered by NAudio.
- WASAPI Exclusive (Bit-Perfect): Bypasses the Windows audio mixer to stream directly to external USB/Type-C DACs and AMPs.
- WebView2 Direct: Standard output with per-app audio device routing via
- Hot-Plug DAC Auto-Switching: Automatically falls back to internal speakers when an external DAC is unplugged and seamlessly re-engages WASAPI routing when reconnected.
- Discord Rich Presence: Displays Listening to Nocturne with track title, artist, album cover art, and a live progress bar.
- Windows SMTC Integration: Full native support for Windows 10/11 media flyout cards, album thumbnails, and lock-screen controls.
- Compact Mini Player & System Tray: Detachable always-on-top mini player with seek bar and minimize-to-tray support.
- Click-Through Track OSD: Non-intrusive, focus-safe (
WS_EX_NOACTIVATE) dark overlay notification when tracks change in the background or during full-screen gaming. - Customizable Global Hotkeys: Supports physical media keys alongside customizable system-wide key combinations.
- Bilingual UI: Automatic or manual switching between English and Turkish.
- Windows 10 (19041+) or Windows 11 (x64)
- Microsoft Edge WebView2 Runtime (pre-installed on Windows 11)
- .NET 10 SDK (only required if building from source)
# Clone the repository
git clone [https://github.com/egehansimarikk/Nocturne.git](https://github.com/egehansimarikk/Nocturne.git)
cd Nocturne
# Publish self-contained Windows x64 Release build
dotnet publish -c Release -r win-x64 --self-contained true -o .\publish\Nocturne-win-x64To build the Windows installer (NocturneSetup-1.0.0-win-x64.exe), open NocturneSetup.iss with Inno Setup and compile (Ctrl + F9).
- Üç Modlu Ses Motoru Mimarisi:
- WebView2 Doğrudan:
setSinkIddesteğiyle uygulama bazlı ses çıkış cihazı yönlendirme. - WASAPI Shared: NAudio tabanlı düşük gecikmeli ses köprüsü.
- WASAPI Exclusive (Bit-Perfect): Windows ses karıştırıcısını (mixer) baypas ederek harici USB/Type-C DAC ve amfilere doğrudan kayıpsız ses aktarımı.
- WebView2 Doğrudan:
- Otomatik DAC Tak/Çıkar Geçişi: Harici DAC çıkarıldığında müziği kesmeden dahili hoparlöre döner, tekrar takıldığında otomatik olarak WASAPI moduna geri geçer.
- Discord Rich Presence: Dinlenen şarkı adını, sanatçıyı, albüm kapağını ve canlı ilerleme çubuğunu Discord profilinde "Nocturne dinliyor" olarak gösterir.
- Windows Medya Kartı (SMTC) Entegrasyonu: Windows 10/11 ses kontrol kartı, albüm kapağı ve kilit ekranı medya tuşlarıyla tam uyumludur.
- Mini Oynatıcı ve Sistem Tepsisi: Her zaman üstte kalabilen kompakt mini oynatıcı ve kapatıldığında sistem tepsisine küçültme desteği.
- Oyun Dostu Şarkı Bildirimi (OSD): Uygulama arka plandayken veya oyun içindeyken odak çalmayan (
WS_EX_NOACTIVATE) koyu tema şarkı değişim bildirimi. - Özelleştirilebilir Global Kısayollar: Klavye medya tuşlarının yanı sıra Ayarlar menüsünden atanabilen global tuş kombinasyonları.
- Çift Dil Desteği: Sistem diline göre otomatik veya manuel Türkçe / İngilizce arayüz.
- Windows 10 (19041+) veya Windows 11 (x64)
- Microsoft Edge WebView2 Çalışma Zamanı (Windows 11'de yüklü gelir)
- .NET 10 SDK (yalnızca kaynak koddan derlemek için gereklidir)
# Depoyu klonlayın
git clone [https://github.com/egehansimarikk/Nocturne.git](https://github.com/egehansimarikk/Nocturne.git)
cd Nocturne
# Bağımsız (self-contained) Windows x64 Release çıktısı alın
dotnet publish -c Release -r win-x64 --self-contained true -o .\publish\Nocturne-win-x64Kurulum sihirbazı (NocturneSetup-1.0.0-win-x64.exe) oluşturmak için NocturneSetup.iss dosyasını Inno Setup ile açıp derleyin (Ctrl + F9).
- Framework: .NET 10 (WPF)
- Web Engine: Microsoft.Web.WebView2
- Audio Engine: NAudio (WASAPI Loopback & Exclusive/Shared Render)
- Discord Integration: DiscordRichPresence
MIT License — Copyright (c) 2026 egehansimarikk