https://github.com/graddotdev/yabai-spaces-widget
Yabai Spaces Widget is a macOS app that adds a widget to your status bar. It works with yabai and lets you see spaces on all your displays.
https://github.com/graddotdev/yabai-spaces-widget
macos macos-app macos-application yabai
Last synced: about 1 month ago
JSON representation
Yabai Spaces Widget is a macOS app that adds a widget to your status bar. It works with yabai and lets you see spaces on all your displays.
- Host: GitHub
- URL: https://github.com/graddotdev/yabai-spaces-widget
- Owner: graddotdev
- License: mit
- Created: 2023-04-16T17:13:00.000Z (about 3 years ago)
- Default Branch: main
- Last Pushed: 2023-11-20T10:41:32.000Z (over 2 years ago)
- Last Synced: 2025-04-11T20:19:02.626Z (about 1 year ago)
- Topics: macos, macos-app, macos-application, yabai
- Language: Swift
- Homepage:
- Size: 28.3 KB
- Stars: 3
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Yabai Spaces Widget
Yabai Spaces Widget is a macOS app that adds a widget to your status bar. It works with [yabai](https://github.com/koekeishiya/yabai) and lets you see spaces on all your displays. This makes it easy to switch between tasks and stay organized. It's a helpful tool for managing your workspaces on macOS.
To install the widget using Homebrew, run the following command in your terminal:
```bash
brew install gradddev/tap/yabai-spaces-widget
```
To ensure that the widget stays up-to-date with the latest information about your spaces and displays, it is recommended that you add the following code snippet to your yabai configuration file (yabairc):
```bash
signals=(
"space_changed"
"display_added"
"display_removed"
"display_moved"
"display_changed"
"mission_control_enter"
"mission_control_exit"
)
for signal in "${signals[@]}"
do
yabai --message signal \
--add \
event=$signal \
action="osascript -e 'tell application \"Yabai Spaces Widget\" to refresh'"
done
```
This code adds event listeners to yabai that listen for specific events such as space changes, display additions or removals, and Mission Control events. When any of these events occur, yabai will trigger a command that refreshes the widget using an AppleScript.