https://github.com/jean-tinland/simple-bar-lite
A yabai status bar widget for Übersicht inspired by simple-bar.
https://github.com/jean-tinland/simple-bar-lite
macos statusbar ubersicht ubersicht-widget yabai yabai-spaces
Last synced: 12 months ago
JSON representation
A yabai status bar widget for Übersicht inspired by simple-bar.
- Host: GitHub
- URL: https://github.com/jean-tinland/simple-bar-lite
- Owner: Jean-Tinland
- License: mit
- Created: 2022-01-06T18:39:45.000Z (over 4 years ago)
- Default Branch: master
- Last Pushed: 2025-05-13T09:58:34.000Z (about 1 year ago)
- Last Synced: 2025-05-13T10:38:42.121Z (about 1 year ago)
- Topics: macos, statusbar, ubersicht, ubersicht-widget, yabai, yabai-spaces
- Language: JavaScript
- Homepage:
- Size: 582 KB
- Stars: 47
- Watchers: 1
- Forks: 3
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Funding: .github/FUNDING.yml
- License: LICENSE
Awesome Lists containing this project
README
# 
A [yabai](https://github.com/koekeishiya/yabai) status bar widget for [Übersicht](https://github.com/felixhageloh/uebersicht). This is a simplified version of [simple-bar](https://github.com/Jean-Tinland/simple-bar).
## Features
- 3 themes behaviours: dark, light or automatic (synced with system)
- Display workspace number/label & current space
- Navigate to workspace on click
- Battery, microphone, sound level, wifi, date time widgets out of the box
- You can add your own custom widgets in settings
## Compatibility & requirements
In order to make this custom bar work, you'll need to install both [yabai](https://github.com/koekeishiya/yabai) and [Übersicht](https://github.com/felixhageloh/uebersicht), both of them must be up to date.
**`simple-bar-lite` supports only yabai v4 and above**.
Becareful, for Big Sur users, some actions must be taken in order to make yabai with scripting addition fully operational: [see here for more details]().
`simple-bar-lite` has been tested and is working on Monterey, Ventura & Sonoma but should work on both Catalina & Big Sur.
**It is important to note that you'll need to use yabai in `bsp` or `stack` layout mode in order to prevent app windows to overlap simple-bar.**
## Preview
## Installation
Clone this repo to your Übersicht widgets directory with the following command.
```bash
$ git clone https://github.com/Jean-Tinland/simple-bar-lite $HOME/Library/Application\ Support/Übersicht/widgets/simple-bar-lite
```
**Becareful, the folder containing the widget must be named `simple-bar-lite`, otherwise, simple-bar-lite will never launch.**
[JetBrains Mono](https://www.jetbrains.com/lp/mono/) is used by default. You can set your own font in the `custom-settings.json` file.
### For users with a custom yabai install (path)
You can set your custom yabai path in the `custom-settings.json` file.
On recent versions of macOS, Homebrew will install `yabai` in `/opt/homebrew/bin/yabai`.
```json
{
"yabaiPath": "/opt/homebrew/bin/yabai"
}
```
## Usage
After cloning the project, simply activate it in Übersicht's widgets list.
- `simple-bar-main-jsx`
## Clickable elements
Some elements of **simple-bar** are interactives. For example :
- Spaces indicator (trigger switch to clicked space)
- If you set an "onClickCommand" for a particular widget in `custom-settings.json`, it will be triggered when you click on the widget.
Clickable elements have a colored background showing up on hover in order to easily identify them.
## Customization & settings
If you want to customize the colors, shadows, fonts, etc... you can simply setup your own theme in the `custom-settings.json` file.
You can copy the content of `default-settings.json` file in your `custom-settings.json` and change the values.
Alongside the theme customization, you will find all the other settings you can customize.
## Custom Components
To add a new component
1. add a file + contents to `./lib/custom-components/`
2. add the component to `./lib/custom-components/index.jsx`
3. add configuration item to `./custom-settings.json` with an object containing at least
```json
{ "name": "componentname", "enabled": true }
```
### All the settings
Coming soon!