SkyLightWindow

SkyLightWindow leverages macOS's private SkyLight framework to achieve system-level window positioning. It follows these steps:

1. Creates a special space at the highest system level.
2. Moves the target window to this space.
3. Ensures the window remains visible above all other content (including fullscreen apps).

The framework manages the connection to the SkyLight service, space management, window delegation, and positioning.

Add SkyLightWindow as a dependency in your Package.swift file. You can use the default configuration or enable the OpenSwiftUI package trait if you are using the OpenSwiftUI framework.

Default Configuration (macOS 11.0+, Swift 5.9+): Use this for standard SwiftUI integration.

OpenSwiftUI Trait (macOS 15.0+, Swift 6.1+): Use this if you are importing OpenSwiftUI instead of SwiftUI. This requires the OpenSwiftUI-spm binary package.

// Default installation
dependencies: [
    .package(url: "https://github.com/Lakr233/SkyLightWindow", from: "1.0.0"),
]

// Installation with OpenSwiftUI trait
dependencies: [
    .package(
        url: "https://github.com/Lakr233/SkyLightWindow",
        from: "1.0.0",
        traits: ["OpenSwiftUI"]
    ),
]

To display a SwiftUI view above all other windows (including fullscreen apps), import SwiftUI and SkyLightWindow, then apply the .moveToSky() modifier to any view.

import SwiftUI
import SkyLightWindow

struct ContentView: View {
    var body: some View {
        Text("This view is always on top!")
            .moveToSky()
    }
}

If your project uses OpenSwiftUI instead of standard SwiftUI, the usage is identical to the standard SwiftUI integration, but you must import OpenSwiftUI.

import OpenSwiftUI
import SkyLightWindow

struct ContentView: View {
    var body: some View {
        Text("This view is always on top!")
            .moveToSky()
    }
}

For AppKit-based applications, use SkyLightOperator.shared.delegateView(_:toScreen:) to programmatically create a topmost window for a specific view and screen.

import SkyLightWindow

let screen = NSScreen.main!
let view = AnyView(Text("Overlay Content"))
let controller = SkyLightOperator.shared.delegateView(view, toScreen: screen)

Compatibility

• Default SwiftUI Integration: macOS 11.0+ and Swift Compiler 5.9+.
• OpenSwiftUI Trait: macOS 15.0+ and Swift Compiler 6.1+.

Security & Stability

• Privacy: The framework uses private APIs but does not require special entitlements and is compatible with the Mac App Store.
• Risk: Because it relies on private APIs, behavior may change with macOS system updates.