StableBar

Product Introduction

1. Definition: StableBar is a native, free, and open-source customizable menu bar and status bar utility designed specifically for macOS (macOS 14+ on Apple Silicon), built utilizing Swift, AppKit, and SwiftUI. Functioning as a specialized macOS ricing and window management overlay, it provides a dedicated graphical user interface to replace or augment the default system menu bar with deeply integrated workspace indicators and modular widgets.
2. Core Value Proposition: StableBar exists to provide macOS power users, developers, and customization enthusiasts with a high-performance, native alternative to complex scripting-based status bars like SketchyBar. By offering a centralized Settings window and declarative JSON configuration alongside visual in-place editing, StableBar eliminates the steep learning curve of shell script orchestration while delivering advanced window manager integration, system monitoring widgets, and responsive layout styling.

Main Features

1. Workspace Integration and Tiling Window Manager Support: StableBar natively syncs workspace states with popular macOS tiling window managers, including AeroSpace, yabai, OmniWM, and Rift, as well as providing an opt-in macOS Spaces workspace source. When users switch virtual desktops or window layouts, the menu bar updates active workspace indicators instantly without interrupting workflow or layout stability.
2. Visual In-Place Editing and Declarative Configuration: Users can right-click the bar to activate "Edit Bar in Place," allowing them to drag widgets between positions, add new elements via an integrated plus menu, or remove items with live saving and undo support. Configuration can be managed through a graphical Settings interface or a structured local JSON file backed by JSON schema validation, removing the need for manual script compilation.
3. Modular Widgets, Interactive Popups, and Script Execution: The utility supports a robust ecosystem of built-in and downloadable widgets (spanning calendars, system stats, music playback controls, and active app displays) that can trigger interactive popups containing graphs, lists, and controls. Additionally, users can execute custom shell scripts returning text or JSON to dynamically populate status elements, with support for timer-based or event-driven refreshes.

Problems Solved

1. Pain Point: Setting up highly customized, riced status bars on macOS traditionally requires writing, debugging, and maintaining complex shell scripts and background daemons (such as SketchyBar configurations), which are fragile, difficult to debug, and lack user-friendly graphical configuration windows.
2. Target Audience: macOS power users, Unixporn community members, software engineers, window-manager enthusiasts (using AeroSpace or yabai), and developers seeking an aesthetic, minimalist, and highly informative desktop environment.
3. Use Cases: Configuring multi-monitor setups with independent status bars that accommodate hardware notches, monitoring real-time CPU, memory, and disk usage metrics via custom shell scripts, and tracking virtual desktop states across multi-workspace tiling window managers without sacrificing native macOS performance.

Unique Advantages

1. Strengths & Limitations (Pros & Cons):
   • Pros: Written natively in Swift and SwiftUI for high performance and low resource overhead; offers both a visual "Edit Bar in Place" GUI and JSON configuration options; features zero-cost open-source availability; integrates seamlessly out-of-the-box with modern tiling window managers like AeroSpace and yabai; includes native multi-display support accommodating MacBook notches.
   • Cons: Restricted strictly to macOS 14 and newer Apple Silicon architectures; lacks native cross-platform support for Linux or Windows; advanced custom widget creation still requires familiarity with shell scripting or JSON packaging standards.
2. Key Alternatives & Differentiation:
   • SketchyBar: While SketchyBar is the industry standard for macOS status bar customization, it relies almost entirely on shell scripting and event-server architectures, making it difficult for non-developers to configure. StableBar differentiates itself by providing a native Swift application featuring a visual settings UI, JSON schema validation, and direct in-place drag-and-drop editing.
   • Übersicht: Übersicht renders HTML/JS widgets on the desktop and status areas, but it acts primarily as a web-view container rather than a fully integrated, native menu bar replacement with direct tiling window manager workspace hooks.
   • Default macOS Menu Bar: The stock macOS menu bar offers zero customization for workspace mapping, tiling window manager states, or custom system metrics scripts, whereas StableBar provides deep tiling window manager integration and modular widget extensibility.

Frequently Asked Questions (FAQ)

1. Question: Is StableBar free and open-source?
   • Answer: Yes, StableBar is completely free and open-source software distributed under the MIT license, with source code and releases publicly available on GitHub.
2. Question: Which window managers are officially supported by StableBar?
   • Answer: StableBar natively integrates with AeroSpace, yabai, OmniWM, and Rift tiling window managers, and also provides an opt-in workspace source for standard macOS Spaces.
3. Question: How do I add custom widgets or scripts to StableBar?
   • Answer: You can add custom widgets by configuring shell scripts that output plain text or JSON within your setup files, or by browsing the built-in widget store via Settings to install community packages.
4. Question: Does StableBar support multi-monitor setups with hardware notches?
   • Answer: Yes, StableBar supports multiple displays, allowing each connected monitor to render its own independent bar configuration with built-in layout spacing designed to accommodate MacBook display notches.