macOS

Where Is the SketchyBar Config File?

SketchyBar executes sketchybarrc from the sketchybar config folder at launch. Items, plugins, and colors live in scripts beside it.

Last updated

SketchyBar configures through a shell script run once at launch. The sketchybarrc file in the XDG config folder issues bar, default, and item commands, calling helper scripts for dynamic content. Everything after that is event driven.

Plugin scripts commonly live in a plugins subfolder with matching names. Fonts and icon sets resolve from the system, so migrations need those installed. Event subscriptions re-register on every launch automatically. Reloading means restarting the bar process. Popup menus render from the same item scripts on demand.

Where SketchyBar stores this, by platform

macOS
/Users/<username>/.config/sketchybar/sketchybarrc

Executable startup script with bar and item commands. Must have the exec bit set. Helpers live in plugins beside it.

Frequently asked questions

How do I configure SketchyBar?

Create an executable sketchybarrc in the config folder with bar and item commands. Helper scripts sit beside it in a plugins folder.

How do I migrate SketchyBar?

Copy the sketchybar config folder to the new Mac. Fonts referenced inside must be installed there too.

Notice an outdated path? Let us know.