spacebar

A minimal status bar for macOS

## About spacebar is a minimal status bar for macOS. Ideal for use with tiling window managers like [yabai](https://github.com/koekeishiya/yabai).

## Installation A package and service to install and manage spacebar is provided in two flavours: [Homebrew](https://brew.sh) & [Nix](https://nixos.org). There is also a precompiled binary archive available in [the latest release assets](https://github.com/cmacrae/spacebar/releases/tag/v1.4.0). ### Homebrew spacebar can be installed using Homebrew from the `cmacrae/formulae` tap ``` brew install cmacrae/formulae/spacebar brew services start spacebar ``` ### Nix A package is generally available to Nix users on macOS in the various channels. A [Flake](https://nixos.wiki/wiki/Flakes) is also available in this repository and can be used like so: ```nix { inputs.darwin.url = "github:lnl7/nix-darwin"; inputs.spacebar.url = "github:cmacrae/spacebar/v1.4.0"; outputs = { self, darwin, spacebar }: { darwinConfigurations.example = darwin.lib.darwinSystem { modules = [ { nixpkgs.overlays = [ spacebar.overlay ]; } ]; }; }; } ``` Or try it out with `nix run github:cmacrae/spacebar/v1.4.0`! spacebar can be configured and managed in a declarative manner using the `services.spacebar` module in [nix-darwin](https://github.com/LnL7/nix-darwin) ### Accessibility Permissions spacebar makes use of the macOS Accessibility APIs - after starting spacebar, you should be prompted to grant access. Open System Preferences.app and navigate to Security & Privacy, then Privacy, then Accessibility. Click the lock icon at the bottom and enter your password to allow changes to the list. Check the box next to spacebar to allow accessibility permissions. ## Configuration spacebar is configured by setting `config` properties via its messaging socket. Not only does this mean you can try out config changes live, it also means spacebar's configuration file is simply a shell script - usually just a sequence of `spacebar -m config