StatusItemController CI

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 10.12+
  • Swift 5.5+
  • Xcode 13.0+
  • SwiftLint



pod 'StatusItemController', '~> 1.0.0'

Swift Package Manager

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

dependencies: [
    .package(url: "", from: "1.0.0")

Alternatively, you can add the package directly via Xcode.


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

Notes on Testing

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.

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.