Merge pull request #11 from countnine/feat/windows/browser-display

feat(windows): browser display — host BrowserDisplayServer in-proc, broadcast lyrics to LAN devices

Author: countnine

src/Musebase.Windows/Musebase.Windows.csproj

@@ -25,6 +25,9 @@
   <ItemGroup>
     <ProjectReference Include="..\Musebase.Core\Musebase.Core.csproj" />
     <ProjectReference Include="..\Musebase.Engine\Musebase.Engine.csproj" />
+    <!-- 인프로세스 브라우저 디스플레이 서버(Kestrel). FrameworkReference(Microsoft.AspNetCore.App)는
+         이 ProjectReference를 통해 전이되므로 여기서는 한 줄이면 된다. -->
+    <ProjectReference Include="..\Musebase.Browser\Musebase.Browser.csproj" />
   </ItemGroup>
 
   <!-- UI 다국어 카탈로그: 로케일별 JSON을 어셈블리에 임베드 (Musebase.Windows.i18n.<code>.json) -->

src/Musebase.Windows/Program.cs

@@ -6,6 +6,7 @@
 using H.NotifyIcon;
 using Musebase.Windows.Overlay;
 using Musebase.Windows.Services;
+using Musebase.Browser;
 using Musebase.Engine;
 using Velopack;
 
@@ -87,6 +88,9 @@ private static void Main(string[] args)
             H.NotifyIcon.TaskbarIcon? tray = null;
             MiniWindow? miniWindow = null;
 
+            // 브라우저 디스플레이 서버(인프로세스 Kestrel). null=꺼짐. 토글/자동시작/종료 경로가 공유.
+            BrowserDisplayServer? browserServer = null;
+
             // 번역 실패 사용자 힌트: 같은 kind는 세션 1회만(곡마다 스팸 금지). 로그는 매 실패 기록.
             var reportedFailureKinds = new HashSet<Musebase.Core.Translation.TranslatorFailureKind>();
             static string LocalizeFailureHint(Musebase.Core.Translation.TranslatorFailureKind kind) => kind switch
@@ -164,6 +168,7 @@ void OnTranslationFailure(Musebase.Core.Translation.TranslatorFailure f)
             var overlayToggle = new MenuItem { Header = Loc.T("tray.overlay.show"), IsCheckable = true, IsChecked = settings.OverlayVisible };
             var moveToggle = new MenuItem { Header = Loc.T("tray.overlay.moveMode"), IsCheckable = true };
             var sourceMenu = new MenuItem { Header = Loc.T("tray.source") };
+            var browserDisplayToggle = new MenuItem { Header = Loc.T("tray.browserDisplay"), IsCheckable = true, IsChecked = settings.BrowserDisplayEnabled };
 
             void ApplySource(string mode, bool includeBrowsers)
             {
@@ -428,9 +433,94 @@ void ReviveOverlay()
             void ExitApp()
             {
                 miniWindow?.CloseForExit();
-                app.Shutdown();
+                app.Shutdown(); // 브라우저 서버 정리는 app.Exit 핸들러에서(설정은 유지 → 다음 실행 자동 시작)
+            }
+
+            // ---- 브라우저 디스플레이(태블릿/TV) 수명주기 ----
+            // 실제 접속용 URL(LAN이면 사설 IPv4, 아니면 localhost) + 실제 바인딩 포트(포트=0 대응).
+            string BrowserDisplayUrl(BrowserDisplayServer server)
+            {
+                var port = settings.BrowserDisplayPort;
+                var bound = server.Urls
+                    .Select(u => Uri.TryCreate(
+                        u.Replace("0.0.0.0", "localhost").Replace("[::]", "localhost").Replace("+", "localhost"),
+                        UriKind.Absolute, out var uri) ? uri : null)
+                    .FirstOrDefault(u => u is not null);
+                if (bound is not null) port = bound.Port;
+                var host = settings.BrowserDisplayLan && LocalLanIPv4() is { } ip ? ip : "localhost";
+                return $"http://{host}:{port}";
+            }
+
+            async Task StartBrowserDisplayAsync(bool userInitiated)
+            {
+                if (browserServer is not null) return; // 이미 실행 중
+                try
+                {
+                    browserServer = await BrowserDisplayServer.StartAsync(new BrowserDisplayOptions(
+                        Port: settings.BrowserDisplayPort,
+                        ListenLan: settings.BrowserDisplayLan,
+                        Log: Log.Write));
+                    coordinator.StateChanged += browserServer.Publish; // 표시 상태 방송 연결
+                    browserServer.Publish(coordinator.CurrentState);    // 접속 전이라도 현재 상태 1회 반영
+                    telemetry.CountFeature("browserDisplay");
+
+                    var url = BrowserDisplayUrl(browserServer);
+                    settings.BrowserDisplayEnabled = true;
+                    settings.Save();
+                    browserDisplayToggle.IsChecked = true;
+                    Log.Write($"[browser] 시작: 리슨={string.Join(", ", browserServer.Urls)} 안내URL={url}");
+
+                    // URL 노출: 트레이 툴팁·미니창 상태 + (사용자 조작 시) 안내 다이얼로그.
+                    var statusText = Loc.T("browserDisplay.status.on", ("url", url));
+                    if (tray is { } t) t.ToolTipText = Loc.T("tray.tooltip.status", ("status", statusText));
+                    miniWindow?.SetStatus(statusText);
+                    if (userInitiated)
+                        MessageBox.Show(
+                            Loc.T("browserDisplay.dialog.body", ("url", url)),
+                            Loc.T("browserDisplay.dialog.title"),
+                            MessageBoxButton.OK, MessageBoxImage.Information);
+                }
+                catch (Exception e)
+                {
+                    Log.Write($"[browser] 시작 실패: {e.Message}");
+                    if (browserServer is { } failed)
+                    {
+                        coordinator.StateChanged -= failed.Publish;
+                        try { await failed.DisposeAsync(); } catch { /* 정리 실패 무시 */ }
+                        browserServer = null;
+                    }
+                    settings.BrowserDisplayEnabled = false;
+                    settings.Save();
+                    browserDisplayToggle.IsChecked = false;
+                    MessageBox.Show(
+                        Loc.T("browserDisplay.fail", ("port", settings.BrowserDisplayPort.ToString()), ("error", e.Message)),
+                        Loc.T("browserDisplay.dialog.title"),
+                        MessageBoxButton.OK, MessageBoxImage.Warning);
+                }
             }
 
+            async Task StopBrowserDisplayAsync(bool save)
+            {
+                if (browserServer is not { } server) return;
+                coordinator.StateChanged -= server.Publish;
+                browserServer = null;
+                try { await server.DisposeAsync(); }
+                catch (Exception e) { Log.Write($"[browser] 정지 실패: {e.Message}"); }
+                if (save)
+                {
+                    settings.BrowserDisplayEnabled = false;
+                    settings.Save();
+                }
+                browserDisplayToggle.IsChecked = false;
+                Log.Write("[browser] 정지");
+            }
+
+            browserDisplayToggle.Click += async (_, _) =>
+            {
+                if (browserDisplayToggle.IsChecked) await StartBrowserDisplayAsync(userInitiated: true);
+                else await StopBrowserDisplayAsync(save: true);
+            };
+
             overlayToggle.Click += (_, _) => SetOverlayVisible(overlayToggle.IsChecked);
             moveToggle.Click += (_, _) => overlay.SetMoveMode(moveToggle.IsChecked);
             overlay.MoveModeChanged += moveMode => moveToggle.IsChecked = moveMode; // 자물쇠 버튼과 동기화
@@ -468,6 +558,7 @@ void AdjustOffset(double? delta)
             menu.Items.Add(overlayToggle);
             menu.Items.Add(moveToggle);
             menu.Items.Add(sourceMenu);
+            menu.Items.Add(browserDisplayToggle);
             menu.Items.Add(new Separator());
             menu.Items.Add(offsetLabel);
             menu.Items.Add(offsetPlus);
@@ -529,6 +620,13 @@ void AdjustOffset(double? delta)
 
             app.Exit += (_, _) =>
             {
+                // 브라우저 서버 정리: 종료 직전 Kestrel을 멈춰 포트를 해제(설정은 유지 → 다음 실행 자동 시작).
+                if (browserServer is { } bs)
+                {
+                    try { bs.DisposeAsync().AsTask().Wait(TimeSpan.FromSeconds(2)); }
+                    catch { /* 종료 정리 실패 무시 */ }
+                    browserServer = null;
+                }
                 tray.Dispose();
                 appIcon.Dispose();
                 telemetry.Dispose(); // 세션 feature_use 카운터를 큐로 보존(다음 실행에서 업로드)
@@ -611,6 +709,7 @@ void ApplyMenuText()
                 overlayToggle.Header = Loc.T("tray.overlay.show");
                 moveToggle.Header = Loc.T("tray.overlay.moveMode");
                 sourceMenu.Header = Loc.T("tray.source");
+                browserDisplayToggle.Header = Loc.T("tray.browserDisplay");
                 offsetPlus.Header = Loc.T("tray.offset.faster");
                 offsetMinus.Header = Loc.T("tray.offset.slower");
                 offsetReset.Header = Loc.T("tray.offset.reset");
@@ -641,6 +740,10 @@ void ApplyMenuText()
             coordinator.Start(); // 배선 완료 후 시작 (캐시/번역/상태 이벤트 유효)
             Log.Write("=== Musebase 시작 ===");
 
+            // 브라우저 디스플레이 자동 시작(설정 켜짐 시). 실패해도 앱 다른 기능엔 영향 없음.
+            if (settings.BrowserDisplayEnabled)
+                _ = StartBrowserDisplayAsync(userInitiated: false);
+
             // 텔레메트리 동의 다이얼로그(최초 1회, 기본 모두 꺼짐 = 미수집)
             if (!settings.TelemetryConsentAsked)
                 new TelemetryConsentWindow(settings).Show();
@@ -651,6 +754,32 @@ void ApplyMenuText()
         app.Run();
     }
 
+    /// <summary>
+    /// 이 PC의 사설대역 IPv4 주소(LAN 접속용). 여러 개면 첫 번째. 없으면 null(→ 호출부는 localhost 사용).
+    /// 10.x / 172.16–31.x / 192.168.x 만 후보로 삼아 공인/링크로컬 주소를 배제한다.
+    /// </summary>
+    private static string? LocalLanIPv4()
+    {
+        try
+        {
+            foreach (var ip in System.Net.Dns.GetHostAddresses(System.Net.Dns.GetHostName()))
+            {
+                if (ip.AddressFamily != System.Net.Sockets.AddressFamily.InterNetwork) continue;
+                var b = ip.GetAddressBytes();
+                var isPrivate =
+                    b[0] == 10 ||
+                    (b[0] == 172 && b[1] >= 16 && b[1] <= 31) ||
+                    (b[0] == 192 && b[1] == 168);
+                if (isPrivate) return ip.ToString();
+            }
+        }
+        catch
+        {
+            // 주소 조회 실패 시 localhost 폴백
+        }
+        return null;
+    }
+
     /// <summary>파일명으로 쓸 수 없는 문자를 '_'로 치환한다.</summary>
     private static string SanitizeFileName(string name)
     {

src/Musebase.Windows/Services/AppSettings.cs

@@ -81,6 +81,17 @@ public sealed class AppSettings
     /// <summary>자동 모드에서 브라우저(Firefox/Chrome 등)를 음악 소스로 포함할지. 기본 제외(영상 오인식 방지).</summary>
     public bool IncludeBrowsers { get; set; }
 
+    // ---- 브라우저 디스플레이 (태블릿/TV 원격 표시, Musebase.Browser 인프로세스 호스팅) ----
+
+    /// <summary>브라우저 디스플레이 서버(Kestrel)를 켤지. 켜면 앱 시작 시 자동 기동. 기본 꺼짐.</summary>
+    public bool BrowserDisplayEnabled { get; set; }
+
+    /// <summary>브라우저 디스플레이 리슨 포트(기본 5123).</summary>
+    public int BrowserDisplayPort { get; set; } = 5123;
+
+    /// <summary>true면 0.0.0.0에 바인딩해 같은 LAN의 다른 기기(태블릿/TV)에서 접속 가능. 기본 localhost 전용.</summary>
+    public bool BrowserDisplayLan { get; set; }
+
     // ---- 가사 소스 선택 (레지스트리 기반, [[0002-pluggable-sources-and-translation]]) ----
 
     /// <summary>

src/Musebase.Windows/SettingsWindow.cs

@@ -281,6 +281,41 @@ void UpdateEndpointVisibility() =>
                 Margin = new Thickness(0, 6, 0, 0),
             });
 
+            // ---- 브라우저 디스플레이(태블릿/TV) — 켜기는 트레이 메뉴에서, 여기선 포트·LAN 설정 ----
+            general.Children.Add(Header("settings.browserDisplay.header"));
+            general.Children.Add(new TextBlock
+            {
+                Text = Loc.T("settings.browserDisplay.hint"),
+                Opacity = 0.7,
+                TextWrapping = TextWrapping.Wrap,
+                Margin = new Thickness(0, 0, 0, 4),
+            });
+            var browserPortBox = new TextBox
+            {
+                Text = settings.BrowserDisplayPort.ToString(CultureInfo.InvariantCulture),
+                Width = 90,
+                HorizontalAlignment = HorizontalAlignment.Left,
+                VerticalContentAlignment = VerticalAlignment.Center,
+            };
+            var browserPortRow = new StackPanel { Orientation = Orientation.Horizontal, Margin = new Thickness(0, 2, 0, 0) };
+            browserPortRow.Children.Add(new TextBlock
+            {
+                Text = Loc.T("settings.browserDisplay.port"),
+                VerticalAlignment = VerticalAlignment.Center,
+                Margin = new Thickness(0, 0, 8, 0),
+            });
+            browserPortRow.Children.Add(browserPortBox);
+            general.Children.Add(browserPortRow);
+            var browserLanCheck = WrapCheck("settings.browserDisplay.lan", settings.BrowserDisplayLan, new Thickness(0, 8, 0, 0));
+            general.Children.Add(browserLanCheck);
+            general.Children.Add(new TextBlock
+            {
+                Text = Loc.T("settings.browserDisplay.lan.hint"),
+                Opacity = 0.7,
+                TextWrapping = TextWrapping.Wrap,
+                Margin = new Thickness(22, 2, 0, 0),
+            });
+
             // 사용 통계(텔레메트리, ADR-0004) — 토글 즉시 반영(저장 버튼과 무관)
             general.Children.Add(Header("settings.telemetry.header"));
             var telemetryBasicCheck = WrapCheck("telemetry.consent.basic", settings.TelemetryBasicEnabled, new Thickness(0, 2, 0, 0));
@@ -494,6 +529,10 @@ static string NormalizeHex(string input, string fallback)
                 settings.TranslationFallbackToFree = fallbackCheck.IsChecked == true;
                 settings.EnabledLyricsSources = sourceChecks.Where(s => s.Box.IsChecked == true).Select(s => s.Id).ToList();
                 settings.MiniWindowCloseToTray = closeToTrayCheck.IsChecked == true;
+                // 브라우저 디스플레이 포트/LAN (실행 중 변경은 다음 시작부터 적용 — 토글 재시작)
+                if (int.TryParse(browserPortBox.Text.Trim(), out var browserPort) && browserPort is >= 0 and <= 65535)
+                    settings.BrowserDisplayPort = browserPort;
+                settings.BrowserDisplayLan = browserLanCheck.IsChecked == true;
                 settings.TextColor = NormalizeHex(textColor.Box.Text, settings.TextColor);
                 settings.KaraokeColor = NormalizeHex(karaokeColor.Box.Text, settings.KaraokeColor);
                 settings.TranslationColor = NormalizeHex(translationColor.Box.Text, settings.TranslationColor);

src/Musebase.Windows/i18n/en.json

@@ -20,6 +20,11 @@
   "settings.sources.official": "official API",
   "settings.sources.unofficial": "unofficial",
   "settings.sources.restart": "Lyrics-source changes take effect after restart.",
+  "settings.browserDisplay.header": "Browser display (tablet / TV)",
+  "settings.browserDisplay.hint": "Show live lyrics in a web browser on a tablet or TV. Turn it on from the tray menu (\"Browser display\").",
+  "settings.browserDisplay.port": "Port",
+  "settings.browserDisplay.lan": "Allow other devices on your LAN to connect",
+  "settings.browserDisplay.lan.hint": "You may need to allow Musebase through Windows Firewall. Port/LAN changes apply the next time browser display starts.",
   "settings.fontHint": "Text size adjusts automatically to the overlay size.\n(Hover the overlay and click the lock → move/resize mode)",
   "settings.style.header": "Overlay style",
   "settings.color.pick.tooltip": "Click to choose a color",
@@ -63,6 +68,7 @@
   "tray.source.auto": "Auto-detect",
   "tray.source.includeBrowsers": "Include browsers (YouTube, etc.)",
   "tray.source.none": "(no players detected)",
+  "tray.browserDisplay": "Browser display (tablet / TV)",
   "tray.offset.faster": "Lyrics earlier (+0.5s)",
   "tray.offset.slower": "Lyrics later (-0.5s)",
   "tray.offset.reset": "Reset offset",
@@ -77,6 +83,11 @@
   "tray.update.check": "Check for updates… (v{version})",
   "tray.update.install": "⬆ Install update (v{version})",
 
+  "browserDisplay.dialog.title": "Browser display",
+  "browserDisplay.dialog.body": "Browser display is on.\nOpen this address in a browser on a device on the same network:\n\n{url}",
+  "browserDisplay.status.on": "Browser display on — {url}",
+  "browserDisplay.fail": "Could not start the browser display on port {port}.\n{error}",
+
   "update.title": "Musebase Update",
   "update.dev": "Auto-update is not available in development builds.\nCurrent version: v{version}",
   "update.latest": "You are on the latest version. (v{version})",

src/Musebase.Windows/i18n/ko.json

@@ -20,6 +20,11 @@
   "settings.sources.official": "공식 API",
   "settings.sources.unofficial": "비공식",
   "settings.sources.restart": "가사 소스 변경은 재시작 후 적용됩니다.",
+  "settings.browserDisplay.header": "브라우저 디스플레이 (태블릿 · TV)",
+  "settings.browserDisplay.hint": "태블릿·TV의 웹 브라우저로 실시간 가사를 표시합니다. 켜기는 트레이 메뉴(\"브라우저 디스플레이\")에서.",
+  "settings.browserDisplay.port": "포트",
+  "settings.browserDisplay.lan": "LAN의 다른 기기에서 접속 허용",
+  "settings.browserDisplay.lan.hint": "Windows 방화벽에서 Musebase 허용이 필요할 수 있습니다. 포트·LAN 변경은 브라우저 디스플레이를 다시 켤 때 적용됩니다.",
   "settings.fontHint": "텍스트 크기는 오버레이 크기에 맞춰 자동 조절됩니다.\n(오버레이에 마우스를 올려 자물쇠 클릭 → 이동/크기 조절 모드)",
   "settings.style.header": "오버레이 스타일",
   "settings.color.pick.tooltip": "클릭하여 색 선택",
@@ -63,6 +68,7 @@
   "tray.source.auto": "자동 감지",
   "tray.source.includeBrowsers": "브라우저 포함 (YouTube 등)",
   "tray.source.none": "(감지된 플레이어 없음)",
+  "tray.browserDisplay": "브라우저 디스플레이 (태블릿 · TV)",
   "tray.offset.faster": "가사 빠르게 (+0.5초)",
   "tray.offset.slower": "가사 느리게 (-0.5초)",
   "tray.offset.reset": "오프셋 초기화",
@@ -77,6 +83,11 @@
   "tray.update.check": "업데이트 확인… (v{version})",
   "tray.update.install": "⬆ 업데이트 설치 (v{version})",
 
+  "browserDisplay.dialog.title": "브라우저 디스플레이",
+  "browserDisplay.dialog.body": "브라우저 디스플레이가 켜졌습니다.\n같은 네트워크의 기기에서 브라우저로 다음 주소를 여세요:\n\n{url}",
+  "browserDisplay.status.on": "브라우저 디스플레이 켜짐 — {url}",
+  "browserDisplay.fail": "포트 {port}에서 브라우저 디스플레이를 시작하지 못했습니다.\n{error}",
+
   "update.title": "Musebase 업데이트",
   "update.dev": "개발 빌드에서는 자동 업데이트를 사용할 수 없습니다.\n현재 버전: v{version}",
   "update.latest": "최신 버전입니다. (v{version})",