MenuBarExtraAccess

KO | EN

gitlite — search

#python #hacktoberfest #react #ai #typescript #golang #go #machine-learning #linux #docker #nodejs #java #kubernetes #vue

MenuBarExtraAccess

(★ 218)

Show/hide SwiftUI MenuBarExtra menu using Bindings, access the underlying status item, and more.

File Explorer

Download Latest Version (.zip)

- - bug_report.yml
  - config.yml
- - build.yml
- FUNDING.yml
- - MenuBarExtra Window Introspection.swift
  - MenuBarExtraAccess.swift
  - NSControl Extensions.swift
  - NSEvent Extensions.swift
  - NSStatusItem Extensions.swift
  - NSStatusItem+ExpandedInterfaceSession.swift
  - NSWindow Extensions.swift
  - Utilities.swift
.gitignore
.swiftformat
LICENSE
Package.swift
Package@swift-5.7.swift
README.md

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# MenuBarExtraAccess

[![Platforms - macOS 13+](https://img.shields.io/badge/platforms-macOS%2013+-blue.svg?style=flat)](https://developer.apple.com/swift) [![](https://img.shields.io/endpoint?url=https%3A%2F%2Fswiftpackageindex.com%2Fapi%2Fpackages%2Forchetect%2FMenuBarExtraAccess%2Fbadge%3Ftype%3Dswift-versions)](https://swiftpackageindex.com/orchetect/MenuBarExtraAccess) [![License: MIT](http://img.shields.io/badge/license-MIT-lightgrey.svg?style=flat)](https://github.com/orchetect/MenuBarExtraAccess/blob/main/LICENSE)

#### **Gives you *Extra* access to SwiftUI `MenuBarExtra`.**

- 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](#Known-Issues))

## Why?

`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)

## Overview

```swift
@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

## Getting Started

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](Examples) folder for a demonstration of the package's usage.

## Known Issues

- 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.

## Menu Builder

Check out [MacControlCenterUI](https://github.com/orchetect/MacControlCenterUI), a SwiftUI package built on MenuBarExtraAccess for easily building Control Center style menus.

## Author

Coded by a bunch of 🐹 hamsters in a trenchcoat that calls itself [@orchetect](https://github.com/orchetect).

## License

Licensed under the MIT license. See [LICENSE](https://github.com/orchetect/MenuBarExtraAccess/blob/master/LICENSE) for details.

## Community & Support

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](https://github.com/orchetect/MenuBarExtraAccess/discussions).
- If an issue is a verifiable bug with reproducible steps it may be posted in [Issues](https://github.com/orchetect/MenuBarExtraAccess/issues).

## Sponsoring

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

Contributions are welcome. Posting in [Discussions](https://github.com/orchetect/MenuBarExtraAccess/discussions) first prior to new submitting PRs for features or modifications is encouraged.

## Code Quality & AI Contribution Policy

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.

MenuBarExtraAccess

File Explorer

Today's picks

Was this content helpful?

Recent Feedback

MenuBarExtraAccess

File Explorer

Today's picks

Was this content helpful?

Recent Feedback

Download README