SketchyBar Configuration
part of my dotfiles

Install

Using script

curl -fsSL https://raw.githubusercontent.com/Efterklang/sketchybar/main/install.sh | sh -s

Manual

# install dependencies
brew install lua jq switchaudio-osx media-control imagemagick
# install sketchybar system stats plugin for CPU, RAM and network monitoring
brew tap joncrangle/tap
brew install sketchybar-system-stats
# install fonts
brew install --cask font-sketchybar-app-font font-maple-mono-nf-cn font-recursive-mono-nerd-font
# install SbarLua
git clone --depth 1 --quiet https://github.com/FelixKratz/SbarLua.git /tmp/sbarlua
cd /tmp/sbarlua && make install
# install config
git clone --depth 1 https://github.com/Efterklang/sketchybar ~/.config/sketchybar

---

Configuration

The default configuration is located in settings.lua.

---

Preview

Rewritten entirely in Lua using the sbarlua API. For the legacy bash version, see here.

Themes

Nord Light, Catppuccin Latte, Rose Pine, Catppuccin Mocha, Tokyo Night

Tokyo Night	Catppuccin Mocha

Left Items

Item	Click Script
logo	same as clicking the Apple icon
workspaces	left click → switch to that space right click → open Mission Control
app menus	click → open macOS app menu
space indicators	swap menus and spaces
front app	show app menu1

Note

Supported Window Managers

• macOS Native (default)
• Aerospace (experimental and buggy 😅)

---

Right Items

Item	Click Script
media	show music controller (play/pause, next, previous, repeat/random, etc.)
hardware stats	cpu graph2 · memory graph3 · netspeed item2
toggle stats	show/hide hardware stats (cpu, memory, netspeed)
homebrew stats	show outdated packages
wechat, qq (or any other apps)	open chat app
volume	show volume slider and output device selector2
wifi	show wifi networks and VPN status
battery	show remaining time and percentage
cal & time	open Calendar.app

---

Credits

Footnotes

1. Credit Sinjhin/SketchyMenu: A menu plugin et al for FelixKratz/SketchyBar ↩

2. Credit FelixKratz/dotfiles: My personal macOS configuration ↩ ↩² ↩³

3. Credit TheGoldenPatrik1/sketchybar-config: My personal configuration for SketchyBar ↩