• Programmatically hide, show, or toggle the menu (by way of a Bool binding)
• Programmatically enable or disable the menubar extra (by way of a Bool binding)
• Access to the underlying NSStatusItem
• Access to the underlying NSWindow (when using the .window style)
• Works with one or multiple MenuBarExtra
• Works with both menu and window based styles (see Known Issues)

MenuBarExtra lacks 1st-party API to get or set the menu presentation state, disable the menubar extra, access the NSStatusItem, or access the popup's NSWindow. (Still as of Xcode 26)

@main struct MyApp: App {
    @State var isMenuPresented: Bool = false
    @State var isMenuEnabled: Bool = true
    @State var statusItem: NSStatusItem?

    var body: some Scene {
        MenuBarExtra("My App") {
            MenuView()
                .introspectMenuBarExtraWindow { window in
                    // if using `.window` MenuBarExtra style, optionally set up NSWindow
                }
        }
        .menuBarExtraAccess(
            isPresented: $isMenuPresented, 
            isEnabled: $isMenuEnabled // if omitted, defaults to `.constant(true)`
        ) { statusItem in
            // optionally set up NSStatusItem, or store its reference in a state var
            self.statusItem = statusItem
        }
        .menuBarExtraStyle(.window)
    }
}

• A new .menuBarExtraAccess(isPresented:, isEnabled:) { statusItem in } scene modifier:
  • a binding to hide/show/toggle the menu
  • a binding to enabled/disable the menubar extra
  • direct access to the NSStatusItem if needed
• A new .introspectMenuBarExtraWindow { window in } view modifier passing in the NSWindow reference
• Window-based menu extra status items now remain highlighted while the window is open so it feels more like a native menu
• No private API used, so it's Mac App Store safe

The library is available as a Swift Package Manager (SPM) package.

Use the URL https://github.com/orchetect/MenuBarExtraAccess when adding the library to a project or Swift package.

Check out the Examples folder for a demonstration of the package's usage.

• When using .menuBarExtraStyle(.menu), SwiftUI causes the popup menu to block the runloop while the menu is open, which means:
  • Observing the isPresented binding will not work as expected.
  • Setting the isPresented binding to false while the menu is presented has no effect.
  • The user must dismiss the menu themself to allow event flow to continue. We have no control over this until Apple decides to change the MenuBarExtra behavior.

Check out MacControlCenterUI, a SwiftUI package built on MenuBarExtraAccess for easily building Control Center style menus.

Coded by a bunch of 🐹 hamsters in a trenchcoat that calls itself @orchetect.

Licensed under the MIT license. See LICENSE for details.

Please do not email maintainers for technical support. Several options are available for issues and questions:

• Questions and feature ideas can be posted to Discussions.
• If an issue is a verifiable bug with reproducible steps it may be posted in Issues.

If you enjoy using MenuBarExtraAccess and want to contribute to open-source financially, GitHub sponsorship is much appreciated. Feedback and code contributions are also welcome.

Contributions are welcome. Posting in Discussions first prior to new submitting PRs for features or modifications is encouraged.

In an effort to maintain a consistent level of code quality and safety, this repository was built by hand and is maintained without the use of AI code generation.

AI-assisted contributions are welcome, but must remain modest in scope, maintain the same degree of quality and care, and be thoroughly vetted before acceptance.