Settings

> Published on Sun, 3 Dec 2023, 17:37> Updated on Sat, 18 Jan 2025, 20:43

Where are stored simple-bar settings?

The first time you'll make a changes in simple-bar settings, a .simplebarrc file will be created in your home directory.

In case this operation fail for any reason, a backup system is in place.

As you may know, Übersicht is some sort of Safari web view injected on you desktop. Thanks to this, simple-bar can rely on its local storage.

You'll find these settings in the Übersicht "Debug Console" under the "Storage" tab. In this tab, you'll find the "Local Storage" entry in the left column. Finally, a key named "simple-bar-settings" should be associated to a JSON config.

GUI settings

Settings can be opened by pressing cmd + , after clicking on simple-bar widget. You may want to click at the top center of the screen, where the process name of the current app is displayed in order to easily get focus on simple-bar before pressing cmd + ,. A red inner border will appear around simple-bar widget when it's focused.

In this settings module you'll find all the customization options available from layout to specific widgets show/hide toggle.

JSON settings

You should be able to view its content with this command:

shell
cat ~/.simplebarrc

You can create a symbolic link if you prefer storing your simple-bar config in another location like a "dots" repository.

If you make some manual changes directly in this file, you'll need to refresh simple-bar just after with this command:

shell
osascript -e 'tell application id "tracesOf.Uebersicht" to refresh'

You can also do the same by clicking on simple-bar then by pressing cmd + r.

Something is wrong in this documentation? Please open an issue on GitHub in simple-bar repo.