StableBar is built on open-source principles to guarantee security, privacy, and full reproducibility. All sensitive data transformations run locally on your hardware with zero telemetry or unexpected cloud dependencies.
Key Technical Features & Capabilities
**Native. Swift, AppKit and SwiftUI, with no web view or private window-server API, except in the opt-in macOS Spaces workspace source. One panel per display; workspace changes update the widgets in place instead of recreating windows.**: Streamlined desktop functionality optimized for macOS and Windows.
Guided setup. Pick a preset, a theme and a placement, and watch each choice on your real bar. Then edit the bar in place, in Settings or in JSON.: Streamlined desktop functionality optimized for macOS and Windows.
Themes. Six ship with the app and more come from the store. Save as Theme… turns your own look into one. Experimental Liquid Glass on macOS 26.: Streamlined desktop functionality optimized for macOS and Windows.
Built-in widgets. Workspaces, app menus, the active app, clock, CPU and memory, network, battery, sound and calendar, without running a script.: Streamlined desktop functionality optimized for macOS and Windows.
Any script is a widget. Print text or JSON from any language, refresh on a timer or on events, and open a popup with graphs, lists and controls.: Streamlined desktop functionality optimized for macOS and Windows.
**Window managers. Workspaces from AeroSpace, yabai or OmniWM. Without one, StableBar can keep windows and notifications clear of the bar.
Every display. Notch-aware placement, widgets per kind of screen and a separate bar for each screen setup.: Streamlined desktop functionality optimized for macOS and Windows.
Scriptable. The command line queries and edits the running bar and sends events from other tools.: Streamlined desktop functionality optimized for macOS and Windows.
Architecture & Technology Stack
Primary Languages: Swift
Frameworks & UI Runtime: SwiftUI / AppKit
Build Systems & Tooling: Xcode / Node.js / Cargo
Supported Platforms: macOS 12.0+ (Apple Silicon M1-M4 & Intel x86_64), Windows 10/11 x64, Linux
System Requirements
Specification
Minimum Requirement
Recommended Specification
Operating System
macOS 12.0 Monterey / Windows 10 x64
macOS 14.0+ Sonoma / Windows 11 x64
Processor Architecture
Apple Silicon (M1+) or Intel Core i5 x64
Apple Silicon Unified Memory (M2/M3/M4)
Memory (RAM)
4 GB Unified RAM
8 GB+ High-Speed RAM
Storage Space
300 MB available local disk space
1 GB+ SSD storage
GPU Acceleration
Metal 2 / DirectX 12 compatible
Apple Neural Engine / Vulkan capable
Installation & Setup Guide
macOS Installation (Recommended)
1
Download the verified .dmg release installer directly from CookApps.
2
Open the disk image and drag StableBar.app into your /Applications folder.
3
Launch StableBar via Spotlight (Cmd + Space) or Launchpad.
Alternatively, install using Homebrew if available:
bash
brew install --cask seb-graf/tap/stablebar
Windows Installation
1
Download the official installer package (.exe / .msi).
2
Run the executable and follow the setup wizard.
3
Launch StableBar from the Start Menu or desktop shortcut.
Building from Source (Development Setup)
bash
git clone https://github.com/Seb-GRAF/StableBar.git
cd StableBar
pnpm install || cargo build --release
pnpm run build
How to Use & Workflow
1
Application Launch & Workspace: Open StableBar to load the responsive native workspace.
2
Configuration & Preferences: Press Cmd + , (macOS) or Ctrl + , (Windows) to configure hardware acceleration, custom directories, and display themes.
3
Primary Operation: Drag-and-drop source files or input parameters directly into the central window.
4
Execution & Export: Initiate the processing pipeline and verify output files saved directly to your chosen local directory.
Troubleshooting & Common Issues
Problem: macOS Gatekeeper displays *"App is damaged and can't be opened"* or unnotarized developer notice.
Root Cause: macOS quarantine flag set on binaries downloaded outside the Mac App Store.
Resolution: Open Terminal and run:
bash
xattr -cr /Applications/StableBar.app
Alternatively, navigate to System Settings > Privacy & Security and select Open Anyway.
Problem: High memory consumption during batch processing operations.
Root Cause: Large media buffers retaining uncompressed state.
Resolution: Adjust batch concurrency in settings or process assets in focused batches.
How to Use & Getting Started
## Installation & Setup Guide
### macOS Installation (Recommended)
1. Download the verified `.dmg` release installer directly from CookApps.
2. Open the disk image and drag **StableBar.app** into your `/Applications` folder.
3. Launch StableBar via Spotlight (`Cmd + Space`) or Launchpad.
Alternatively, install using Homebrew if available:
```bash
brew install --cask seb-graf/tap/stablebar
```
### Windows Installation
1. Download the official installer package (`.exe` / `.msi`).
2. Run the executable and follow the setup wizard.
3. Launch **StableBar** from the Start Menu or desktop shortcut.
### Building from Source (Development Setup)
```bash
git clone https://github.com/Seb-GRAF/StableBar.git
cd StableBar
pnpm install || cargo build --release
pnpm run build
```
Ready to run StableBar?
100% Free & Open-Source native desktop software. Star the repository to support development.