Skip to content

FallenMax/sketchybar-config

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

16 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

My SketchyBar setup mentioned at FelixKratz/SketchyBar#47 (comment)

screenshot

Features

  • Overlays the macOS native menubar (transparent background, coexists with native items)
  • Shows space numbers as keyboard shortcut hints, with app icons and titles
  • Updates on window/space changes via yabai signals (with animation)
  • Configurable app list via JSON — no recompilation needed
  • Single static binary, zero runtime dependencies

Prerequisites

  • macOS (Apple Silicon)
  • Homebrew
  • sketchybarbrew install FelixKratz/formulae/sketchybar
  • yabaibrew install koekeishiya/formulae/yabai
  • Hack Nerd Fontbrew install --cask font-hack-nerd-font
  • Gobrew install go (build only)

Install

git clone https://github.com/user/sketchybar-config.git
cd sketchybar-config
make install

This will:

  1. Build the binary
  2. Install to ~/.config/sketchybar/
  3. Copy config.default.jsonconfig.json (first install only)
  4. Register yabai signals so the bar updates on window changes
  5. Restart sketchybar

Uninstall

make uninstall

Configuration

Edit ~/.config/sketchybar/config.json:

{
  "maxTitleLength": 12,
  "apps": [
    {
      "id": "Google Chrome",
      "icon": "U+F02AF",
      "color": "0xfff1bf47",
      "stripSuffix": " - Google Chrome"
    }
  ]
}

The id is the .app bundle name (e.g., "Finder" from Finder.app), which is language-independent — unlike localized display names. Check /Applications/ or run ps -e -o comm= to find your app's bundle name.

App fields

Field Required Description
id yes .app bundle name (language-independent). Use "*" as catch-all for unlisted apps
icon yes Nerd Font icon — hex code ("U+F02AF") or raw unicode char
color no Icon color in 0xAARRGGBB format
stripSuffix no Remove this suffix from window title
titleSeparator no Split title by this string
titlePart no Which part after split (0=first, -1=last)
hideTitle no Show only icon, no title

Find icons at nerdfonts.com/cheat-sheet.

After editing config.json, restart sketchybar to apply:

brew services restart sketchybar

About

No description, website, or topics provided.

Resources

Stars

3 stars

Watchers

1 watching

Forks

Packages

 
 
 

Contributors