A "view controller" for menu bar Mac apps

This library provides a StatusItemController component that you can use to create menu bar apps, or apps with menu bar items in macOS.

This component is used in Red Eye and Lucifer.

1. Subclass StatusItemController
2. Implement the following methods:
   1. buildMenu() -> NSMenu
   2. leftClickAction()
   3. rightClickAction()
3. Create an instance of your StatusItemController subclass in your NSApplicationDelegate.

• macOS 11.0+
• Swift 5.9+
• Xcode 15.0+
• SwiftLint

pod 'StatusItemController', '~> 2.0.0'

Add StatusItemController to the dependencies value of your Package.swift.

dependencies: [
    .package(url: "https://github.com/hexedbits/StatusItemController", from: "2.0.0")
]

Alternatively, you can add the package directly via Xcode.

You can read the documentation here. Generated with jazzy. Hosted by GitHub Pages.

Unfortunately, StatusItemController cannot be tested directly. Attempting to create an NSStatusItem outside of an app context throws an assert, which makes sense. Thus, in order to test StatusItemController it must be embedded in an app. Tests can be found in the Example App test suite. See #15 for more details.

Interested in making contributions to this project? Please review the guides below.

• Contributing Guidelines
• Code of Conduct
• Support and Help
• Security Policy

Also consider sponsoring this project or buying my apps! ✌️

Created and maintained by Jesse Squires.

Released under the MIT License. See LICENSE for details.

Copyright © 2020-present Jesse Squires.