# Jean-Tinland/simple-bar

A yabai and AeroSpace status bar widget for Übersicht

Repository: https://github.com/Jean-Tinland/simple-bar
Canonical: https://ross.abutalabs.com/products/simple-bar
Homepage: https://www.jeantinland.com/toolbox/simple-bar
Language: JavaScript
License: MIT
License Family: permissive
Topics: ubersicht, ubersicht-widget, yabai, macos, statusbar, hacktoberfest, aerospace, window-manager, flashspace
Last push: 2026-08-11T16:11:27+00:00

## Health v2 (maintenance only)
Score: 76/100 (v2, computed 2026-09-02T17:46:02.011165+00:00)
- activity 97, release rhythm 35, longevity 100
- inputs: {"age_days": 2305, "days_push": 22, "days_rel": null, "gap_med": null, "n_releases_24m": 0}
- flags: no_releases
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 1615, forks 153 (observed 2026-08-28T04:05:11.485018+00:00)

## What it is
simple-bar is a status bar widget for Übersicht that displays spaces, windows, and system information for the yabai and AeroSpace tiling window managers on macOS. It is highly customizable with themes, interactive widgets (Spotify, weather, battery, wifi, mic), multi-monitor support, and optional remote control via a companion server.

## Use cases
- replace the macOS menu bar with a custom status bar
- show yabai spaces and windows in a top bar on macOS
- display AeroSpace workspaces in an Übersicht widget
- customize a macOS desktop status bar with themes and widgets
- monitor battery, wifi, spotify, and weather from a tiling WM bar
- click to focus windows or switch spaces in a tiling setup
- add custom script-output widgets to a macOS status bar

## When to choose
- you use yabai or AeroSpace as your tiling window manager on macOS and want a polished status bar
- you already run Übersicht and want a feature-rich, themeable bar widget
- you want interactive widgets (media controls, wifi toggle, mic mute) and multi-monitor support in your bar
- you want to create, move, or destroy workspaces directly from the bar and have SIP disabled

## When to avoid
- you don't use yabai, AeroSpace, or Übersicht and don't want to install them
- you're on Linux or Windows - this is macOS-only (Catalina and above)
- you want a zero-configuration bar without tweaking settings or paths
- you need a native menu bar replacement that works without third-party window managers

## Facets
- artifact type: plugin
- maturity: active
- function: ui-components, developer-tools
- domain: desktop-applications, developer-tools
- platform: -
- tags: ubersicht-widget, yabai, aerospace, status-bar, window-manager, tiling-window-manager, menu-bar-replacement, macos-customization, automation, macos, desktop

## Member repositories
- Jean-Tinland/simple-bar (main) score 76

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:05:11.485018+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-30T03:50:15.950736+00:00, confidence not recorded.
  - readme: https://github.com/Jean-Tinland/simple-bar (fetched 2026-08-28T04:05:11.485018+00:00, sha bebfb804e9e8)
  - homepage: https://www.jeantinland.com/toolbox/simple-bar (fetched 2026-08-29T11:23:03.034274+00:00, sha e6b86c7823ff)
  - site_page: https://www.jeantinland.com/toolbox/simple-bar/documentation (fetched 2026-08-29T11:23:03.043925+00:00, sha 44f04481e335)
  - site_page: https://www.jeantinland.com/toolbox/simple-bar/documentation/installation (fetched 2026-08-29T11:23:03.046014+00:00, sha 25bca84baf68)
- Data as of 2026-08-30T08:39:29.467469+00:00.