Plan A 5K60 and multi-device display test plan

.gitignore

@@ -1,4 +1,16 @@
 .DS_Store
 logs/env/
+logs/power/
 logs/ping_*.txt
 logs/iperf3_*.txt
+apps/primary-macos/.build/
+apps/receiver-macos/.build/
+apps/controller-macos/.build/
+dist/
+
+# Local display captures can contain private screen contents.
+benchmarks/runs/**/*display_*.png
+
+# Local third-party source references are analysis inputs, not vendored code.
+reference/*
+!reference/README.md

.gitmodules

@@ -0,0 +1,4 @@
+[submodule "reference/BetterDisplay"]
+	path = reference/BetterDisplay
+	url = https://github.com/waydabber/BetterDisplay.git
+	branch = opensource

apps/README.md

@@ -3,6 +3,7 @@
 This directory contains the actual software, not just harness docs.
 
 - `primary-macos`: MacBook-side capture/encode/transport app.
+- `receiver-macos`: iMac macOS receiver spike for live 4K TCP HEVC/H.264 display.
 - `receiver-windows`: iMac Windows receiver app.
 - `shared-protocol`: shared protocol definitions/tests.
 

apps/controller-macos/Package.swift

@@ -0,0 +1,22 @@
+// swift-tools-version: 6.0
+
+import PackageDescription
+
+let package = Package(
+    name: "iBridgeController",
+    platforms: [
+        .macOS(.v14)
+    ],
+    products: [
+        .executable(name: "iBridgeController", targets: ["iBridgeController"])
+    ],
+    targets: [
+        .executableTarget(
+            name: "iBridgeController",
+            linkerSettings: [
+                .linkedFramework("AppKit"),
+                .linkedFramework("SwiftUI")
+            ]
+        )
+    ]
+)

apps/controller-macos/Sources/iBridgeController/App.swift

@@ -0,0 +1,19 @@
+import SwiftUI
+
+@main
+struct IBridgeControllerApp: App {
+    @StateObject private var model = ControllerModel()
+
+    var body: some Scene {
+        WindowGroup("iBridge Studio", id: "main") {
+            ContentView()
+                .environmentObject(model)
+        }
+        .windowResizability(.contentMinSize)
+
+        MenuBarExtra("iBridge Studio", systemImage: "display.2") {
+            MenuBarView()
+                .environmentObject(model)
+        }
+    }
+}

apps/controller-macos/Sources/iBridgeController/Components.swift

@@ -0,0 +1,142 @@
+import AppKit
+import SwiftUI
+
+struct StudioBackdrop: View {
+    var body: some View {
+        ZStack {
+            Color(nsColor: .windowBackgroundColor)
+            LinearGradient(
+                colors: [
+                    Color.blue.opacity(0.08),
+                    Color.teal.opacity(0.05),
+                    Color.clear
+                ],
+                startPoint: .topLeading,
+                endPoint: .bottomTrailing
+            )
+            .ignoresSafeArea()
+            LinearGradient(
+                colors: [
+                    Color.white.opacity(0.045),
+                    Color.clear
+                ],
+                startPoint: .top,
+                endPoint: .center
+            )
+            .ignoresSafeArea()
+        }
+    }
+}
+
+struct AppIconMark: View {
+    var body: some View {
+        Image(nsImage: NSApplication.shared.applicationIconImage)
+            .resizable()
+            .aspectRatio(contentMode: .fit)
+    }
+}
+
+struct WindowChromeConfigurator: NSViewRepresentable {
+    func makeNSView(context: Context) -> NSView {
+        let view = NSView()
+        DispatchQueue.main.async {
+            configure(window: view.window)
+        }
+        return view
+    }
+
+    func updateNSView(_ nsView: NSView, context: Context) {
+        DispatchQueue.main.async {
+            configure(window: nsView.window)
+        }
+    }
+
+    private func configure(window: NSWindow?) {
+        guard let window else { return }
+        window.titlebarAppearsTransparent = true
+        window.isOpaque = true
+        window.backgroundColor = .windowBackgroundColor
+        window.styleMask.insert(.fullSizeContentView)
+    }
+}
+
+struct GlassPanel<Content: View>: View {
+    let content: Content
+
+    init(@ViewBuilder content: () -> Content) {
+        self.content = content()
+    }
+
+    var body: some View {
+        content
+            .padding(14)
+            .background(Color(nsColor: .controlBackgroundColor), in: RoundedRectangle(cornerRadius: 8))
+            .overlay(
+                RoundedRectangle(cornerRadius: 8)
+                    .stroke(Color.primary.opacity(0.10), lineWidth: 1)
+            )
+    }
+}
+
+struct HeaderButton: View {
+    let title: String
+    let systemImage: String
+    let role: ButtonRole?
+    let action: () -> Void
+
+    init(
+        _ title: String,
+        systemImage: String,
+        role: ButtonRole? = nil,
+        action: @escaping () -> Void
+    ) {
+        self.title = title
+        self.systemImage = systemImage
+        self.role = role
+        self.action = action
+    }
+
+    var body: some View {
+        Button(role: role, action: action) {
+            Label(title, systemImage: systemImage)
+        }
+        .controlSize(.large)
+    }
+}
+
+struct StatusPill: View {
+    let title: String
+    let color: Color
+
+    var body: some View {
+        HStack(spacing: 6) {
+            Circle()
+                .fill(color)
+                .frame(width: 8, height: 8)
+            Text(title)
+                .font(.caption.weight(.medium))
+        }
+        .padding(.horizontal, 9)
+        .padding(.vertical, 5)
+        .background(color.opacity(0.14), in: Capsule())
+    }
+}
+
+struct LabeledField<Content: View>: View {
+    let title: String
+    let content: Content
+
+    init(_ title: String, @ViewBuilder content: () -> Content) {
+        self.title = title
+        self.content = content()
+    }
+
+    var body: some View {
+        VStack(alignment: .leading, spacing: 5) {
+            Text(title)
+                .font(.caption.weight(.semibold))
+                .foregroundStyle(.secondary)
+            content
+        }
+    }
+}

apps/controller-macos/Sources/iBridgeController/ContentView.swift

@@ -0,0 +1,151 @@
+import AppKit
+import SwiftUI
+
+struct ContentView: View {
+    @EnvironmentObject private var model: ControllerModel
+
+    var body: some View {
+        ZStack {
+            StudioBackdrop()
+            VStack(spacing: 0) {
+                HeaderView()
+                Divider().opacity(0.6)
+                StudioTabPicker()
+                Divider().opacity(0.45)
+                Group {
+                    switch model.selectedTab {
+                    case .sender:
+                        SenderTab()
+                    case .receiver:
+                        ReceiverTab()
+                    case .logs:
+                        LogTab()
+                    }
+                }
+            }
+        }
+        .background(WindowChromeConfigurator())
+        .frame(minWidth: 760, minHeight: 720)
+    }
+}
+
+struct StudioTabPicker: View {
+    @EnvironmentObject private var model: ControllerModel
+
+    var body: some View {
+        HStack {
+            Spacer()
+
+            Picker("Mode", selection: $model.selectedTab) {
+                ForEach(StudioTab.allCases) { tab in
+                    Label(tab.rawValue, systemImage: tab.systemImage)
+                        .tag(tab)
+                }
+            }
+            .pickerStyle(.segmented)
+            .frame(width: 360)
+            .labelsHidden()
+
+            Spacer()
+        }
+        .padding(.horizontal, 20)
+        .padding(.vertical, 12)
+        .background(.thinMaterial)
+    }
+}
+
+struct HeaderView: View {
+    @EnvironmentObject private var model: ControllerModel
+
+    var body: some View {
+        HStack(spacing: 14) {
+            AppIconMark()
+                .frame(width: 54, height: 54)
+                .accessibilityHidden(true)
+
+            VStack(alignment: .leading, spacing: 2) {
+                Text("iBridge Studio")
+                    .font(.title3.weight(.semibold))
+                Text("Turn your retired iMacs into Retina monitors")
+                    .font(.caption)
+                    .foregroundStyle(.secondary)
+            }
+
+            Spacer()
+
+            HeaderButton("Refresh Displays", systemImage: "display.2") {
+                model.listDisplays()
+            }
+            .disabled(model.isListingDisplays)
+
+            HeaderButton("Restore Windows", systemImage: "rectangle.on.rectangle") {
+                model.restoreWindowsToMacBook()
+            }
+
+            HeaderButton("Stop All", systemImage: "stop.fill", role: .destructive) {
+                model.stopAllSenders()
+            }
+        }
+        .padding(.horizontal, 20)
+        .padding(.vertical, 16)
+        .background {
+            Rectangle()
+                .fill(Color(nsColor: .controlBackgroundColor))
+                .overlay(
+                    LinearGradient(
+                        colors: [
+                            Color.white.opacity(0.07),
+                            Color.white.opacity(0.02),
+                            Color.clear
+                        ],
+                        startPoint: .topLeading,
+                        endPoint: .bottomTrailing
+                    )
+                )
+        }
+    }
+}
+
+struct MenuBarView: View {
+    @EnvironmentObject private var model: ControllerModel
+    @Environment(\.openWindow) private var openWindow
+
+    var body: some View {
+        Button("Show iBridge Studio") {
+            openWindow(id: "main")
+            NSApp.activate(ignoringOtherApps: true)
+        }
+
+        Divider()
+
+        Button("Refresh Displays") {
+            model.listDisplays()
+        }
+
+        Button("Restore Windows to MacBook") {
+            model.restoreWindowsToMacBook()
+        }
+
+        Divider()
+
+        Menu("Add Sender") {
+            ForEach(presets) { preset in
+                Button(preset.name) {
+                    model.addSession(preset: preset)
+                    openWindow(id: "main")
+                    NSApp.activate(ignoringOtherApps: true)
+                }
+            }
+        }
+
+        Button("Stop All Senders") {
+            model.stopAllSenders()
+        }
+
+        Divider()
+
+        Button("Quit iBridge Studio") {
+            NSApp.terminate(nil)
+        }
+    }
+}